REST Resource: purchases.productsv2

資源：ProductPurchaseV2

ProductPurchaseV2 資源會指出使用者應用程式內商品購買交易的狀態。

JSON 表示法 
{
  "productLineItem": [
    {
      object (ProductLineItem)
    }
  ],
  "kind": string,
  "purchaseStateContext": {
    object (PurchaseStateContext)
  },
  "testPurchaseContext": {
    object (TestPurchaseContext)
  },
  "orderId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "purchaseCompletionTime": string,
  "acknowledgementState": enum (AcknowledgementState)
}
欄位
productLineItem[]

object (ProductLineItem)

包含 ProductPurchaseV2 的商品層級資訊。
kind

string

這類代表 androidpublisher 服務中的 ProductPurchaseV2 物件。
purchaseStateContext

object (PurchaseStateContext)

購買交易的購買狀態相關資訊。
testPurchaseContext

object (TestPurchaseContext)

測試購買交易的相關資訊。這項設定只會用於測試購買交易。
orderId

string

與應用程式內商品購買交易相關聯的訂單 ID。如果購買交易沒有相關聯的訂單，則可能不會設定這項屬性。
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 指定時，才會顯示這個 ID。
regionCode

string

產品授予時，使用者的 ISO 3166-1 alpha-2 帳單地區代碼。
purchaseCompletionTime

string (Timestamp format)

購買交易成功的時間，也就是 PurchaseState 變更為 PURCHASED 的時間。付款完成後，系統才會顯示這個欄位。舉例來說，如果使用者發起了待處理交易 (https://developer.android.com/google/play/billing/integrate#pending)，這個欄位會等到使用者成功完成交易所需的步驟後，才會填入資料。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
acknowledgementState

enum (AcknowledgementState)

僅供輸出。購買交易的確認狀態。

PurchaseStateContext

購買狀態的相關情境。

JSON 表示法 
{
  "purchaseState": enum (PurchaseState)
}
欄位
purchaseState

enum (PurchaseState)

僅供輸出。購買交易的購買狀態。

PurchaseState

可能的購買狀態。

列舉
PURCHASE_STATE_UNSPECIFIED 未指定購買交易狀態。這個值絕不應設定。
PURCHASED 購買成功。
CANCELLED 已取消訂單
PENDING 購買交易處於待處理狀態，尚未完成。如要進一步瞭解如何處理未完成的購買交易，請參閱 https://developer.android.com/google/play/billing/integrate#pending。

TestPurchaseContext

測試購買交易的背景資訊。

JSON 表示法 
{
  "fopType": enum (FopType)
}
欄位
fopType

enum (FopType)

測試購買交易的付款方式類型。

FopType

可能的 fop 類型。

列舉
FOP_TYPE_UNSPECIFIED 未指定 FOP 類型。這個值絕不應設定。
TEST 使用測試卡完成交易。

ProductLineItem

包含 ProductPurchaseV2 的商品層級資訊。

JSON 表示法 
{
  "productId": string,
  "productOfferDetails": {
    object (ProductOfferDetails)
  }
}
欄位
productId

string

所購買產品的 ID (例如「monthly001」)。
productOfferDetails

object (ProductOfferDetails)

這項商品的優惠詳細資料。

ProductOfferDetails

與購買項目相關的優惠詳細資料資訊。

JSON 表示法 
{
  "offerTags": [
    string
  ],
  "offerId": string,
  "purchaseOptionId": string,
  "rentOfferDetails": {
    object (RentOfferDetails)
  },
  "offerToken": string,
  "quantity": integer,
  "refundableQuantity": integer,
  "consumptionState": enum (ConsumptionState)
}
欄位
offerTags[]

string

與優惠相關聯的最新優惠標記。包括從購買選項繼承的標記。
offerId

string

優惠 ID。僅適用於優惠。
purchaseOptionId

string

購買選項 ID。
rentOfferDetails

object (RentOfferDetails)

租賃優惠的詳細資料。這項設定僅適用於租賃委刊項。
offerToken

string

用來購買這個購買交易項目的每筆交易優惠憑證。
quantity

integer

與應用程式內商品購買交易相關聯的數量。
refundableQuantity

integer

符合退款資格的數量，也就是尚未退款的數量。這項值會反映以數量為準的部分退款和全額退款。
consumptionState

enum (ConsumptionState)

僅供輸出。購買交易的消耗狀態。

RentOfferDetails

這個類型沒有任何欄位。

與租賃委刊項相關的方案詳細資料。

ConsumptionState

可能的消耗狀態。

列舉
CONSUMPTION_STATE_UNSPECIFIED 未指定消耗狀態。這個值絕不應設定。
CONSUMPTION_STATE_YET_TO_BE_CONSUMED 尚未使用。
CONSUMPTION_STATE_CONSUMED 已兌換。

AcknowledgementState

一次性產品的確認狀態。

列舉
ACKNOWLEDGEMENT_STATE_UNSPECIFIED 未指定確認狀態。
ACKNOWLEDGEMENT_STATE_PENDING 尚未確認購買交易。
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED 已確認購買交易。

方法

getproductpurchasev2

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

錯誤代碼

這項資源的作業會傳回下列 HTTP 錯誤碼：

錯誤代碼 原因 解析度
5xx Google Play 伺服器發生一般錯誤。 重試要求。

如果問題持續發生，請與 Google Play 帳戶管理員聯絡，或提交支援要求。 建議查看 Play 狀態資訊主頁，瞭解是否有已知服務中斷情形。
409 並行更新錯誤。

嘗試更新正在更新的物件。舉例來說，購買交易同時透過呼叫 Play 帳款服務程式庫的 acknowledgePurchase() 方法和 Play Developer API 的 purchases.products.acknowledge 進行確認。

 重試要求。