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.プロモーション(プロモーション コードを使用した購入など)。Play ポイントによる購入は含まれません。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

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

メソッド

acknowledge

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

consume

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

get

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