Mudar o status de uma assinatura

Você pode suspender, ativar ou cancelar uma assinatura para seus clientes. Se você quiser mudar o plano de assinatura, consulte Extrair e atualizar uma assinatura.

Suspender uma assinatura

É possível suspender assinaturas pagas com status ACTIVE por até 60 dias. Não é possível suspender assinaturas TRIAL e outros tipos de assinaturas sem custo financeiro. Quando você suspende uma assinatura do FLEXIBLE, o faturamento é pausado.

Ao suspender assinaturas ANNUAL_MONTHLY_PAY ou ANNUAL_YEARLY_PAY, observe o seguinte: + A suspensão da assinatura não muda a data de renovação. + Uma assinatura suspensa não é renovada. Se você ativar a assinatura após a data de renovação original, uma nova assinatura anual será criada, começando no dia da ativação.

Para suspender uma assinatura, use a seguinte solicitação HTTP POST:

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

Substitua:

  • CUSTOMER_ID: o nome do domínio principal do cliente ou o identificador exclusivo dele.
  • SUBSCRIPTION_ID: o identificador de assinatura exclusivo para cada cliente. É possível extrair esse valor usando o método Extrair todas as assinaturas de revendedor.

Ativar uma assinatura

É possível ativar uma assinatura suspensa se ela estiver dentro do período de suspensão de 60 dias. Não é possível ativar uma assinatura suspensa por abuso ou com aceitação pendente dos Termos de Serviço.

Para ativar uma assinatura suspensa, use a seguinte solicitação HTTP POST:

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

Substitua:

  • CUSTOMER_ID: o nome do domínio principal do cliente ou o identificador exclusivo dele.
  • SUBSCRIPTION_ID: o identificador de assinatura exclusivo para cada cliente. É possível extrair esse valor usando o método Extrair todas as assinaturas de revendedor.

Cancelar uma assinatura do Google Workspace

Quando você cancela a assinatura de um cliente, ele é imediatamente transferido para uma relação de faturamento direto com o Google e recebe um período curto sem interrupção do serviço. O cliente pode escolher configurar o faturamento diretamente com o Google usando um cartão de crédito ou transferir para outro revendedor.

Se um cliente tiver várias assinaturas, você precisará cancelar todas elas como uma solicitação em lote para que elas possam ser processadas em uma única transação.

Para cancelar imediatamente uma assinatura do Google Workspace, use a seguinte solicitação HTTP DELETE com um deletionType='transfer_to_direct':

DELETE https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID?deletionType=transfer_to_direct

Substitua:

  • CUSTOMER_ID: o nome do domínio principal do cliente ou o identificador exclusivo dele.
  • SUBSCRIPTION_ID: o identificador de assinatura exclusivo para cada cliente. É possível extrair esse valor usando o método Extrair todas as assinaturas de revendedor.

Excluir uma assinatura (descontinuado)

Para excluir imediatamente uma assinatura que não seja do Google Workspace, use a seguinte solicitação HTTP DELETE:

DELETE https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID?deletionType=cancel

Substitua:

  • CUSTOMER_ID: o nome do domínio principal do cliente ou o identificador exclusivo dele.
  • SUBSCRIPTION_ID: o identificador de assinatura exclusivo para cada cliente. É possível extrair esse valor usando o método Extrair todas as assinaturas de revendedor.