Method: monetization.onetimeproducts.purchaseOptions.batchUpdateStates

1 つまたは複数の 1 回限りのアイテムで購入オプションを有効または無効にします。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
packageName

string

必須。更新された購入オプションの親アプリ（パッケージ名）。
productId

string

必須。更新されたすべての購入オプションが同じ 1 回限りのアイテムに属する場合は、1 回限りの親アイテムのアイテム ID。バッチ更新が複数の 1 回限りのアイテムを対象とする場合は、このフィールドに「-」を設定します。

リクエストの本文

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

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

object (UpdatePurchaseOptionStateRequest)

必須。最大 100 の要素を含む更新リクエストのリスト。すべてのリクエストでそれぞれ異なる購入オプションを更新する必要があります。

レスポンスの本文

purchaseOptions.batchUpdateStates のレスポンス メッセージ。

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

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

object (OneTimeProduct)

更新された 1 回限りのアイテムのリスト。このリストは、リクエストと 1 対 1 で同じ順序に並べられます。

認可スコープ

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

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

UpdatePurchaseOptionStateRequest

1 回限りのアイテムの購入オプションの状態を更新するリクエスト メッセージ。

JSON 表現 
{

  // Union field state_transition_type can be only one of the following:
  "activatePurchaseOptionRequest": {
    object (ActivatePurchaseOptionRequest)
  },
  "deactivatePurchaseOptionRequest": {
    object (DeactivatePurchaseOptionRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
フィールド
共用体フィールド state_transition_type。適用する状態遷移のタイプ。必ず 1 つ設定する必要があります。state_transition_type は次のいずれかになります。
activatePurchaseOptionRequest

object (ActivatePurchaseOptionRequest)

購入オプションを有効にします。購入オプションが利用可能になります。
deactivatePurchaseOptionRequest

object (DeactivatePurchaseOptionRequest)

購入オプションを無効にします。購入オプションが利用できなくなります。

ActivatePurchaseOptionRequest

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

JSON 表現 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
フィールド
packageName

string

必須。有効にする購入オプションの親アプリ（パッケージ名）。
productId

string

必須。有効にする購入オプションの 1 回限りの親アイテム（ID）。
purchaseOptionId

string

必須。有効にする購入オプションの購入オプション ID。
latencyTolerance

enum (ProductUpdateLatencyTolerance)

省略可。このアイテムの更新の伝播に関する遅延の許容度。デフォルトは latency-sensitive です。

DeactivatePurchaseOptionRequest

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

JSON 表現 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
フィールド
packageName

string

必須。無効にする購入オプションの親アプリ（パッケージ名）。
productId

string

必須。無効にする購入オプションの 1 回限りの親アイテム（ID）。
purchaseOptionId

string

必須。無効にする購入オプションの購入オプション ID。
latencyTolerance

enum (ProductUpdateLatencyTolerance)

省略可。このアイテムの更新の伝播に関する遅延の許容度。デフォルトは latency-sensitive です。