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 指定時,才會顯示這個 ID。

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

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