Method: purchases.subscriptionsv2.scheduleplantransition

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

string

Wymagane. Pakiet aplikacji, w której kupiono subskrypcję (np. „com.some.thing”).

token

string

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 (DefiniteTransition)
  },
  "tentativeTransition": {
    object (TentativeTransition)
  }
  // End of mutually exclusive fields.
  "etag": string
}
Pola
productId

string

Wymagane. Produkt objęty subskrypcją (np. „premium_plan”), dla którego należy zaplanować przejście.

earliestTransitionEffectiveTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

[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

object (DefiniteTransition)

W tym trybie przejście użytkownika na nowy abonament jest ostateczne i nie można go anulować.

tentativeTransition

object (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

string

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 (PlanTransitionDetails)
  }
}
Pola
planTransitionDetails

object (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.