Method: purchases.subscriptionsv2.scheduleplantransition

Pianifica una transizione di piano per un abbonamento.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di 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
{
  "productId": string,
  "earliestTransitionEffectiveTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "definiteTransition": {
    object (DefiniteTransition)
  },
  "tentativeTransition": {
    object (TentativeTransition)
  }
  // End of mutually exclusive fields.
  "etag": string
}
Campi
productId

string

Obbligatorio. Il prodotto in abbonamento (ad esempio "premium_plan") per cui deve essere pianificata la transizione.

earliestTransitionEffectiveTime

string (Timestamp format)

Obbligatorio. La prima data in cui la transizione del piano può avere effetto. La transizione effettiva avverrà al momento del rinnovo, il giorno o in una data successiva.

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".

[Obbligatorio] La modalità per la transizione del piano. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
definiteTransition

object (DefiniteTransition)

Quando utilizzi questa modalità, la transizione dell'utente al nuovo piano è definitiva e non può essere annullata.

tentativeTransition

object (TentativeTransition)

Quando utilizzi questa modalità, la transizione dell'utente al nuovo piano è provvisoria e può essere annullata.

Fine dei campi che si escludono a vicenda.
etag

string

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

Corpo della risposta

Risposta per l'API purchases.subscriptionsv2.schedulePlanTransition.

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

Rappresentazione JSON
{
  "planTransitionDetails": {
    object (PlanTransitionDetails)
  }
}
Campi
planTransitionDetails

object (PlanTransitionDetails)

I dettagli della transizione del piano dell'elemento dell'abbonamento.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

DefiniteTransition

Questo tipo non ha campi.

Utilizzato per indicare che la transizione del piano è definitiva.

TentativeTransition

Questo tipo non ha campi.

Utilizzato per indicare che la transizione del piano è provvisoria.