Method: monetization.subscriptions.basePlans.batchUpdateStates

Mengaktifkan atau menonaktifkan paket dasar di satu atau beberapa langganan.

Tetapkan kolom latencyTolerance pada permintaan bertingkat ke PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT untuk mencapai throughput update maksimum.

Permintaan HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchUpdateStates

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
packageName

string

Wajib. Aplikasi induk (nama paket) untuk paket dasar yang diperbarui.
productId

string

Wajib. ID produk langganan induk, jika semua paket dasar yang diperbarui termasuk dalam langganan yang sama. Jika kumpulan update ini mencakup beberapa langganan, setel kolom ini ke "-". Harus disetel.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "requests": [
    {
      object (UpdateBasePlanStateRequest)
    }
  ]
}
Kolom
requests[]

object (UpdateBasePlanStateRequest)

Wajib. Daftar permintaan update hingga 100 elemen. Semua permintaan harus memperbarui paket dasar yang berbeda.

Isi respons

Pesan respons untuk basePlans.batchUpdateStates.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "subscriptions": [
    {
      object (Subscription)
    }
  ]
}
Kolom
subscriptions[]

object (Subscription)

Daftar langganan yang diperbarui. Daftar ini akan mencocokkan permintaan one to one, dalam urutan yang sama.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

UpdateBasePlanStateRequest

Pesan permintaan untuk memperbarui status paket dasar langganan.

Representasi JSON 
{

  // Union field state_transition_type can be only one of the following:
  "activateBasePlanRequest": {
    object (ActivateBasePlanRequest)
  },
  "deactivateBasePlanRequest": {
    object (DeactivateBasePlanRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
Kolom
Kolom union state_transition_type. Jenis transisi status yang akan diterapkan. Tepatnya satu yang harus disetel. state_transition_type hanya dapat berupa salah satu dari berikut:
activateBasePlanRequest

object (ActivateBasePlanRequest)

Mengaktifkan paket dasar. Setelah diaktifkan, paket dasar akan tersedia bagi pelanggan baru.
deactivateBasePlanRequest

object (DeactivateBasePlanRequest)

Menonaktifkan paket dasar. Setelah dinonaktifkan, paket dasar akan menjadi tidak tersedia bagi pelanggan baru, tetapi pelanggan lama akan mempertahankan langganan mereka

ActivateBasePlanRequest

Pesan permintaan untuk ActivateBasePlan.

Representasi JSON 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Kolom
packageName

string

Wajib. Aplikasi induk (nama paket) untuk paket dasar yang akan diaktifkan.
productId

string

Wajib. Langganan induk (ID) paket dasar yang akan diaktifkan.
basePlanId

string

Wajib. ID paket dasar unik untuk paket dasar yang akan diaktifkan.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Opsional. Toleransi latensi untuk propagasi update produk ini. Setelan defaultnya sensitif terhadap latensi.

DeactivateBasePlanRequest

Pesan permintaan untuk basePlans.deactivate.

Representasi JSON 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Kolom
packageName

string

Wajib. Aplikasi induk (nama paket) untuk paket dasar yang akan dinonaktifkan.
productId

string

Wajib. Langganan induk (ID) untuk paket dasar yang akan dinonaktifkan.
basePlanId

string

Wajib. ID paket dasar unik untuk paket dasar yang akan dinonaktifkan.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Opsional. Toleransi latensi untuk propagasi update produk ini. Setelan defaultnya sensitif terhadap latensi.