- HTTP リクエスト
- パスパラメータ
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- UpdateBasePlanStateRequest
- ActivateBasePlanRequest
- DeactivateBasePlanRequest
- 試してみる
1 つまたは複数の定期購入で基本プランを有効または無効にします。
ネストされたリクエストの LatencyTolerance フィールドを PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT に設定して、更新スループットを最大化します。
HTTP リクエスト
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchUpdateStates
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
packageName |
必須。更新された基本プランの親アプリ(パッケージ名)。 |
productId |
必須。更新された基本プランがすべて同じ定期購入に属している場合、親定期購入のアイテム ID。このバッチ更新が複数のサブスクリプションにまたがっている場合は、このフィールドを「-」に設定します。設定する必要があります。 |
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{
"requests": [
{
object ( |
フィールド | |
---|---|
requests[] |
必須。最大 100 個の要素を含む更新リクエストのリスト。すべてのリクエストで異なる基本プランを更新する必要があります。 |
レスポンスの本文
basePlans.batchUpdateStates に対するレスポンス メッセージ。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{
"subscriptions": [
{
object ( |
フィールド | |
---|---|
subscriptions[] |
更新された定期購入のリスト。このリストは、同じ順序でリクエストを 1 対 1 で照合します。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/androidpublisher
UpdateBasePlanStateRequest
定期購入の基本プランの状態を更新するためのリクエスト メッセージ。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド state_transition_type 。適用する状態遷移のタイプ。1 つだけ設定する必要があります。state_transition_type は次のいずれかになります。 |
|
activateBasePlanRequest |
基本プランを有効にする。基本プランを有効にすると、新規の定期購入者が基本プランを利用できるようになります。 |
deactivateBasePlanRequest |
基本プランを無効にします。無効にすると、新規の定期購入者は基本プランを利用できなくなりますが、既存の定期購入者は定期購入を継続します |
ActivateBasePlanRequest
ActivateBasePlan に対するリクエスト メッセージです。
JSON 表現 |
---|
{
"packageName": string,
"productId": string,
"basePlanId": string,
"latencyTolerance": enum ( |
フィールド | |
---|---|
packageName |
必須。有効にする基本プランの親アプリ(パッケージ名)。 |
productId |
必須。有効にする基本プランの親定期購入(ID)。 |
basePlanId |
必須。有効にする基本プランの一意の基本プラン ID。 |
latencyTolerance |
(省略可)このプロダクトの更新の伝播の許容範囲。デフォルトでは、レイテンシの影響を受けやすい値に設定されます。 |
DeactivateBasePlanRequest
basePlans.deactivate に対するリクエスト メッセージ。
JSON 表現 |
---|
{
"packageName": string,
"productId": string,
"basePlanId": string,
"latencyTolerance": enum ( |
フィールド | |
---|---|
packageName |
必須。無効にする基本プランの親アプリ(パッケージ名)。 |
productId |
必須。無効にする基本プランの親定期購入(ID)。 |
basePlanId |
必須。無効にする基本プランの一意の基本プラン ID。 |
latencyTolerance |
(省略可)このプロダクトの更新の伝播の許容範囲。デフォルトでは、レイテンシの影響を受けやすい値に設定されます。 |