Method: monetization.subscriptions.batchUpdate

定期購入をまとめて更新します。

ネストされたリクエストの LatencyTolerance フィールドを PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT に設定して、更新スループットを最大化します。

HTTP リクエスト

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions:batchUpdate

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

パスパラメータ

パラメータ
packageName

string

必須。定期購入を更新する親アプリ（パッケージ名）。すべてのサブスクリプション リソースの packageName フィールドと同じにする必要があります。

リクエスト本文

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

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

object (UpdateSubscriptionRequest)

必須。最大 100 個の要素を持つ更新リクエストのリスト。すべてのリクエストで、異なるサブスクリプションを更新する必要があります。

レスポンスの本文

BatchUpdateSubscription に対するレスポンス メッセージ。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

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

object (Subscription)

更新された定期購入リスト。

認可スコープ

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

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

UpdateSubscriptionRequest

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

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

object (Subscription)

必須。更新する定期購入。
updateMask

string (FieldMask format)

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

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

object (RegionsVersion)

必須。サブスクリプションで使用されている利用可能なリージョンのバージョン。
allowMissing

boolean

（省略可）true に設定され、指定された packageName と productId のサブスクリプションが存在しない場合、サブスクリプションは作成されます。

新しいサブスクリプションが作成された場合、updateMask は無視されます。
latencyTolerance

enum (ProductUpdateLatencyTolerance)

（省略可）このプロダクトの更新の伝播の許容範囲。デフォルトでは、レイテンシの影響を受けやすい値に設定されます。