Method: purchases.subscriptions.defer

Deprecato: utilizza purchases.subscriptionsv2.defer. Posticipa l'acquisto di un abbonamento 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 dell'abbonamento acquistato (ad esempio "monthly001").
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 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 è riportato un esempio di richiesta:

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 di scadenza prevista per l'abbonamento. Se la data di scadenza attuale dell'abbonamento non corrisponde al valore specificato qui, il posticipo non verrà eseguito.
desiredExpiryTimeMillis

string (int64 format)

La prossima data di scadenza desiderata da assegnare all'abbonamento, in millisecondi dall'epoca. La data indicata deve essere successiva/maggiore della data di scadenza attuale dell'abbonamento.