Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

Memperbarui batch status penawaran 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/{basePlanId}/offers:batchUpdateStates

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
packageName

string

Wajib. Aplikasi induk (nama paket) untuk penawaran langganan yang diperbarui.

Harus sama dengan kolom packageName pada semua resource SubscriptionOffer yang diperbarui.
productId

string

Wajib. ID produk langganan induk, jika semua penawaran yang diperbarui termasuk dalam langganan yang sama. Jika permintaan ini mencakup beberapa langganan, setel kolom ini ke "-". Harus disetel.
basePlanId

string

Wajib. Paket dasar induk (ID) yang penawarannya harus diperbarui. Dapat ditentukan sebagai '-' untuk memperbarui penawaran dari beberapa paket dasar.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

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

object (UpdateSubscriptionOfferStateRequest)

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

Isi respons

Pesan respons untuk offers.batchUpdateStates.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "subscriptionOffers": [
    {
      object (SubscriptionOffer)
    }
  ]
}
Kolom
subscriptionOffers[]

object (SubscriptionOffer)

Daftar penawaran langganan yang diperbarui.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

UpdateSubscriptionOfferStateRequest

Pesan permintaan untuk memperbarui status penawaran langganan.

Representasi JSON 
{

  // Union field state_transition_type can be only one of the following:
  "activateSubscriptionOfferRequest": {
    object (ActivateSubscriptionOfferRequest)
  },
  "deactivateSubscriptionOfferRequest": {
    object (DeactivateSubscriptionOfferRequest)
  }
  // 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:
activateSubscriptionOfferRequest

object (ActivateSubscriptionOfferRequest)

Mengaktifkan penawaran. Setelah diaktifkan, penawaran akan tersedia bagi pelanggan baru.
deactivateSubscriptionOfferRequest

object (DeactivateSubscriptionOfferRequest)

Menonaktifkan penawaran. Setelah dinonaktifkan, penawaran tidak akan lagi tersedia bagi pelanggan baru, tetapi pelanggan lama akan mempertahankan langganan mereka

ActivateSubscriptionOfferRequest

Pesan permintaan untuk ActivateSubscriptionOffer.

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

string

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

string

Wajib. Langganan induk (ID) penawaran yang akan diaktifkan.
basePlanId

string

Wajib. Paket dasar induk (ID) penawaran yang akan diaktifkan.
offerId

string

Wajib. ID penawaran unik untuk penawaran yang akan diaktifkan.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateSubscriptionOfferRequest

Pesan permintaan untuk offers.deactivate.

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

string

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

string

Wajib. Langganan induk (ID) penawaran yang akan dinonaktifkan.
basePlanId

string

Wajib. Paket dasar induk (ID) penawaran yang akan dinonaktifkan.
offerId

string

Wajib. ID penawaran unik dari penawaran yang akan dinonaktifkan.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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