Method: purchases.subscriptionsv2.defer

Posticipa il rinnovo di un abbonamento.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
packageName

string

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

string

Obbligatorio. 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 
{
  "deferralContext": {
    object (DeferralContext)
  }
}
Campi
deferralContext

object (DeferralContext)

Obbligatorio. Dettagli sul rinvio dell'abbonamento.

Corpo della risposta

Risposta per l'API v2 purchases.subscriptions.defer.

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

Rappresentazione JSON 
{
  "itemExpiryTimeDetails": [
    {
      object (ItemExpiryTimeDetails)
    }
  ]
}
Campi
itemExpiryTimeDetails[]

object (ItemExpiryTimeDetails)

La nuova data di scadenza per ogni elemento dell'abbonamento.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

DeferralContext

Contesto di differimento dell'API purchases.subscriptionsv2.defer.

Rappresentazione JSON 
{
  "etag": string,
  "deferDuration": string,
  "validateOnly": boolean
}
Campi
etag

string

Obbligatorio. L'API non andrà a buon fine se l'etag non corrisponde all'etag più recente per questo abbonamento. L'etag viene recuperato da purchases.subscriptionsv2.get: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get
deferDuration

string (Duration format)

Obbligatorio. La durata per cui tutti gli elementi dell'abbonamento devono essere posticipati.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
validateOnly

boolean

Se impostato su "true", la richiesta è una prova generale per convalidare l'effetto di subscriptionsv2.defer, l'abbonamento non verrà interessato.

ItemExpiryTimeDetails

Dettagli dell'ora di scadenza di un elemento dell'abbonamento.

Rappresentazione JSON 
{
  "productId": string,
  "expiryTime": string
}
Campi
productId

string

L'ID prodotto dell'articolo in abbonamento (ad esempio "premium_plan").
expiryTime

string (Timestamp format)

La nuova ora di scadenza per questo elemento dell'abbonamento.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".