- Richiesta HTTP
- Parametri di percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- DefiniteTransition
- TentativeTransition
- Fai una prova!
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 |
Obbligatorio. Il pacchetto dell'applicazione per cui è stato acquistato questo abbonamento (ad esempio, "com.some.thing"). |
token |
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 ( |
| Campi | |
|---|---|
productId |
Obbligatorio. Il prodotto in abbonamento (ad esempio "premium_plan") per cui deve essere pianificata la transizione. |
earliestTransitionEffectiveTime |
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: |
| [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 |
Quando utilizzi questa modalità, la transizione dell'utente al nuovo piano è definitiva e non può essere annullata. |
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 |
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 ( |
| Campi | |
|---|---|
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.