Gerenciar direitos do Google Workspace e do Google Chrome

Esta página descreve como gerenciar direitos do cliente para produtos do Google Workspace e do Google Chrome.

Pré-requisito

Antes de continuar, determine se a conta de revendedor tem uma única conta de faturamento do Google Workspace ou várias. Para saber mais sobre esse assunto, leia o Guia introdutório para várias contas de faturamento do Google Workspace.

Criar direito

Antes de começar

Você precisa configurar o Customer antes de continuar.

Para criar o direito, siga estas etapas:

  1. Com o nome do cliente, chame listPurchasableSkus para extrair uma lista de 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. Com o PurchasableSku selecionado, use o método queryEligibleBillingAccounts para encontrar um conjunto de BillingAccount do Google Workspace que possa ser usado para pagar o direito.

    1. Se você quiser pagar em uma moeda específica, selecione uma BillingAccount com essa moeda.
    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. Com a PurchasableSku e a BillingAccount selecionadas, use o método listPurchasableOffers para encontrar o PurchasableOffer disponível.

    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. Neste ponto, você terá a BillingAccount que vai pagar pelo Entitlement e pela PurchasableOffer. Comece a criar o direito de acesso usando o método create.

    1. Crie um direito e preencha a oferta, a conta de faturamento e todos os outros parâmetros necessários.
    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"
}

Mudar o plano de pagamento dos direitos do Google Workspace

Antes de começar

Os direitos do Google Workspace com um pagamento gratuito ou de teste plan não têm uma conta de faturamento do Google Workspace. Para mudar o plano de pagamento de um direito para um plano de pagamento pago, há algumas etapas adicionais para selecionar uma conta de faturamento do Google Workspace.

Para mudar o plano de pagamento nos direitos do Google Workspace, siga estas etapas:

As duas primeiras etapas são necessárias apenas se o direito tiver um plano de pagamento gratuito ou de teste.

  1. Com a oferta, use o método lookupOffer para encontrar informações sobre Sku na oferta.

    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. Com o cliente e a SKU, use o método queryEligibleBillingAccounts para encontrar um conjunto de BillingAccount que pode ser usado para pagar por esse direito. Se você quiser pagar em uma moeda específica, selecione uma conta de faturamento com essa moeda.

     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. Com o direito e a conta de faturamento, use o método listPurchasableOffers para encontrar qualquer oferta que possa ser comprada. A BillingAccount não é necessária se o direito já tiver um plano pago. Nesse caso, a BillingAccount atual será usada. Para mudar o plano de pagamento, o campo purchase_option precisa ser 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. Neste ponto, você deve ter o direito, a oferta e a conta de faturamento. Comece a mudar o plano de pagamento usando o método 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"
}

Fazer upgrade ou downgrade de direitos do Google Workspace

Para fazer upgrade ou downgrade de direitos do Google Workspace, siga estas etapas:

  1. Com o direito, chame o método listPurchasableSkus para extrair uma lista de PurchasableSkus que podem ser usadas para upgrade ou 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. Com o PurchasableSku, use o método queryEligibleBillingAccounts para encontrar um conjunto de BillingAccounts que podem ser usados para pagar o direito.

    1. Se você quiser pagar em uma moeda específica, selecione uma BillingAccount com essa moeda.
     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. Com o direito e a conta de faturamento, use o método listPurchasableOffers para encontrar qualquer oferta que possa ser comprada.

      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. Neste ponto, você deve ter o direito, a oferta que pode ser comprada e a conta de faturamento. Comece a fazer upgrade ou downgrade usando o método changeOffer.

    1. Crie um objeto de direito e preencha o nome, a oferta, a conta de faturamento e todos os parâmetros obrigatórios.
       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"
   }
   ```

Transferir direitos

Esta seção ajuda a transferir direitos para clientes do Google Workspace e do Chrome de parceiros anteriores.

Para receber ajuda na transferência de clientes no Partner Sales Console, consulte nossos guias sobre como transferir clientes para uma conta de parceiro ou uma conta do Google.

Os clientes do Google Workspace só podem comprar direitos de um único parceiro ou de um único parceiro e do Google.

Durante a transferência, os direitos existentes são cancelados automaticamente antes de serem criados novamente no novo parceiro. Se um cliente tiver direitos de plano de compromisso, eles vão iniciar um novo período de compromisso após a transferência.

Antes de começar

Para gerenciar os direitos de um cliente, você precisa de um token de transferência gerado pelo cliente. Entre em contato com o cliente e informe seu Identificador público do parceiro para que ele possa gerar um token de transferência. Depois de criar um token, o cliente precisa enviar o token de transferência de volta para você para concluir o processo. Esses tokens expiram 14 dias após a criação. Você também precisa do domínio do cliente ou do ID do Cloud Identity.

Quando o cliente cria o token de transferência, ele seleciona os direitos que quer transferir para o novo revendedor. É necessário transferir todos os direitos selecionados durante o processo.

Para transferir direitos, siga estas etapas:

Se você tiver apenas o domínio do cliente, use a API Cloud Channel para retornar o ID do Cloud Identity. Chame checkCloudIdentityAccountsExist com o domínio do cliente. Se o domínio existir, a API vai retornar o ID da identidade do cliente no Cloud.

  1. Inicie a transferência usando o método customers.import para importar os dados do cliente.

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

  2. Com o ID do Cloud Identity do cliente, chame listTransferableSkus para extrair uma lista de transferableSku do cliente. Verifique o transferEligibility de cada objeto para garantir que você possa comprar o SKU associado.

    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. Agora que você tem uma lista de TransferableSkus, é necessário determinar qual BillingAccount usar para pagar pelos direitos. Use o método queryEligibleBillingAccounts para encontrar um conjunto de BillingAccount que pode ser usado para cada TransferableSku.

    1. Alguns TransferableSkus precisam compartilhar a mesma conta de faturamento do Google Workspace. É por isso que queryEligibleBillingAccounts retorna um grupo de SKUs que informa quais TransferableSkus precisam usar a mesma BillingAccount. Se houver várias contas de faturamento do Google Workspace para um determinado grupo de SKUs, você poderá escolher uma delas e usá-la para todos os TransferableSku no grupo.
    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. Para cada par de TransferableSku e BillingAccount, use o método listTransferableOffers para encontrar TransferableOffers disponíveis. Neste ponto, você terá a lista de tuplas do cliente, que consiste em 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. Para cada tupla, crie um novo objeto de direito correspondente. Cada direito precisa de uma oferta, uma conta de faturamento e todos os parâmetros necessários. Chame o método transferEntitlements para realizar a transferência.

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