- リソース: SubscriptionPurchaseV2
- SubscriptionState
- PausedStateContext
- CanceledStateContext
- UserInitiatedCancellation
- CancelSurveyResult
- CancelSurveyReason
- SystemInitiatedCancellation
- デベロッパーによって開始されたキャンセル
- 交換のキャンセル
- TestPurchase
- AcknowledgementState
- ExternalAccountIdentifiers
- SubscribeWithGoogleInfo
- SubscriptionPurchase 広告申込情報
- AutoPlaningPlan
- SubscriptionItemPriceChangeDetails
- 価格変更モード
- PriceChangeState
- PrepaidPlan
- OfferDetails
- Methods
リソース: SubscriptionPurchaseV2
ユーザーの定期購読の購入ステータスを示します。
JSON 表現 |
---|
{ "kind": string, "regionCode": string, "latestOrderId": string, "lineItems": [ { object ( |
フィールド | |
---|---|
kind |
この種類は、androidpublisher サービスの SubscriptionPurchaseV2 オブジェクトを表します。 |
regionCode |
定期購入が付与された時点でのユーザーの ISO 3166-1 alpha-2 請求先住所の国または地域コード。 |
latestOrderId |
定期購入の購入に関連付けられた最新の注文のオーダー ID。定期購入の自動更新の場合、まだ更新されていない場合の登録注文のオーダー ID、または直近の注文の ID(成功、保留中、または不承認)になります。前払いの定期購入の場合、これは、クエリされた購入トークンに関連付けられた注文 ID です。 |
lineItems[] |
定期購入における商品アイテムレベルの情報。同じ購入に含まれるアイテムはすべて、AutoRenewingPlan またはすべて PrepaidPlan のいずれかである必要があります。 |
startTime |
定期購入が付与された時刻。保留中の定期購入は設定されていません(定期購入は作成されましたが、登録時に支払いを待機しています)。 RFC3339 UTC「Zulu」形式のタイムスタンプ。ナノ秒の解像度と小数第 9 位以下までとなります。(例: |
subscriptionState |
サブスクリプションの現在の状態。 |
linkedPurchaseToken |
このサブスクリプションが次のいずれかに当てはまる場合、以前のサブスクリプションの購入トークン。* 解約していないが継続していないサブスクリプションの再登録 * 以前のサブスクリプションからアップグレードまたはダウングレード。* 前払いから自動更新の定期購入に切り替えます。* 自動更新の定期購入から前払いに切り替える。* 前払いの定期購入をチャージする。 |
pausedStateContext |
一時停止中の定期購入に関する追加のコンテキスト。定期購入に subscriptionState SUBSCRIPTION_STATE_PAused が現在存在する場合のみ存在します。 |
canceledStateContext |
解約された定期購入に関する追加コンテキスト。サブスクリプションに subscriptionState SUBSCRIPTION_STATE_CANCELED が存在する場合のみ存在します。 |
testPurchase |
このサブスクリプション購入がテスト購入の場合にのみ存在します。 |
acknowledgementState |
サブスクリプションの確認状態。 |
externalAccountIdentifiers |
サードパーティ サービス内のユーザー アカウント ID。 |
subscribeWithGoogleInfo |
「Google で購読」での購入に関連するユーザー プロフィール。 |
サブスクリプションの状態
定期購入の状態は、たとえば「有効」か「解約済み」かなどです。定期購入に含まれるアイテムは、すべて自動更新プランまたはプリペイド プランのいずれかです。
列挙型 | |
---|---|
SUBSCRIPTION_STATE_UNSPECIFIED |
定期購入のステータスが指定されていません。 |
SUBSCRIPTION_STATE_PENDING |
サブスクリプションが作成されましたが、登録時に支払いを待機しています。このステータスでは、すべての商品アイテムが支払い待ちの状態です。 |
SUBSCRIPTION_STATE_ACTIVE |
サブスクリプションは有効です。-(1)定期購入が自動更新プランである場合、少なくとも 1 つのアイテムが autoRenewEnabled であり、有効期限が切れていません。- (2)前払いプランの定期購入の場合は、少なくとも 1 つのアイテムが期限切れでない。 |
SUBSCRIPTION_STATE_PAUSED |
定期購入は一時停止されています。州を利用できるのは、定期購入が自動更新プランの場合のみです。この状態では、すべてのアイテムが一時停止状態になります。 |
SUBSCRIPTION_STATE_IN_GRACE_PERIOD |
サブスクリプションは猶予期間中です。州を利用できるのは、定期購入が自動更新プランの場合のみです。この状態では、すべてのアイテムが猶予期間です。 |
SUBSCRIPTION_STATE_ON_HOLD |
定期購入は保留中(停止中)です。州を利用できるのは、定期購入が自動更新プランの場合のみです。このステータスでは、すべての商品アイテムが保留状態になっています。 |
SUBSCRIPTION_STATE_CANCELED |
定期購入は解約されましたが、まだ有効期限が切れていません。州を利用できるのは、定期購入が自動更新プランの場合のみです。すべてのアイテムで autoRenewEnabled が false に設定されている。 |
SUBSCRIPTION_STATE_EXPIRED |
登録の有効期限が切れています。すべてのアイテムに有効期限は以前にあります。 |
PausedStateContext
一時停止状態の定期購入に固有の情報。
JSON 表現 |
---|
{ "autoResumeTime": string } |
フィールド | |
---|---|
autoResumeTime |
定期購入が自動的に再開される時間。 RFC3339 UTC「Zulu」形式のタイムスタンプ。ナノ秒の解像度と小数第 9 位以下までとなります。(例: |
CanceledStateContext
解約済み定期購入に固有の情報。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド cancellation_reason 。定期購入を解約した理由。cancellation_reason は次のいずれかになります。 |
|
userInitiatedCancellation |
定期購入はユーザーによって解約されました。 |
systemInitiatedCancellation |
定期購入は、請求上の問題などが原因でシステムによって解約されました。 |
developerInitiatedCancellation |
定期購入はデベロッパーによって解約されました。 |
replacementCancellation |
サブスクリプションが新しいサブスクリプションに置き換えられました。 |
UserInitiatedCancellation
ユーザーが開始したキャンセルに固有の情報。
JSON 表現 |
---|
{
"cancelSurveyResult": {
object ( |
フィールド | |
---|---|
cancelSurveyResult |
ユーザーが定期購入の解約フローを完了する際に提供された情報(解約理由に関するアンケート)。 |
cancelTime |
定期購入が解約された時刻。この後もユーザーは定期購入にアクセスできる可能性があります。lineItems.expiry_time を使用して、ユーザーにまだアクセス権があるかどうかを判断します。 RFC3339 UTC「Zulu」形式のタイムスタンプ。ナノ秒の解像度と小数第 9 位以下までとなります。(例: |
CancelSurveyResult
ユーザーが定期購入を解約した場合の解約アンケートの結果。
JSON 表現 |
---|
{
"reason": enum ( |
フィールド | |
---|---|
reason |
ユーザーが解約アンケートで選択した理由。 |
reasonUserInput |
CANCEL_SURVEY_REASON_OTHERS の場合のみ設定されます。これは、アンケートに対するユーザーの自由形式の回答です。 |
CancelSurveyReason
ユーザーが解約アンケートで選択した理由。
列挙型 | |
---|---|
CANCEL_SURVEY_REASON_UNSPECIFIED |
アンケートのキャンセルの理由が不明です。 |
CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE |
サブスクリプションの使用量が不十分です。 |
CANCEL_SURVEY_REASON_TECHNICAL_ISSUES |
アプリの使用時に技術的な問題が発生する。 |
CANCEL_SURVEY_REASON_COST_RELATED |
費用関連の問題。 |
CANCEL_SURVEY_REASON_FOUND_BETTER_APP |
お客様が、より優れたアプリを見つけました。 |
CANCEL_SURVEY_REASON_OTHERS |
その他の理由。 |
SystemInitiatedCancellation
Google システムで開始される解約に固有の情報。
DeveloperInitiatedCancellation
デベロッパーが開始した解約に固有の情報。
交換のキャンセル
定期購入の交換に起因する解約に固有の情報。
TestPurchase
この定期購入がテスト購入かどうか。
AcknowledgementState
サブスクリプションの確認ステータスの説明。
列挙型 | |
---|---|
ACKNOWLEDGEMENT_STATE_UNSPECIFIED |
確認応答ステータスの指定なし。 |
ACKNOWLEDGEMENT_STATE_PENDING |
この定期購入はまだ承認されていません。 |
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED |
定期購入は承認されます。 |
ExternalAccountIdentifiers
サードパーティ サービス内のユーザー アカウント ID。
JSON 表現 |
---|
{ "externalAccountId": string, "obfuscatedExternalAccountId": string, "obfuscatedExternalProfileId": string } |
フィールド | |
---|---|
externalAccountId |
サードパーティ サービス内のユーザー アカウント ID。アカウントのリンクが定期購入の購入フローの中で発生した場合のみ表示されます。 |
obfuscatedExternalAccountId |
アプリ内でユーザーのアカウントと一意に関連付けられている ID の難読化バージョン。* 購入フローの中でアカウントのリンクが行われた場合。* 購入時に https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid を使用して指定されている。 |
obfuscatedExternalProfileId |
アプリのユーザー プロフィールに一意に関連付けられている ID の難読化バージョン。購入時に https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid を使用して指定した場合のみ存在します。 |
SubscribeWithGoogleInfo
「Google で購読」での購入に関する情報。
JSON 表現 |
---|
{ "profileId": string, "profileName": string, "emailAddress": string, "givenName": string, "familyName": string } |
フィールド | |
---|---|
profileId |
定期購入購入時のユーザーの Google プロフィール ID。 |
profileName |
定期購入購入時のユーザーのプロフィール名。 |
emailAddress |
定期購入購入時に使用したユーザーのメールアドレス。 |
givenName |
定期購入を購入されたときのユーザーの氏名。 |
familyName |
定期購入を購入したユーザーのファミリー名。 |
SubscriptionPurchase 広告申込情報
定期購入における商品アイテムレベルの情報。
JSON 表現 |
---|
{ "productId": string, "expiryTime": string, // Union field |
フィールド | |
---|---|
productId |
購入された商品 ID('monthly001' など)。 |
expiryTime |
アクセスが延長(更新など)されない限り、サブスクリプションの有効期限が切れる、または期限切れになる時刻。 RFC3339 UTC「Zulu」形式のタイムスタンプ。ナノ秒の解像度と小数第 9 位以下までとなります。(例: |
共用体フィールド plan_type 。定期購入プランのタイプ。plan_type は次のいずれかになります。 |
|
autoRenewingPlan |
このアイテムは自動更新されています。 |
prepaidPlan |
このアイテムは前払いです。 |
offerDetails |
このアイテムの特典の詳細。 |
自動更新プラン
自動更新プランに関する情報。
JSON 表現 |
---|
{
"autoRenewEnabled": boolean,
"priceChangeDetails": {
object ( |
フィールド | |
---|---|
autoRenewEnabled |
サブスクリプションが現在自動更新に設定されている場合(ユーザーが定期購入を解約していない場合など) |
priceChangeDetails |
定期購入の登録後の、アイテムの前回の価格変更に関する情報。 |
定期購入アイテム価格変更の詳細
定期購入アイテムの価格変更に関する情報。
JSON 表現 |
---|
{ "newPrice": { object ( |
フィールド | |
---|---|
newPrice |
定期購入アイテムの新しい定期的な価格です。 |
priceChangeMode |
価格変更モードでは、定期購入アイテムの価格がどのように変更されるかを指定します。 |
priceChangeState |
価格変更の現状を示します。 |
expectedNewPriceChargeTime |
価格変更がユーザーに反映される更新時間。更新などの一時停止の時間が存在する場合は、今後(将来に)変更される可能性があります。 RFC3339 UTC「Zulu」形式のタイムスタンプ。ナノ秒の解像度と小数第 9 位以下までとなります。(例: |
価格変更モード
価格変更のモード。
列挙型 | |
---|---|
PRICE_CHANGE_MODE_UNSPECIFIED |
価格変更モードが指定されていません。この値は設定しないでください。 |
PRICE_DECREASE |
定期購入の価格が下がっているかどうか。 |
PRICE_INCREASE |
定期購入価格が値上げされ、ユーザーがこの定期購入を承認する必要がある場合。 |
PriceChangeState
価格変更のステータス。
列挙型 | |
---|---|
PRICE_CHANGE_STATE_UNSPECIFIED |
価格変更のステータスが指定されていません。この値は使用できません。 |
OUTSTANDING |
価格変更に対するユーザーの同意を待っています。 |
CONFIRMED |
価格変更が発生することが確認されました。 |
APPLIED |
価格変更が適用され、つまり、ユーザーに新しい価格の請求が開始されました。 |
前払いプラン
前払いプランに関する情報。
JSON 表現 |
---|
{ "allowExtendAfterTime": string } |
フィールド | |
---|---|
allowExtendAfterTime |
前払いプランの場合は、この期間を過ぎると、チャージしてチャージできるようになります。期限切れの前払いプランには含まれません。 RFC3339 UTC「Zulu」形式のタイムスタンプ。ナノ秒の解像度と小数第 9 位以下までとなります。(例: |
OfferDetails
購入広告申込情報に関連する特典の詳細。
JSON 表現 |
---|
{ "offerTags": [ string ], "basePlanId": string, "offerId": string } |
フィールド | |
---|---|
offerTags[] |
特典に関連付けられている最新の特典タグ。これには、基本プランから継承されたタグが含まれます。 |
basePlanId |
基本プラン ID。すべての基本プランと特典に対して提示します。 |
offerId |
特典 ID。割引特典の場合のみ表示されます。 |
Methods |
|
---|---|
|
サブスクリプションに関するメタデータを取得する |