Method: purchases.subscriptionsv2.scheduleplantransition

定期購入のプラン移行スケジュールを設定します。

HTTP リクエスト

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:schedulePlanTransition

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

パスパラメータ

パラメータ
packageName

string

必須。定期購入したアプリのパッケージ(例: 「com.some.thing」)。

token

string

必須。定期購入の購入時にユーザーのデバイスに提供されたトークン。

リクエストの本文

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

JSON 表現
{
  "productId": string,
  "earliestTransitionEffectiveTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "definiteTransition": {
    object (DefiniteTransition)
  },
  "tentativeTransition": {
    object (TentativeTransition)
  }
  // End of mutually exclusive fields.
  "etag": string
}
フィールド
productId

string

必須。移行をスケジュールする必要のある定期購入商品(例: 「premium_plan」)。

earliestTransitionEffectiveTime

string (Timestamp format)

必須。プラン移行が有効になる可能性のある最も早い日時。実際の移行は、この日時以降の更新時に実施されます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

[必須] プラン移行のモード。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
definiteTransition

object (DefiniteTransition)

このモードを使用する場合、ユーザーの新たなプランへの移行は確定しておりキャンセルできません。

tentativeTransition

object (TentativeTransition)

このモードを使用する場合、ユーザーの新たなプランへの移行は暫定でありキャンセルできます。

相互に排他的なフィールドの終了。
etag

string

ETag が設定されている場合は、この定期購入の最新の ETag と一致していないと API は失敗します。ETag は purchases.subscriptionsv2.get から取得されます。https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get

レスポンスの本文

purchases.subscriptionsv2.schedulePlanTransition API のレスポンス。

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

JSON 表現
{
  "planTransitionDetails": {
    object (PlanTransitionDetails)
  }
}
フィールド
planTransitionDetails

object (PlanTransitionDetails)

サブスクリプション アイテムのプラン移行の詳細。

認可スコープ

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

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

DefiniteTransition

この型にはフィールドがありません。

プラン移行が確定していることを示すために使用します。

TentativeTransition

この型にはフィールドがありません。

プラン移行が暫定であることを示すために使用します。