Method: purchases.subscriptions.defer

Adia a compra de assinatura feita por um usuário até um prazo de validade futuro especificado.

Solicitação HTTP

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

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

Parâmetros de caminho

Parâmetros
packageName

string

O nome do pacote do aplicativo associado à assinatura comprada (por exemplo, "com.some.thing").
subscriptionId

string

O ID da assinatura comprada (por exemplo, "monthly001").
token

string

O token enviado 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 
{
  "deferralInfo": {
    object (SubscriptionDeferralInfo)
  }
}
Campos
deferralInfo

object (SubscriptionDeferralInfo)

Informações sobre o novo prazo de validade desejado para a assinatura.

Corpo da resposta

Resposta para a API purchases.subscriptions.defer.

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

Representação JSON 
{
  "newExpiryTimeMillis": string
}
Campos
newExpiryTimeMillis

string (int64 format)

O novo prazo de validade da assinatura, em milissegundos desde a época.

Exemplo

Confira a seguir um exemplo de solicitação:

curl -X POST \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "deferralInfo": {
      "desiredExpiryTimeMillis": "1735689600000",
      "expectedExpiryTimeMillis": "1704067200000"
    }
  }' \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptions/monthly.premium.v1/tokens/aBcDeFgHiJkLmNoPqRsTuVwXyZaBcDeFgHiJkLmNoPqRsTuVwXyZ.1234567890:defer'

Veja a seguir um exemplo de resposta:

{
  "newExpiryTimeMillis": "1776004800000"
}

Escopos de autorização

Requer o seguinte escopo OAuth:

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

SubscriptionDeferralInfo

Um SubscriptionDeferralInfo contém os dados necessários para adiar a compra de uma assinatura até um prazo de validade futuro.

Representação JSON 
{
  "expectedExpiryTimeMillis": string,
  "desiredExpiryTimeMillis": string
}
Campos
expectedExpiryTimeMillis

string (int64 format)

O prazo de validade esperado para a assinatura. Se o prazo atual não for o valor especificado aqui, o adiamento não vai acontecer.
desiredExpiryTimeMillis

string (int64 format)

O próximo prazo de validade que será atribuído à assinatura, em milissegundos desde a época. Ele precisa ser posterior ao prazo de validade atual.