Esta página foi traduzida pela API Cloud Translation.

Faça a gestão das autorizações do Google Workspace e do Google Chrome

Esta página descreve como gerir as concessões de clientes para produtos do Google Workspace e do Google Chrome.

Pré-requisito

Antes de continuar, determine se a sua conta de revendedor tem uma única conta de faturação do Google Workspace ou várias contas de faturação do Google Workspace. Para saber mais acerca deste tópico, leia o Guia de introdução de várias contas de faturação do Google Workspace .

Crie uma concessão

Antes de começar

Tem de configurar um Customer antes de poder continuar.

Para criar uma concessão, siga estes passos:

Com o nome do cliente, ligue para listPurchasableSkus para obter 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",
        },
      }
    }
  ]
}

Com o PurchasableSku selecionado, use o método queryEligibleBillingAccounts para encontrar um conjunto de BillingAccount do Google Workspace que podem ser usados para pagar o direito.

Se quiser pagar numa 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"
          }
        }
      ]
    }
  ]
}

Com o PurchasableSku e a BillingAccount selecionados, use o método listPurchasableOffers para encontrar os PurchasableOffer disponíveis

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"
        }
      },
      "priceReferenceId": "price_reference_id_123"
    }
  ],
}

Neste momento, deve ter a BillingAccount que vai pagar o Entitlement e a PurchasableOffer. Comece a criar a autorização através do método create.
1. Crie um direito e preencha a oferta, a conta de faturação e quaisquer outros parâmetros necessários. Preencha o ID de referência de preço na autorização quando estiver presente na PurchasableOffer para garantir que a nova autorização tem o preço indicado acima. Sem este ID de referência de preço, não há garantia de que o desconto e o preço efetivo devolvidos pela ListPurchasableOffersResponse sejam os mesmos nesta chamada CreateEntitlement. O preenchimento deste ID de referência de preço garante uma correspondência de preços nesta nova concessão.
```
CreateEntitlementRequest
{
  "parent": "accounts/123/customers/abc",
  "entitlement": {
    "offer": "accounts/123/offers/offer_id1",
    "maxUnits": 100,
    "billingAccount": "accounts/123/billingAccounts/billing_account_id2",
    "priceReferenceId": "price_reference_id_123"
  }
}
CreateEntitlementResponse
{
  "name": "operations/operation_id1"
}
```

Altere o plano de pagamento em concessões do Google Workspace

Antes de começar

As autorizações do Google Workspace com um pagamento plan gratuito ou de avaliação não têm uma conta de faturação do Google Workspace. Para alterar o plano de pagamento de uma autorização para um plano de pagamento pago, existem alguns passos adicionais para selecionar uma conta de faturação do Google Workspace.

Para alterar o plano de pagamento em concessões do Google Workspace, siga estes passos:

Os dois primeiros passos só são necessários se a autorização existente tiver um plano de pagamento gratuito ou de avaliação.

Com a oferta, use o método lookupOffer para encontrar informações 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",
   }
}

Com o cliente e o SKU, use o método queryEligibleBillingAccounts para encontrar um conjunto de BillingAccount que pode ser usado para pagar este Entitlement. Se quiser pagar numa moeda específica, selecione uma conta de faturação 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"
           }
         }
       ]
     }
   ]
 }
 ```

Com o direito e a BillingAccount, use o método listPurchasableOffers para encontrar qualquer PurchasableOffer. A BillingAccount não é necessária se a autorização existente já tiver um plano pago. Neste caso, é usada a BillingAccount existente. Para alterar o plano de pagamento, o campo purchase_option tem de 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"
        }
      },
      "priceReferenceId": "price_reference_id_123"
    }
  ],
}

Nesta altura, deve ter a concessão, a oferta e a conta de faturação. Comece a alterar o plano de pagamento através do método changeOffer. Preencha o ID de referência de preço na autorização quando estiver presente na PurchasableOffer para garantir que a nova autorização tem o preço indicado acima. Sem este ID de referência de preço, não existe garantia de que o desconto e o preço efetivo devolvidos pela ListPurchasableOffersResponse sejam os mesmos nesta chamada ChangeOffer. O preenchimento deste ID de referência de preço garante uma correspondência de preços nesta nova concessão.
```
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"
    }
  }],
  "priceReferenceId": "price_reference_id_123"
}
ChangeOfferResponse
{
  "name": "operations/operation_id1"
}
```

Atualize ou altere para uma versão anterior as autorizações do Google Workspace

Para atualizar ou alterar as autorizações do Google Workspace para a versão anterior, siga estes passos:

Com a concessão, chame o método listPurchasableSkus para obter uma lista de PurchasableSkus que podem ser usados para atualizar ou alterar para uma versão anterior.

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

Com o PurchasableSku, use o método queryEligibleBillingAccounts para encontrar um conjunto de BillingAccounts que podem ser usados para pagar o Entitlement.

Se quiser pagar numa 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"
           }
         }
       ]
     }
   ]
 }
 ```

Com o direito e a conta de faturação, 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"
          }
        },
        "priceReferenceId": "price_reference_id_123"
      }
    ],
  }
  ```

Neste momento, deve ter o direito, a oferta comprável e a conta de faturação. Comece a atualizar ou a alterar para uma versão inferior através do changeOffermétodo.
1. Crie um objeto Entitlement e preencha o nome, a oferta, o billingAccount e todos os parâmetros necessários. Preencha o ID de referência de preço na autorização quando estiver presente na PurchasableOffer para garantir que a nova autorização tem o preço indicado acima. Sem este ID de referência de preço, não existe garantia de que o desconto e o preço efetivo devolvidos pela ListPurchasableOffersResponse sejam os mesmos nesta chamada ChangeOffer. O preenchimento deste ID de referência de preço garante uma correspondência de preços nesta nova concessão.
```
   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"
       }
     }],
     "priceReferenceId": "price_reference_id_123"
   }
   ChangeOfferResponse
   {
     "name": "operations/operation_id1"
   }
   ```
```

Transfira concessões

Esta secção ajuda a transferir autorizações para clientes existentes do Google Workspace e do Chrome do respetivo parceiro anterior.

Para obter ajuda na transferência de clientes na Partner Sales Console, consulte os nossos guias sobre a transferência de clientes para uma conta de parceiro ou uma Conta Google

Os clientes do Google Workspace só podem comprar concessões a um único parceiro ou a um único parceiro e à Google.

Durante a transferência, as concessões existentes são canceladas automaticamente antes de serem criadas novamente ao abrigo do novo parceiro. Se um cliente tiver direitos de um plano de compromisso, estes iniciam um novo período de compromisso após a transferência.

Antes de começar

Para gerir concessões de um cliente, precisa de um símbolo de transferência gerado pelo cliente. Contacte o cliente e faculte o seu identificador público de parceiro para que possa gerar um token de transferência. Depois de criar um símbolo, o cliente tem de enviar o símbolo de transferência de volta para si para concluir o processo. Estes tokens expiram 14 dias após a criação. Também precisa do domínio do cliente ou do ID do Cloud Identity.

Quando o cliente cria o respetivo símbolo de transferência, seleciona as concessões que quer transferir para o novo revendedor. Tem de transferir todas as concessões selecionadas durante o processo.

Para transferir concessões, siga estes passos:

Se tiver apenas o domínio do cliente, pode usar a API Cloud Channel para devolver o respetivo ID do Cloud Identity. Chame checkCloudIdentityAccountsExist com o domínio do cliente e, se o domínio existir, a API devolve o ID do Cloud ID do cliente.

Comece a transferência através do método customers.import para importar os dados do cliente.
```
ImportCustomerRequest
{
  "parent": "accounts/abc",
  "domain": "domain"
}
```

Com o ID do Cloud Identity do cliente, chame listTransferableSkus para obter uma lista dos transferableSku Verifique o transferEligibility de cada objeto para se certificar de que pode 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",
      },
    }
  ],
}

Agora que tem uma lista de TransferableSkus, tem de determinar que BillingAccount usar para pagar os direitos. Use o método queryEligibleBillingAccounts para encontrar um conjunto de BillingAccount que pode ser usado para cada TransferableSku.

Tenha em atenção que determinados TransferableSkus têm de partilhar a mesma conta de faturação do Google Workspace, motivo pelo qual queryEligibleBillingAccounts devolve um grupo de SKU que informa que TransferableSkus têm de usar a mesma BillingAccount. Se existirem várias contas de faturação do Google Workspace para um determinado grupo de SKU, pode escolher uma das contas de faturação do Google Workspace 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"
           }
         }
       ]
     }
   ]
 }
 ```

Para cada par TransferableSku e BillingAccount, use o método listTransferableOffers para encontrar TransferableOffers disponíveis. Neste momento, deve ter a lista de tuplos do cliente composta por 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"
           }
         },
         "priceReferenceId": "price_reference_id_voice_offer_12"
       }
     ],
   }

Para cada tuplo, crie um novo objeto de concessão correspondente. Cada concessão precisa de uma oferta, uma conta de faturação e todos os parâmetros necessários. Preencha o ID de referência do preço na autorização quando estiver presente no PurchasableOffer para garantir que a nova autorização tem o preço indicado acima. Sem este ID de referência de preço, não existe garantia de que o desconto e o preço efetivo devolvidos pela ListPurchasableOffersResponse sejam os mesmos nesta chamada TransferEntitlements. O preenchimento deste ID de referência de preço garante uma correspondência de preços nesta nova concessão. Para fazer a transferência, chame o método transferEntitlements.

TransferEntitlementsRequest
{
  "parent": "accounts/abc/customers/123",
  "entitlements": [
    { 
      "offer": "accounts/123/offers/voice_offer_id1",
      "maxUnits": 100,
      "billingAccount": "accounts/123/billingAccounts/voice_billing_account_id1",
      "priceReferenceId": "price_reference_id_voice_offer_12"
    },
    {
      "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",
      "priceReferenceId": "price_reference_id_chrome_offer_34"
    }   
  ]
}
TransferEntitlementsResponse
{
  "name": "operations/operation_id1"
}

Faça a gestão das autorizações do Google Workspace e do Google Chrome Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Pré-requisito

Crie uma concessão

Antes de começar

Altere o plano de pagamento em concessões do Google Workspace

Antes de começar

Atualize ou altere para uma versão anterior as autorizações do Google Workspace

Transfira concessões

Antes de começar

Faça a gestão das autorizações do Google Workspace e do Google Chrome