定期購入のプラン移行スケジュールを設定します。
HTTP リクエスト
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:schedulePlanTransition
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
| パラメータ | |
|---|---|
packageName |
必須。定期購入したアプリのパッケージ(例: 「com.some.thing」)。 |
token |
必須。定期購入の購入時にユーザーのデバイスに提供されたトークン。 |
リクエストの本文
リクエストの本文には、次の構造のデータが含まれます。
| 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 ( |
| フィールド | |
|---|---|
productId |
必須。移行をスケジュールする必要のある定期購入商品(例: 「premium_plan」)。 |
earliestTransitionEffectiveTime |
必須。プラン移行が有効になる可能性のある最も早い日時。実際の移行は、この日時以降の更新時に実施されます。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
| [必須] プラン移行のモード。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。 | |
definiteTransition |
このモードを使用する場合、ユーザーの新たなプランへの移行は確定しておりキャンセルできません。 |
tentativeTransition |
このモードを使用する場合、ユーザーの新たなプランへの移行は暫定でありキャンセルできます。 |
| 相互に排他的なフィールドの終了。 | |
etag |
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 |
サブスクリプション アイテムのプラン移行の詳細。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/androidpublisher
DefiniteTransition
この型にはフィールドがありません。
プラン移行が確定していることを示すために使用します。
TentativeTransition
この型にはフィールドがありません。
プラン移行が暫定であることを示すために使用します。