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)

產品的購買時間，以自 Epoch 紀元時間 (1970 年 1 月 1 日) 起的毫秒為單位。
purchaseState

integer

訂購單的購買狀態。可能的值為 0。已購買 1 個。已取消 2. 待處理
consumptionState

integer

應用程式內商品的消費狀態。可能的值為 0。尚未使用 1. 使用
developerPayload

string

開發人員指定的字串，內容為有關訂購單的其他資訊。
orderId

string

與應用程式內產品購買交易相關聯的訂單 ID。
purchaseType

integer

應用程式內產品的購買類型。只有在未使用標準應用程式內結帳流程完成購買交易時，才會設定這個欄位。可能的值為 0。測試 (即透過授權測試帳戶購買) 1. 促銷 (即使用促銷代碼購買)。不含購買 Play Points 的消費。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

 檢查應用程式內商品的購買和消費狀態。