Gerenciar direitos do Google Workspace e do Google Chrome

Nesta página, descrevemos como gerenciar os direitos do cliente dos produtos Google Workspace e Google Chrome.

Pré-requisito

Antes de continuar, determine se sua conta de revendedor tem uma única conta de faturamento do Google Workspace ou várias contas de faturamento do Google Workspace. Para saber mais sobre esse tópico, leia o Guia básico de várias contas de faturamento do Google Workspace .

Criar direito

Antes de começar

Você precisa de uma configuração de Customer antes de continuar.

Para criar um direito, siga estas etapas:

  1. Com o nome do cliente, chame listPurchasableSkus para recuperar 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 pode ser usado para pagar pelo 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 PurchasableSku e o BillingAccount selecionados, 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ê deve ter a BillingAccount que pagará pelo Entitlement e pela PurchasableOffer. Comece a criar o direito usando o método create.

    1. Crie um direito e preencha a oferta, o billingAccount e todos os outros parâmetros obrigató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 a um plano de pagamento pago, há mais algumas etapas para selecionar uma conta de faturamento do Google Workspace.

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

As duas primeiras etapas só serão necessárias se o direito atual tiver um plano de pagamento sem custo financeiro ou teste.

  1. Com a oferta, use o método lookupOffer para encontrar informações da Sku sobre a 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 possa ser usado para pagar esse direito. 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 Entitlement e a BillingAccount, use o método listPurchasableOffers para encontrar qualquer PurchasableOffer. A BillingAccount não será necessária se o direito atual já tiver um plano pago. Neste caso, a BillingAccount existente 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ê já 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 dos direitos do Google Workspace

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

  1. Com o direito, chame o método listPurchasableSkus para recuperar 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 usadas para pagar pelo 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 Entitlement e a BillingAccount, use o método listPurchasableOffers para encontrar qualquer 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"
          }
        },
      }
    ],
  }
  ```

  4. Neste ponto, você já tem os atributos Entitlement, PurchasableOffer e BillingAccount. Comece a fazer upgrade ou downgrade usando o método changeOffer.

    1. Crie um objeto "Entitlement" e preencha o nome, a oferta, o billingAccount e os parâmetros necessá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 de clientes atuais do Google Workspace e do Chrome do parceiro anterior.

Se precisar de ajuda para transferir clientes no Partner Sales Console, consulte nossos guias sobre como transferir clientes para uma conta do 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 o Google.

Durante a transferência, os direitos atuais são automaticamente cancelados antes de serem criados novamente no novo parceiro. Se um cliente tiver direitos de plano de compromisso, eles iniciarão um novo termo 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 o identificador público do parceiro para que ele gere um token de transferência. Depois de criar um token, o cliente precisará enviar o token de transferência de volta a 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, poderá usar a API Cloud Channel para retornar o ID do Cloud Identity. Chame checkCloudIdentityAccountsExist com o domínio do cliente e, se o domínio existir, a API retornará o ID do Cloud Identity do cliente.

  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 recuperar uma lista do transferableSku Verifique o transferEligibility de cada objeto para garantir que é possível comprar a SKU associada.

    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, precisa determinar qual BillingAccount será usada 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, 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, escolha uma da conta de faturamento do Google Workspace e use para cada TransferableSku do 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 os TransferableOffers disponíveis. Neste ponto, você terá a lista de tuplas do cliente que consistem 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 Entitlement correspondente, ele precisa de uma Offer, BillingAccount e dos parâmetros obrigató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"
}