Criar ou transferir uma assinatura

Depois de pedir a conta de um cliente, você pode criar várias assinaturas diferentes:

  • Uma assinatura de compromisso anual
  • Uma assinatura flexível
  • Um teste sem custo financeiro de 30 dias
  • Uma assinatura com desconto

Para mais informações sobre os produtos usados por essas assinaturas, acesse Produtos e SKUs.

Se você não fez o pedido da conta deste cliente, pode transferir uma assinatura.

Clientes com o customerType = 'team' só podem comprar o Essentials e Edições Enterprise Essentials do Google Workspace. Se você tentar comprar em qualquer outra assinatura do Google Workspace, erro: Customer is not eligible to purchase this subscription. Clientes quem comprar o Essentials ou assinaturas baseadas em uso pode não conseguir lidar com isso Planos de compromisso anual e opções limitadas de upgrade e downgrade.

Crie uma assinatura

Para criar uma assinatura para uma conta de cliente recém-criada, use o seguinte solicitação HTTP POST e incluir o token de autorização:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions

O CUSTOMER_ID é o nome de domínio principal do cliente ou o identificador exclusivo do cliente retornado quando como recuperar a conta de um cliente de revenda.

Criar um plano de compromisso anual

Para assinaturas de planos com contrato anual, nem todas as SKUs têm as mesmas configurações de renovação padrão. Recomendamos sempre transmitir renewalSettings. Criar uma assinatura de compromisso anual com 10 licenças:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "ANNUAL_MONTHLY_PAY"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10
  },
  renewalSettings: {
    "renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY'
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

Substitua:

  • CUSTOMER_ID: o domínio principal do cliente ou o identificador exclusivo do cliente.
  • SKU_ID: a unidade única de manutenção de estoque (SKU) identificador. Para mais informações, consulte Produtos e IDs de SKU.
  • PURCHASE_ORDER_ID: uma ordem de compra opcional. ID que pode ser usado para rastrear o uso.

Uma resposta bem sucedida retorna um status HTTP 200 e a nova configurações de um plano com contrato anual. ANNUAL_MONTHLY_PAY é retornado como ANNUAL em todas as respostas da API.

Veja a seguir um exemplo de resposta do plano anual:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "purchaseOrderId": "my_example.com_annual_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "skuName": "Google Workspace Business Standard"
}

Criar um plano flexível

Para criar uma assinatura flexível para uma conta de cliente recém-criada, use a seguinte solicitação HTTP POST e incluem o token de autorização:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "FLEXIBLE"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

Substitua:

  • CUSTOMER_ID: o domínio principal do cliente ou o identificador exclusivo do cliente.
  • SKU_ID: a unidade única de manutenção de estoque (SKU) identificador. Para mais informações, consulte Produtos e IDs de SKU.
  • PURCHASE_ORDER_ID: uma ordem de compra opcional. ID que pode ser usado para rastrear o uso.

Veja a seguir um exemplo de resposta do plano flexível:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "FLEXIBLE",
    "isCommitmentPlan": false
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10,
    "licensedNumberOfSeats": 0
  },
  "trialSettings": {
    "isInTrial": false
  },
  "purchaseOrderId": "my_example_flex_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "skuName": "Google Workspace Business Standard"
}

Criar um teste sem custo financeiro

Para criar uma assinatura de teste sem custo financeiro de 30 dias para o produto de um cliente recém-criado conta, use a seguinte solicitação HTTP POST e inclua o parâmetro de autorização token:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "TRIAL"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

Substitua:

  • CUSTOMER_ID: o domínio principal do cliente ou o identificador exclusivo do cliente.
  • SKU_ID: a unidade única de manutenção de estoque (SKU) identificador. Para mais informações, consulte Produtos e IDs de SKU.
  • PURCHASE_ORDER_ID: uma ordem de compra opcional. ID que pode ser usado para rastrear o uso.

Veja a seguir um exemplo de resposta de um plano de teste sem custo financeiro de 30 dias:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "TRIAL",
    "isCommitmentPlan": false
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10,
    "licensedNumberOfSeats": 0
  },
  "trialSettings": {
    "isInTrial": true,
    "trialEndTime": "1331648420142"
  },
  "purchaseOrderId": "my_example_trial_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "skuName": "Google Workspace Business Standard"
}

Criar uma assinatura com desconto

O Google pode fornecer um código de oferta para a criação de assinaturas com desconto e a taxa de conversão. Para aplicar desconto em uma assinatura, você precisa fornecer o código da oferta no a chamada insert de assinatura. Se o cliente mudar de SKU original, o desconto é removido.

Criar uma assinatura de compromisso anual com desconto para uma assinatura recém-criada na conta do cliente, use a seguinte solicitação HTTP POST e inclua os token de autorização:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "ANNUAL_MONTHLY_PAY"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10
  },
  renewalSettings: {
    "renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY'
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID",
  "dealCode": "GOOGLE_CONTRACT_DEAL_CODE"
}

Substitua:

  • CUSTOMER_ID: o domínio principal do cliente ou o identificador exclusivo do cliente.
  • SKU_ID: a unidade única de manutenção de estoque (SKU) identificador. Para mais informações, consulte Produtos e IDs de SKU.
  • PURCHASE_ORDER_ID: uma ordem de compra opcional. ID que pode ser usado para rastrear o uso.
  • GOOGLE_CONTRACT_DEAL_CODE: um código de desconto disponível do Google.

Confira a seguir um exemplo de resposta do plano anual de desconto:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "purchaseOrderId": "my_example.com_annual_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "dealCode": "GOOGLE_CONTRACT_DEAL_CODE",
  "skuName": "Google Workspace Business Standard"
}

Transferir uma assinatura

Se você não tiver pedido a conta do cliente usando o pedir uma nova conta de cliente use o token de transferência do cliente ao criar uma assinatura para esse cliente.

Para criar uma assinatura para uma conta de cliente que você não pediu, use o seguinte solicitação HTTP POST:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions?customerAuthToken=TOKEN_VALUE

Substitua:

  • CUSTOMER_ID: o domínio principal do cliente ou o identificador exclusivo do cliente.
  • TOKEN_VALUE: um token de transferência fornecido pela para o cliente. Depois que o cliente gera o token, ele é válido por 30 dias.

Para mais informações sobre como os clientes recebem um token de transferência, consulte a Central de Ajuda do Google Workspace.

Para transferir a assinatura de um cliente do plano de contrato anual, use o seguinte solicitação HTTP POST e incluir o token de autorização:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions?customerAuthToken=auth token
{
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "ANNUAL_MONTHLY_PAY"
  },
  "seats": {
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

Substitua:

  • CUSTOMER_ID: o domínio principal do cliente ou o identificador exclusivo do cliente.
  • SKU_ID: a unidade única de manutenção de estoque (SKU) identificador. Para mais informações, consulte Produtos e IDs de SKU.
  • PURCHASE_ORDER_ID: uma ordem de compra opcional. ID que pode ser usado para rastrear o uso.

Uma resposta bem-sucedida retorna um status HTTP 200 e as configurações da assinatura transferida plano de compromisso anual:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "purchaseOrderId": "example.com_annual_1",
  "status": "ACTIVE",
  "resourceUiUrl": "URL to customer's Admin console dashboard",
  "skuName": "Google Workspace Business Standard"
}

Limitações de transferência

Se você estiver transferindo uma assinatura do Google Workspace com um Google Drive associado ou do Google Vault, use o Operação batch para transferir todas as assinaturas com status ACTIVE. Transferência de cada uma assinatura uma a uma resulta em erro.

A transferência de assinaturas suspensas só será permitida se o motivo da suspensão for PENDING_TOS_ACCEPTANCE, TRIAL_ENDED ou RENEWAL_WITH_TYPE_CANCEL.

Ao transferir uma SKU legada, subscriptions.list retorna um skuId. da SKU que precisa ser transferida. O skuId da SKU customervactually é retornado como transferInfo.currentLegacySkuId. Para um lista completa de skuIds e quais produtos são usados por esses planos. Consulte Produtos e SKUs.

As transferências não funcionam com códigos de oferta de desconto.