REST Resource: purchases.products

リソース: ProductPurchase

ProductPurchase リソースは、ユーザーのアプリ内アイテム購入のステータスを示します。

JSON 表現
{
  "kind": string,
  "purchaseTimeMillis": string,
  "purchaseState": integer,
  "consumptionState": integer,
  "developerPayload": string,
  "orderId": string,
  "purchaseType": integer,
  "acknowledgementState": integer,
  "purchaseToken": string,
  "productId": string,
  "quantity": integer,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "refundableQuantity": integer
}
フィールド
kind

string

この種類は、androidpublisher サービスの inappPurchase オブジェクトを表します。

purchaseTimeMillis

string (int64 format)

商品が購入された時刻を、エポック(1970 年 1 月 1 日)からのミリ秒単位で示します。

purchaseState

integer

注文の購入状況です。有効な値は 0 です。1、キャンセル済み 2. 保留

consumptionState

integer

アプリ内アイテムの消費状態。有効な値は 0 です。未消費 1. 消費しました

developerPayload

string

注文に関する補足情報を含む、デベロッパーが指定する文字列。

orderId

string

アプリ内アイテムの購入に関連付けられたオーダー ID。

purchaseType

integer

アプリ内アイテムの購入タイプ。このフィールドは、標準のアプリ内課金フローを使用して購入が行われていない場合にのみ設定されます。有効な値は 0 です。テスト(ライセンス テスト アカウントから購入)1.プロモーション(プロモーション コードを使用して購入した場合など)2.リワード(課金する代わりに動画広告を視聴)

acknowledgementState

integer

アプリ内アイテムの承認ステータスです。有効な値は 0 です。未確認 1. 承認済み

purchaseToken

string

この購入を識別するために生成された購入トークン。存在しない場合があります。

productId

string

アプリ内アイテムの SKU。存在しない場合があります。

quantity

integer

アプリ内アイテムの購入に関連付けられた数量。存在しない場合、数量は 1 です。

obfuscatedExternalAccountId

string

アプリ内でユーザーのアカウントに一意に関連付けられた ID の難読化バージョン。購入時に https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid を使用して指定された場合にのみ存在します。

obfuscatedExternalProfileId

string

アプリ内でユーザーのプロフィールに一意に関連付けられた ID の難読化バージョン。購入時に https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid を使用して指定された場合にのみ存在します。

regionCode

string

商品が付与された時点でのユーザーの ISO 3166-1 alpha-2 請求地域コード。

refundableQuantity

integer

払い戻しの対象となる数量、つまり払い戻しが行われていない数量。数量に基づく一部払い戻しと全額払い戻しが反映されています。

Methods

acknowledge

アプリ内アイテムの購入を承認します。

consume

アプリ内アイテムの購入を消費します。

get

アプリ内アイテムの購入と消費のステータスを確認します。