Method: subscriptions.suspend

Suspende uma assinatura ativa.

Você pode usar esse método para suspender uma assinatura que está no estado ACTIVE.

  • O faturamento de FLEXIBLE de assinaturas está pausado.
  • Para assinaturas ANNUAL_MONTHLY_PAY ou ANNUAL_YEARLY_PAY:
    • A suspensão da assinatura não altera a data de renovação com a qual foi originalmente comprometida.
    • 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, a partir do dia da ativação.

Recomendamos que você suspenda as assinaturas apenas por curtos períodos, já que suspensões maiores de 60 dias podem resultar no cancelamento delas.

Solicitação HTTP

POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/suspend

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
customerId

string

Pode ser o nome de domínio principal ou o identificador exclusivo do cliente. Se o nome de domínio de um cliente mudar, o nome de domínio antigo não poderá ser usado para acessá-lo, mas o identificador exclusivo do cliente (retornado pela API) sempre poderá ser usado. Recomendamos que você armazene o identificador exclusivo nos seus sistemas quando aplicável.
subscriptionId

string

Essa é uma propriedade obrigatória. O subscriptionId é o identificador da assinatura, exclusivo para cada cliente. Como um subscriptionId muda quando uma assinatura é atualizada, recomendamos não usar esse ID como uma chave para dados permanentes. O subscriptionId pode ser encontrado usando o método recuperar todas as assinaturas de revendedor.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Subscription.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/apps.order

Para mais informações, consulte o Guia de autorização.