Questa pagina è stata tradotta dall'API Cloud Translation.

Gestire i diritti di Google Workspace e Google Chrome

Questa pagina descrive come gestire i diritti dei clienti per i prodotti Google Workspace e Google Chrome.

Prerequisito

Prima di continuare, verifica se il tuo account rivenditore dispone di un solo account Account di fatturazione Google Workspace o più account di fatturazione di Google Workspace . Per scoprire di più su questo argomento, leggi la Guida introduttiva per più account di fatturazione Google Workspace.

Crea diritto

Prima di iniziare

Devi eseguire la configurazione di Customer prima di poter procedere.

Per creare un diritto, segui questi passaggi:

Con il nome del cliente, chiama listPurchasableSkus per recuperare un elenco di PurchasableSkus

ListPurchasableSkusRequest
{
  "customer": "accounts/123/customers/abc",
  "createEntitlementPurchase": {
    "product": "products/-"
  }
}
ListPurchasableSkusResponse
{
  "purchasableSkus": [
    {
      "sku": {
        "name": "products/product_id/skus/sku_id1",
        "product": {
          "name": "products/product_id",
        }
      }
    },
    {
      "sku": {
        "name": "products/product_id/skus/sku_id2",
        "product": {
          "name": "products/product_id",
        },
      }
    }
  ]
}

Con il valore PurchasableSku selezionato, utilizza il metodo queryEligibleBillingAccounts per trovare un insieme di BillingAccount di Google Workspace che possono essere utilizzati per pagare il diritto.

Se vuoi pagare in una valuta specifica, seleziona un account di fatturazione con quella valuta.

QueryEligibleBillingAccountsRequest
{
  "customer": "accounts/123/customers/abc",
  "skus": ["products/product_id/skus/sku_id1"]
}
QueryEligibleBillingAccountsResponse
{
  "skuPurchaseGroups": [
    {
      "skus": [
        "products/product_id/skus/sku_id1"
      ],
      "billingAccountPurchaseInfos": [
        {
          "billingAccount": {
            "name": "accounts/123/billingAccounts/billing_account_id1",
            "displayName": "Google_Workspace_USD_US_1",
            "currencyCode": "USD",
            "regionCode": "US"
          }
        },
        {
          "billingAccount": {
            "name": "accounts/123/billingAccounts/billing_account_id2",
            "displayName": "Google_Workspace_CAD_CA_1",
            "currencyCode": "CAD",
            "regionCode": "CA"
          }
        }
      ]
    }
  ]
}

Con il PurchasableSku e l'account di fatturazione selezionati, utilizza il listPurchasableOffers per trovare disponibile PurchasableOffer

ListPurchasableOffersRequest
{
  "customer": "accounts/123/customers/abc",
  "createEntitlementPurchase": {
    "sku": "products/product_id/skus/sku_id1",
    "billingAccount": "accounts/123/billingAccounts/billing_account_id2"
  }
}
ListPurchasableOffersResponse
{
  "purchasableOffers": [
    {
      "offer": {
        "name": "accounts/123/offers/offer_id1",
      },
      "sku": {
        "name": "products/product_id/skus/sku_id1",
      },
      "plan": {
        "paymentPlan": "FLEXIBLE",
        "paymentCycle": {
          "duration": 1,
          "periodType": "MONTH"
        }
      },
    }
  ],
}

A questo punto dovresti avere l'account di fatturazione che pagherà per il Entitlement e l'offerta acquistabile. Inizia a creare il diritto utilizzando create .

Crea un diritto e compila offer, billingAccount e gli eventuali altri parametri richiesti.

CreateEntitlementRequest
{
  "parent": "accounts/123/customers/abc",
  "entitlement": {
    "offer": "accounts/123/offers/offer_id1",
    "maxUnits": 100,
    "billingAccount": "accounts/123/billingAccounts/billing_account_id2"
  }
}
CreateEntitlementResponse
{
  "name": "operations/operation_id1"
}

Modificare il piano di pagamento sui diritti di Google Workspace

Prima di iniziare

Diritti Google Workspace con una prova o senza costi aggiuntivi pagamento plan non dispongono di Account di fatturazione di Google Workspace. Per cambiare il piano di pagamento di un diritto in un piano di pagamento a pagamento, sono necessari un paio di passaggi aggiuntivi per selezionare un account di fatturazione Google Workspace.

Per modificare il piano di pagamento dei diritti di Google Workspace, segui questi passaggi:

I primi due passaggi sono obbligatori solo se il Diritti esistente ha un piano di pagamento gratuito o di prova.

Con l'Offerta, utilizza lookupOffer per trovare informazioni su Sku l'Offerta.

LookupOfferRequest
{
  "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1"
}
LookupOffer respones
{
  "name": "accounts/123/offers/offer_id1",
  "sku": {
    "name": "products/product_id/skus/sku_id1",
   }
}

Con il cliente e lo sku, utilizza il metodo queryEligibleBillingAccounts per trovare un insieme di BillingAccount che può essere utilizzato per pagare questo diritto. Se vuoi pagare in una valuta specifica, seleziona un account BillingAccount con quella valuta.

 QueryEligibleBillingAccountsRequest
 {
   "customer": "accounts/123/customers/abc",
   "skus": ["products/product_id/skus/sku_id1"]
 }
 QueryEligibleBillingAccountsResponse
 {
   "skuPurchaseGroups": [
     {
       "skus": [
         "products/product_id/skus/sku_id1"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id1",
             "displayName": "Google_Workspace_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         },
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id2",
             "displayName": "Google_Workspace_CAD_CA_1",
             "currencyCode": "CAD",
             "regionCode": "CA"
           }
         }
       ]
     }
   ]
 }
 ```

Con il diritto e l'account di fatturazione, utilizza il metodo listPurchasableOffers per trovare qualsiasi offerta acquistabile. BillingAccount non è necessario se il diritto esistente ha già un piano a pagamento. In questo caso, verrà utilizzato BillingAccount esistente. Per cambiare il piano di pagamento, Il campo purchase_option deve essere changeOfferPurchase

ListPurchasableOffersRequest
{
  "customer": "accounts/123/customers/abc",
  "changeOfferPurchase": {
    "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1",
    "billingAccount": "accounts/123/billingAccounts/billing_account_id2"
  }
}
ListPurchasableOffersResponse
{
  "purchasableOffers": [
    {
      "offer": {
        "name": "accounts/123/offers/offer_id1",
      },
      "sku": {
        "name": "products/product_id/skus/sku_id1",
      },
      "plan": {
        "paymentPlan": "FLEXIBLE",
        "paymentCycle": {
          "duration": 1,
          "periodType": "MONTH"
        }
      },
    }
  ],
}

A questo punto dovresti avere il diritto, l'offerta e l'account di fatturazione. Inizia a modificare il piano di pagamento utilizzando changeOffer .

ChangeOfferRequest
{
  "name": "accounts/abc/customers/123/entitlements/entitlement_id1",
  "offer": "accounts/abc/offers/offer_id1",
  "billing_account": "accounts/abc/billingAccounts/billing_account_id2",
  "parameters": [{
    "name": "max_units",
    "value": {
      "int64Value": "100"
    }
  }]
}
ChangeOfferResponse
{
  "name": "operations/operation_id1"
}

Eseguire l'upgrade o il downgrade dei diritti Google Workspace

Per eseguire l'upgrade o il downgrade dei diritti di Google Workspace, segui questi passaggi:

Con il diritto, chiama il metodo listPurchasableSkus per recuperare un elenco di PurchasableSkus che possono essere utilizzati per l'upgrade o il downgrade.

ListPurchasableSkusRequest
{
  "customer": "accounts/123/customers/abc",
  "changeOfferPurchase": {
    "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1",
    "changeType": "UPGRADE"
  }
}
ListPurchasableSkusResponse
{
  "purchasableSkus": [
    {
      "sku": {
        "name": "products/product_id/skus/sku_id1",
        "product": {
          "name": "products/product_id",
        }
      }
    },
    {
      "sku": {
        "name": "products/product_id/skus/sku_id2",
        "product": {
          "name": "products/product_id",
        },
      }
    }
  ]
}

Con PurchasableSku, utilizza il metodo queryEligibleBillingAccounts per per trovare un insieme di Account di fatturazione che possono essere utilizzati per pagare il diritto.

Se vuoi pagare in una valuta specifica, seleziona un BillingAccount con quella valuta.

 QueryEligibleBillingAccountsRequest
 {
   "customer": "accounts/123/customers/abc",
   "skus": ["products/product_id/skus/sku_id1"]
 }
 QueryEligibleBillingAccountsResponse
 {
   "skuPurchaseGroups": [
     {
       "skus": [
         "products/product_id/skus/sku_id1"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id1",
             "displayName": "Google_Workspace_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         },
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id2",
             "displayName": "Google_Workspace_CAD_CA_1",
             "currencyCode": "CAD",
             "regionCode": "CA"
           }
         }
       ]
     }
   ]
 }
 ```

Con l'account di diritto e fatturazione, utilizza il metodo listPurchasableOffers per trovare qualsiasi PurchasableOffer.

  ListPurchasableOffersRequest
  {
    "customer": "accounts/123/customers/abc",
    "changeOfferPurchase": {
      "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1",
      "billingAccount": "accounts/123/billingAccounts/billing_account_id2"
    }
  }
  ListPurchasableOffersResponse
  {
    "purchasableOffers": [
      {
        "offer": {
          "name": "accounts/123/offers/offer_id1",
        },
        "sku": {
          "name": "products/product_id/skus/sku_id1",
        },
        "plan": {
          "paymentPlan": "FLEXIBLE",
          "paymentCycle": {
            "duration": 1,
            "periodType": "MONTH"
          }
        },
      }
    ],
  }
  ```

A questo punto dovresti avere Entitlement, PurchasableOffer e BillingAccount. Inizia a eseguire l'upgrade o il downgrade utilizzando il metodo changeOffer.

Crea un oggetto Diritti e compila i campi nome, offerta, accountFatturazione e eventuali parametri richiesti.

   ChangeOfferRequest
   {
     "name": "accounts/abc/customers/123/entitlements/entitlement_id1",
     "offer": "accounts/abc/offers/offer_id1",
     "billing_account": "accounts/abc/billingAccounts/billing_account_id2",
     "parameters": [{
       "name": "max_units",
       "value": {
         "int64Value": "100"
       }
     }]
   }
   ChangeOfferResponse
   {
     "name": "operations/operation_id1"
   }
   ```

Trasferire diritti

Questa sezione ti aiuta a trasferire i diritti per i clienti Google Workspace e Chrome esistenti dal loro partner precedente.

Per assistenza con il trasferimento dei clienti nella Partner Sales Console, consulta le nostre guide sul trasferimento dei clienti Un account partner o un Account Google

I clienti di Google Workspace possono acquistare diritti solo da un singolo partner o da un singolo partner e da Google.

Durante il trasferimento, i diritti esistenti vengono annullati automaticamente prima di essere nuovamente creati per il nuovo partner. Se un cliente ha un piano basato su impegno , inizieranno un nuovo periodo dell'impegno dopo il trasferimento.

Prima di iniziare

Per gestire i diritti per un cliente, è necessario un file generato dal cliente token di trasferimento. Contatta il cliente e fornisci il tuo ID pubblico partner in modo che possa generare un token di trasferimento. Dopo aver creato un token, il cliente deve inviarti il token di trasferimento per completare la procedura. Questi token scadono 14 giorni dopo la creazione. Ti serve anche il dominio o l'ID Cloud Identity del cliente.

Quando il cliente crea il token di trasferimento, seleziona i diritti da trasferire al nuovo rivenditore. Devi trasferire tutti i dati diritti selezionati durante la procedura.

Per trasferire i diritti:

Se hai solo il dominio del cliente, puoi utilizzare l'API Cloud Channel per recuperare il suo ID Cloud Identity. Chiama checkCloudIdentityAccountsExist con il dominio del cliente e, se il dominio esiste, l'API restituirà ID Cloud Identity del cliente.

Inizia il trasferimento utilizzando il metodo customers.import per importare i dati del cliente.
```
ImportCustomerRequest
{
  "parent": "accounts/abc",
  "domain": "domain"
}
```

Con l'ID Cloud Identity del cliente, chiama listTransferableSkus per recuperare un elenco delle transferableSku Seleziona ogni transferEligibility dell'oggetto per assicurarti di poter acquistare lo SKU associato.

ListTransferableSkusRequest
{
  "parent": "accounts/abc",
  "cloudIdentityId": "cloud_identity_id"
}
ListTransferableSkusResponse
{
  "transferableSku": [
    {
      "sku": {
           "name": "products/product_id/skus/voice_sku_id1",
      },
    },
    {
      "sku": {
           "name": "products/product_id/skus/google_workspace_sku_id2",
      },
    },
    {
      "sku": {
           "name": "products/product_id/skus/google_workspace_chrome_sku_id3",
      },
    }
  ],
}

Ora che hai un elenco di TransferableSkus, devi determinare Account di fatturazione da usare per pagare i diritti. Utilizza la queryEligibleBillingAccounts per trovare un insieme di account di fatturazione che lattina essere utilizzato per ogni TransferableSku.

Tieni presente che alcuni TransferableSkus devono condividere lo stesso account Google Workspace account di fatturazione, ecco perché queryEligibleBillingAccounts restituisce un gruppo di SKU che ti informa quali TransferableSkus deve utilizzare lo stesso account di fatturazione. Se sono presenti più account di fatturazione Google Workspace per un determinato SKU gruppo, puoi scegliere uno degli account di fatturazione di Google Workspace e utilizzare per ogni TransferableSku del gruppo.

QueryEligibleBillingAccountsRequest
{
  "customer": "accounts/123/customers/abc",
  "skus": ["products/product_id/skus/voice_sku_id1","products/product_id/skus/google_workspace_sku_id2","google_workspace_chrome_sku_id3"]
}
QueryEligibleBillingAccountsResponse
 {
   "skuPurchaseGroups": [
     {
       "skus": [
         "products/product_id/skus/voice_sku_id1"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/voice_billing_account_id1",
             "displayName": "Google_Workspace_Voice_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         }
       ]
     },
     {
       "skus": [
         "products/product_id/skus/google_workspace_sku_id2","google_workspace_chrome_sku_id3"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/gw_billing_account_id1",
             "displayName": "Google_Workspace_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         },
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/gw_billing_account_id2",
             "displayName": "Google_Workspace_CAD_CA_1",
             "currencyCode": "CAD",
             "regionCode": "CA"
           }
         }
       ]
     }
   ]
 }
 ```

Per ogni coppia di TransferableSku e BillingAccount, utilizza il metodo listTransferableOffers per trovare i TransferableOffers disponibili. A questo punto dovresti avere l'elenco di tuple del cliente composto da TransferableSku, BillingAccounts e TransferableOffer.

ListTransferableOffersRequest
{
  "parent": "accounts/abc",
  "cloudIdentityId": "cloud_identity_id",
  "sku": "products/product_id/skus/voice_sku_id1",
  "billingAccount": "ccounts/123/billingAccounts/voice_billing_account_id1"
}
ListTransferableOffersResponse
   {
     "transferableOffers": [
       {
         "offer": {
           "name": "accounts/123/offers/voice_offer_id1",
         },
         "sku": {
           "name": "products/product_id/skus/voice_sku_id1",
         },
         "plan": {
           "paymentPlan": "FLEXIBLE",
           "paymentCycle": {
             "duration": 1,
             "periodType": "MONTH"
           }
         },
       }
     ],
   }

Per ogni tupla crea un nuovo oggetto Entitlements corrispondente, Il diritto richiede un'offerta, un account di fatturazione e tutti i parametri obbligatori. Chiama transferEntitlements per eseguire il trasferimento.

TransferEntitlementsRequest
{
  "parent": "accounts/abc/customers/123",
  "entitlements": [
    { 
      "offer": "accounts/123/offers/voice_offer_id1",
      "maxUnits": 100,
      "billingAccount": "accounts/123/billingAccounts/voice_billing_account_id1"
    },
    {
      "offer": "accounts/123/offers/gw_offer_id2",
      "maxUnits": 150,
      "billingAccount": "accounts/123/billingAccounts/gw_billing_account_id1"
    }
    {
      "offer": "accounts/123/offers/gw_chrome_offer_id3",
      "maxUnits": 200,
      "billingAccount": "accounts/123/billingAccounts/gw_billing_account_id1"
    }   
  ]
}
TransferEntitlementsResponse
{
  "name": "operations/operation_id1"
}