Method: purchases.subscriptionsv2.defer

Adia a renovação de uma assinatura.

Solicitação HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:defer

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

Parâmetros de caminho

Parâmetros
packageName

string

Obrigatório. O pacote do aplicativo da assinatura comprada. Por exemplo, "com.some.thing".
token

string

Obrigatório. O token fornecido ao dispositivo do usuário quando a assinatura foi comprada.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "deferralContext": {
    object (DeferralContext)
  }
}
Campos
deferralContext

object (DeferralContext)

Obrigatório. Detalhes sobre o adiamento da assinatura.

Corpo da resposta

Resposta para a API v2 purchases.subscriptions.defer.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "itemExpiryTimeDetails": [
    {
      object (ItemExpiryTimeDetails)
    }
  ]
}
Campos
itemExpiryTimeDetails[]

object (ItemExpiryTimeDetails)

O novo prazo de validade para cada item de assinatura.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/androidpublisher

DeferralContext

Contexto de adiamento da API purchases.subscriptionsv2.defer.

Representação JSON 
{
  "etag": string,
  "deferDuration": string,
  "validateOnly": boolean
}
Campos
etag

string

Obrigatório. A API vai falhar se a ETag não corresponder à ETag mais recente desta assinatura. A ETag é recuperada de purchases.subscriptionsv2.get: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get
deferDuration

string (Duration format)

Obrigatório. A duração em que todos os itens de assinatura devem ser adiados.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
validateOnly

boolean

Se definido como "true", a solicitação será um teste para validar o efeito de "subscriptionsv2.defer", e a assinatura não será afetada.

ItemExpiryTimeDetails

Detalhes do horário de expiração de um item de assinatura.

Representação JSON 
{
  "productId": string,
  "expiryTime": string
}
Campos
productId

string

O ID do produto do item de assinatura (por exemplo, "premium_plan").
expiryTime

string (Timestamp format)

O novo prazo de validade para este item de assinatura.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".