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, determina se il tuo account rivenditore ha un singolo account di fatturazione Google Workspace o più account di fatturazione Google Workspace. Per scoprire di più su questo argomento, consulta 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 il diritto:

  1. 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",
        },
      }
    }
  ]
}

  2. 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.

    1. 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"
          }
        }
      ]
    }
  ]
}

  3. Con PurchasableSku e BillingAccount selezionati, utilizza il metodo listPurchasableOffers per trovare il 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"
        }
      },
    }
  ],
}

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

    1. 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 dei diritti di Google Workspace

Prima di iniziare

I diritti di Google Workspace con pagamento gratuito o di prova plan non hanno un account di fatturazione Google Workspace. Per modificare il piano di pagamento di un diritto in modo da passare a un piano 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.

  1. Con l'offerta, utilizza il metodo lookupOffer per trovare informazioni Sku sull'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",
   }
}

  2. 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"
           }
         }
       ]
     }
   ]
 }
 ```

  3. 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 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"
        }
      },
    }
  ],
}

  4. 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 di Google Workspace

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

  1. Con il diritto, chiama il metodo listPurchasableSkus per recuperare un elenco di SKU acquistabili 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",
        },
      }
    }
  ]
}

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

    1. 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"
           }
         }
       ]
     }
   ]
 }
 ```

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

      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"
          }
        },
      }
    ],
  }
  ```

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

    1. Crea un oggetto Diritti e compila i campi name, offer, billingAccount e tutti i 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"
   }
   ```

Diritti di trasferimento

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

Per assistenza sul trasferimento dei clienti nella Partner Sales Console, consulta le nostre guide sul trasferimento dei clienti a un account partner o a 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 diritti per un piano con impegno, verrà avviato un nuovo periodo di impegno dopo il trasferimento.

Prima di iniziare

Per gestire i diritti di un cliente, devi disporre di un token di trasferimento generato dal cliente. 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 nuovamente 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 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 recuperare 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.

  1. Inizia il trasferimento utilizzando il metodo customers.import per importare i dati del cliente.

    ImportCustomerRequest
{
  "parent": "accounts/abc",
  "domain": "domain"
}

  2. Con l'ID Cloud Identity del cliente, chiama listTransferableSkus per recuperare un elenco dei suoi transferableSku Controlla 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",
      },
    }
  ],
}

  3. Ora che hai un elenco di TransferableSkus, devi determinare quale BillingAccount utilizzare per pagare i diritti. Utilizza il metodo queryEligibleBillingAccounts per trovare un insieme di BillingAccount che può essere utilizzato per ogni TransferableSku.

    1. Tieni presente che alcuni TransferableSkus devono condividere lo stesso account di fatturazione Google Workspace, motivo per cui queryEligibleBillingAccounts restituisce un gruppo di sku che ti informa su quali TransferableSkus devono utilizzare lo stesso BillingAccount. Se sono presenti più account di fatturazione Google Workspace per un determinato gruppo di SKU, puoi scegliere uno degli account di fatturazione Google Workspace e utilizzarlo per ogni TransferableSku nel 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"
           }
         }
       ]
     }
   ]
 }
 ```

  4. 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 costituito 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"
           }
         },
       }
     ],
   }

  5. Per ogni tupla, crea un nuovo oggetto Diritti corrispondente. Ogni diritto richiede un'offerta, un account di fatturazione e tutti i parametri richiesti. 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"
}