Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdate

1 回限りのアイテムの特典を 1 つ以上作成または更新します。

HTTP リクエスト

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdate

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

パスパラメータ

パラメータ
packageName

string

必須。更新された特典の親アプリ(パッケージ名)。

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

productId

string

必須。更新されたすべての特典が同じアイテムに属する場合は、1 回限りの親アイテムのアイテム ID。リクエストが複数の 1 回限りのアイテムを対象とする場合は、このフィールドに「-」を設定します。

purchaseOptionId

string

必須。特典を更新する必要がある親購入オプション(ID)。複数の購入オプションの特典を更新する場合は「-」を指定できます。

リクエストの本文

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

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

object (UpdateOneTimeProductOfferRequest)

必須。最大 100 個の要素を持つ更新リクエストのリスト。それぞれのリクエストが更新対象とする特典はすべて異なっている必要があります。

レスポンスの本文

offers.batchUpdate のレスポンス メッセージ。

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

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

object (OneTimeProductOffer)

更新された 1 回限りのアイテムの特典リスト(リクエストと同じ順序)。

認可スコープ

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

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

UpdateOneTimeProductOfferRequest

UpdateOneTimeProductOffer のリクエスト メッセージ。

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

object (OneTimeProductOffer)

必須。更新する 1 回限りのアイテムの特典。

updateMask

string (FieldMask format)

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

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

regionsVersion

object (RegionsVersion)

必須。特典で使用されている利用可能な地域のバージョン。

allowMissing

boolean

省略可。true に設定すると、指定された packageName、productId、purchaseOptionId、offerId に一致する特典が存在しない場合、その特典が作成されます。

新しい特典が作成された場合、updateMask は無視されます。

latencyTolerance

enum (ProductUpdateLatencyTolerance)

省略可。この特典の更新の伝播に関する遅延の影響度。デフォルトは latency-sensitive です。