- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- DefiniteTransition
- TentativeTransition
- Wypróbuj
Zaplanuj przejście na inny abonament w ramach subskrypcji.
Żądanie HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:schedulePlanTransition
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry | |
|---|---|
packageName |
Wymagane. Pakiet aplikacji, w której kupiono subskrypcję (np. „com.some.thing”). |
token |
Wymagane. Token dostarczony na urządzenie użytkownika podczas zakupu subskrypcji. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
| Zapis 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 ( |
| Pola | |
|---|---|
productId |
Wymagane. Produkt objęty subskrypcją (np. „premium_plan”), dla którego należy zaplanować przejście. |
earliestTransitionEffectiveTime |
Wymagane. Najwcześniejszy moment, w którym może nastąpić przejście na inny abonament. Rzeczywiste przejście nastąpi w momencie odnowienia subskrypcji w tym dniu lub później. Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: |
| [Wymagane] Tryb przejścia na inny abonament. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól: | |
definiteTransition |
W tym trybie przejście użytkownika na nowy abonament jest ostateczne i nie można go anulować. |
tentativeTransition |
W tym trybie przejście użytkownika na nowy abonament jest tymczasowe i można je anulować. |
| Koniec pól wykluczających się wzajemnie. | |
etag |
Jeśli ten parametr jest ustawiony, interfejs API nie zadziała, gdy element etag nie będzie pasować do najnowszego elementu etag tej subskrypcji. Tag etag jest pobierany z purchases.subscriptionsv2.get: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get |
Treść odpowiedzi
Odpowiedź interfejsu API purchases.subscriptionsv2.schedulePlanTransition.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
| Zapis JSON |
|---|
{
"planTransitionDetails": {
object ( |
| Pola | |
|---|---|
planTransitionDetails |
Szczegóły przejścia na inny abonament w przypadku subskrypcji. |
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/androidpublisher
DefiniteTransition
Ten typ nie ma pól.
Służy do wskazania, że przejście na inny abonament jest ostateczne.
TentativeTransition
Ten typ nie ma pól.
Służy do wskazania, że przejście na inny abonament jest tymczasowe.