Gestire i diritti di Google Workspace e Google Chrome

In questa pagina viene descritto come gestire i diritti dei clienti per i prodotti Google Workspace e Google Chrome.

Prerequisito

Prima di continuare, determina se il tuo account rivenditore ha un singolo account di fatturazione Google Workspace o più account di fatturazione Google Workspace. Per saperne di più su questo argomento, consulta la Guida introduttiva a più account di fatturazione Google Workspace.

Crea diritto

Prima di iniziare

Per continuare è necessaria una configurazione di Customer.

Per creare il 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 PurchasableSku selezionato, utilizza il metodo queryEligibleBillingAccounts per trovare un insieme di Google Workspace BillingAccount che può essere utilizzato 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 gli PurchasableSku e BillingAccount selezionati, utilizza il metodo listPurchasableOffers per trovare l'opzione PurchasableOffer disponibile

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 Entitlement e per l'offerta acquistabile. Inizia a creare il diritto utilizzando il metodo create.

Crea un diritto e compila l'offerta, l'account di fatturazione ed eventuali altri parametri obbligatori.

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"
}

Cambiare il piano di pagamento per i diritti Google Workspace

Prima di iniziare

I diritti Google Workspace con pagamento senza costi o di prova plan non dispongono di un account di fatturazione Google Workspace. Per cambiare il piano di pagamento per un diritto con un piano di pagamento a pagamento, devi effettuare un paio di passaggi aggiuntivi per selezionare un account di fatturazione Google Workspace.

Per cambiare il piano di pagamento per i diritti Google Workspace:

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

Con l'Offerta, utilizza il metodo lookupOffer per trovare informazioni su Sku nell'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 queryIdoneoBillingAccounts per trovare un insieme di BillingAccount che può essere utilizzato per pagare per questo 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 diritto e l'Account di fatturazione, usa il metodo listPurchasableOffers per trovare qualsiasi Offerta Purchasable. L'account di fatturazione non è necessario se il diritto esistente ha già un piano a pagamento. In questo caso verrà utilizzato l'account di fatturazione esistente. Per modificare 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 il metodo 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 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, usa il metodo queryEligibleBillingAccounts per trovare un insieme di BillingAccount che possa essere utilizzato 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 Entitlement e BillingAccount, usa 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 il diritto, l'offerta PurchasableOffer e l'account di fatturazione. Inizia a eseguire l'upgrade o il downgrade utilizzando il metodo changeOffer.

Crea un oggetto Entitlement e inserisci il nome, l'offerta, l'account di fatturazione ed eventuali parametri obbligatori.

   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 i diritti

Questa sezione ti aiuta a trasferire i diritti dei 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 a un account partner o un Account Google

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

Durante il trasferimento, i diritti esistenti vengono automaticamente annullati prima di essere creati di nuovo nel nuovo partner. Se un cliente dispone di diritti per un piano di impegno, inizierà un nuovo periodo di impegno dopo il trasferimento.

Prima di iniziare

Per gestire i diritti per un cliente, devi avere un token di trasferimento generato dal cliente. Contatta il cliente e fornisci il tuo identificatore pubblico partner in modo che possa generare un token di trasferimento. Dopo aver creato un token, il cliente deve restituirti il token di trasferimento per completare il processo. Questi token scadono 14 giorni dopo la creazione. Devi anche conoscere il dominio o l'ID Cloud Identity del cliente.

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

Per trasferire i diritti:

Se hai solo il dominio del cliente, puoi utilizzare l'API Cloud Channel per restituire il suo ID Cloud Identity. Chiama checkCloudIdentityAccountsExist con il dominio del cliente e, se il dominio esiste, l'API restituirà l'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 di transferableSku Controlla il valore transferEligibility di ogni 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 TransferableSku, devi determinare quale BillingAccount utilizzare per pagare i diritti. Utilizza il metodo queryEligibleBillingAccounts per trovare un insieme di account di fatturazione che può essere utilizzato per ogni TransferableSku.

Tieni presente che alcuni TransferableSku devono condividere lo stesso account di fatturazione di Google Workspace, motivo per cui queryEligibleBillingAccounts restituisce un gruppo di SKU che indica quali TransferableSku devono utilizzare lo stesso account di fatturazione. Se sono presenti più account di fatturazione Google Workspace per un determinato gruppo di SKU, puoi scegliere uno degli account di fatturazione di Google Workspace e utilizzarlo 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 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 Entitlement corrispondente, ogni diritto richiede un'offerta, un account di fatturazione e gli eventuali parametri obbligatori. Chiama il metodo 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"
}