Method: purchases.subscriptions.defer

Rimanda l'acquisto di un abbonamento da parte di un utente fino a una data di scadenza futura specificata.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
packageName

string

Il nome del pacchetto dell'applicazione per cui è stato acquistato questo abbonamento (ad esempio "com.some.thing").
subscriptionId

string

L'ID abbonamento acquistato (ad esempio "mensile001").
token

string

Il token fornito al dispositivo dell'utente al momento dell'acquisto dell'abbonamento.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "deferralInfo": {
    object (SubscriptionDeferralInfo)
  }
}
Campi
deferralInfo

object (SubscriptionDeferralInfo)

Le informazioni sulla nuova data e ora di scadenza desiderata per l'abbonamento.

Corpo della risposta

Risposta per l'API purchases.subscriptions.defer.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "newExpiryTimeMillis": string
}
Campi
newExpiryTimeMillis

string (int64 format)

La nuova data di scadenza dell'abbonamento in millisecondi dall'epoca.

Esempio

Di seguito è riportata una richiesta di esempio:

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'

Di seguito è riportato un esempio di risposta:

{
  "newExpiryTimeMillis": "1776004800000"
}

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

SubscriptionDeferralInfo

Un oggetto SubscriptionDeferralInfo contiene i dati necessari per posticipare l'acquisto di un abbonamento a una data di scadenza futura.

Rappresentazione JSON 
{
  "expectedExpiryTimeMillis": string,
  "desiredExpiryTimeMillis": string
}
Campi
expectedExpiryTimeMillis

string (int64 format)

La data e l'ora di scadenza previste per l'abbonamento. Se la data e l'ora di scadenza attuali dell'abbonamento non corrispondono al valore specificato qui, il differimento non verrà applicato.
desiredExpiryTimeMillis

string (int64 format)

La prossima data di scadenza da assegnare all'abbonamento, in millisecondi dall'epoca. L'ora specificata deve essere successiva/maggiore all'ora di scadenza corrente dell'abbonamento.