Method: subscriptions.suspend

Suspende uma assinatura ativa.

Use esse método para suspender uma assinatura paga que está no estado ACTIVE.

  • Para assinaturas do FLEXIBLE, o faturamento é pausado.
  • Para assinaturas ANNUAL_MONTHLY_PAY ou ANNUAL_YEARLY_PAY:
    • A suspensão da assinatura não muda a data de renovação que foi definida originalmente.
    • 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 períodos curtos, já que suspensões de mais de 60 dias podem resultar no cancelamento da assinatura.

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 antigo não poderá ser usado para acessar o cliente, mas o identificador exclusivo do cliente (retornado pela API) sempre poderá. Recomendamos armazenar o identificador exclusivo nos seus sistemas, quando aplicável.
subscriptionId

string

Esta é uma propriedade obrigatória. O subscriptionId é o identificador da assinatura e é exclusivo para cada cliente. Como um subscriptionId muda quando uma assinatura é atualizada, recomendamos não usar esse ID como uma chave para dados persistentes. E 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.