Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

Memperbarui batch status penawaran langganan.

Tetapkan kolom latensiTolerance 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) dari penawaran langganan yang diperbarui.

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

string

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

string

Wajib. Paket dasar (ID) induk 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 pembaruan hingga 100 elemen. Semua permintaan harus memperbarui penawaran yang berbeda.

Isi respons

Pesan respons untuk offer.androidTestStates.

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 ini:

  • 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, tepat satu yang harus ditetapkan. state_transition_type hanya ada berupa salah satu diantara berikut:
activateSubscriptionOfferRequest

object (ActivateSubscriptionOfferRequest)

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

object (DeactivateSubscriptionOfferRequest)

Menonaktifkan penawaran. Setelah dinonaktifkan, penawaran tidak akan tersedia untuk pelanggan baru, tetapi pelanggan lama akan tetap berlangganan

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 (ID) induk dari penawaran yang akan diaktifkan.
offerId

string

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

enum (ProductUpdateLatencyTolerance)

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

DeactivateSubscriptionOfferRequest

Pesan permintaan untuk offer.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 (ID) induk dari penawaran yang akan dinonaktifkan.
offerId

string

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

enum (ProductUpdateLatencyTolerance)

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