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 diisi. Aplikasi induk (nama paket) dari penawaran langganan yang diperbarui.

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

productId

string

Wajib diisi. 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 ditetapkan.

basePlanId

string

Wajib diisi. Paket dasar (ID) induk yang penawarannya harus diperbarui. Dapat ditetapkan 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 diisi. Daftar permintaan pembaruan yang berisi hingga 100 elemen. Semua permintaan harus memperbarui penawaran yang berbeda.

Isi respons

Pesan respons untuk offer.CreatorStates.

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 harus ditetapkan. state_transition_type hanya dapat berupa salah satu dari berikut:
activateSubscriptionOfferRequest

object (ActivateSubscriptionOfferRequest)

Mengaktifkan penawaran. Setelah diaktifkan, penawaran akan tersedia untuk 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 diisi. Aplikasi induk (nama paket) penawaran yang akan diaktifkan.

productId

string

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

basePlanId

string

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

offerId

string

Wajib diisi. 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 diisi. Aplikasi induk (nama paket) penawaran yang akan dinonaktifkan.

productId

string

Wajib diisi. Langganan induk (ID) dari penawaran yang akan dinonaktifkan.

basePlanId

string

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

offerId

string

Wajib diisi. 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.