- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- SubscriptionDeferralInfo
- Faça um teste
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 |
O nome do pacote do aplicativo associado à assinatura comprada (por exemplo, "com.some.thing"). |
subscriptionId |
O ID da assinatura comprada (por exemplo, "monthly001"). |
token |
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 ( |
Campos | |
---|---|
deferralInfo |
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 |
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 |
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 |
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. |