Method: purchases.subscriptionsv2.scheduleplantransition

Menjadwalkan transisi paket untuk langganan.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
packageName

string

Wajib. Paket aplikasi yang langganannya ini dibeli (misalnya, 'com.some.thing').

token

string

Wajib. Token yang diberikan ke perangkat pengguna saat langganan dibeli.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi 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
}
Kolom
productId

string

Wajib. Produk langganan (misalnya, 'premium_plan') yang transisinya harus dijadwalkan.

earliestTransitionEffectiveTime

string (Timestamp format)

Wajib. Waktu paling awal saat transisi paket dapat diterapkan. Transisi sebenarnya akan terjadi pada saat perpanjangan dilakukan atau setelah waktu ini.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

[Wajib] Mode untuk transisi paket. Berikut adalah daftar kolom yang saling eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
definiteTransition

object (DefiniteTransition)

Saat menggunakan mode ini, transisi pengguna ke paket baru sudah pasti, dan tidak dapat dibatalkan.

tentativeTransition

object (TentativeTransition)

Saat menggunakan mode ini, transisi pengguna ke paket baru bersifat tentatif, dan dapat dibatalkan.

Akhir kolom yang saling eksklusif.
etag

string

Jika disetel, API akan gagal jika etag tidak sesuai dengan etag terbaru untuk langganan ini. ETag diambil dari purchases.subscriptionsv2.get: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get

Isi respons

Respons untuk API purchases.subscriptionsv2.schedulePlanTransition.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "planTransitionDetails": {
    object (PlanTransitionDetails)
  }
}
Kolom
planTransitionDetails

object (PlanTransitionDetails)

Detail transisi paket item langganan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

DefiniteTransition

Jenis ini tidak memiliki kolom.

Digunakan untuk menunjukkan bahwa transisi paket sudah pasti.

TentativeTransition

Jenis ini tidak memiliki kolom.

Digunakan untuk menunjukkan bahwa transisi paket bersifat tentatif.