Method: monetization.subscriptions.basePlans.offers.batchUpdate

定期購読オファーのバッチを更新します。

更新スループットを最大にするには、ネストされたリクエストの latencyTolerance フィールドを PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT に設定する。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
packageName

string

必須。更新された定期購入オファーの親アプリ（パッケージ名）。

更新されたすべての SubscriptionOffer リソースの packageName フィールドと同じにする必要があります。
productId

string

必須。親定期購入のプロダクト ID（更新されたオファーがすべて同じ定期購入に属している場合）。このリクエストが複数の定期購入にまたがっている場合は、このフィールドを「-」に設定します。設定する必要があります。
basePlanId

string

必須。特典を更新する親基本プラン（ID）。「-」として指定できるを使用して、複数の基本プランの特典を更新できます。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "requests": [
    {
      object (UpdateSubscriptionOfferRequest)
    }
  ]
}
フィールド
requests[]

object (UpdateSubscriptionOfferRequest)

必須。最大 100 個の要素を含む更新リクエストのリスト。すべてのリクエストでは、異なる購読オファーを更新する必要があります。

レスポンスの本文

offers.batchUpdate に対するレスポンス メッセージです。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "subscriptionOffers": [
    {
      object (SubscriptionOffer)
    }
  ]
}
フィールド
subscriptionOffers[]

object (SubscriptionOffer)

更新された定期購入オファーのリスト。

認可スコープ

次の OAuth スコープが必要です。

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

UpdateSubscriptionOfferRequest

offers.patch に対するリクエスト メッセージ。

JSON 表現 
{
  "subscriptionOffer": {
    object (SubscriptionOffer)
  },
  "updateMask": string,
  "regionsVersion": {
    object (RegionsVersion)
  },
  "allowMissing": boolean,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
フィールド
subscriptionOffer

object (SubscriptionOffer)

必須。更新する購読オファー。
updateMask

string (FieldMask format)

必須。更新するフィールドのリスト。

完全修飾フィールド名のカンマ区切りリスト。例: "user.displayName,photo"。
regionsVersion

object (RegionsVersion)

必須。subscriptionOffer に使用される利用可能なリージョンのバージョン。
allowMissing

boolean

省略可。true に設定され、指定された packageName、productId、basePlanId、offerId を持つ定期購入オファーが存在しない場合は、オファーが作成されます。

新しいオファーが作成された場合、updateMask は無視されます。
latencyTolerance

enum (ProductUpdateLatencyTolerance)

省略可。このプロダクトの更新の伝播に対するレイテンシの許容度。デフォルトでは、レイテンシの影響を受けやすい設定になります。