REST Resource: externaltransactions

{
  "packageName": string,
  "externalTransactionId": string,
  "originalPreTaxAmount": {
    object (Price)
  },
  "originalTaxAmount": {
    object (Price)
  },
  "currentPreTaxAmount": {
    object (Price)
  },
  "currentTaxAmount": {
    object (Price)
  },
  "testPurchase": {
    object (ExternalTransactionTestPurchase)
  },
  "transactionTime": string,
  "createTime": string,
  "transactionState": enum (TransactionState),
  "userTaxAddress": {
    object (ExternalTransactionAddress)
  },
  "transactionProgramCode": integer,
  "externalOfferInitialAcquisitionDetails": {
    object (ExternalOfferInitialAcquisitionDetails)
  },

  // Union field transaction_type can be only one of the following:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of list of possible types for union field transaction_type.
}

string

僅供輸出。外部交易的資源名稱。售出應用程式內商品的應用程式套件名稱 (例如「com.some.app」)。

string

僅供輸出。這筆交易的 ID。同一個套件名稱下的所有交易 ID 均不得重複。在建立外部交易時設定。

object (Price)

必要欄位。稅前的原始交易金額。這是指最初通知 Google 之前通知的稅前金額。

object (Price)

必要欄位。原始稅額。這是指最初通知 Google 之前通知的稅額。

object (Price)

僅供輸出。目前稅前的交易金額。這代表目前的稅前金額，包括任何已計入這筆交易的退款。

object (Price)

僅供輸出。目前的稅額。這是目前的稅額，包括任何已計入這筆交易的退款。

object (ExternalTransactionTestPurchase)

僅供輸出。若設有此設定，表示此交易為測試購買。Google 不會針對測試交易收費。

string (Timestamp format)

必要欄位。交易完成的時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

僅供輸出。建立這筆交易的時間。這是 Google 收到交易通知的時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

enum (TransactionState)

僅供輸出。交易目前的狀態。

object (ExternalTransactionAddress)

必要欄位。用於稅務計算的使用者地址。

integer

選用設定。針對加入合作夥伴計畫的合格應用程式，系統會根據交易代碼判定服務費。如果開發人員參與 Play 媒體體驗計畫 (https://play.google.com/console/about/programs/mediaprogram/)，開發人員必須在回報其他結帳系統交易時提供該計畫程式碼。如果您是符合資格的開發人員，請與 BDM 聯絡，進一步瞭解如何設定這個欄位。注意：這個欄位無法用於外部優惠交易。

object (ExternalOfferInitialAcquisitionDetails)

選用設定。有關使用者/裝置首次使用外部優惠完成交易的詳細資料。如果只透過使用者自選結帳系統或其他結帳系統進行交易，則不必填寫這個欄位。

object (OneTimeExternalTransaction)

這是一次性交易，不屬於訂閱項目。

object (RecurringExternalTransaction)

這筆交易屬於週期性交易的一部分。

{
  "externalTransactionToken": string
}

string

僅限輸入。在呼叫建立期間提供。在其他結帳流程啟動時從用戶端擷取。

{

  // Union field source can be only one of the following:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of list of possible types for union field source.

  // Union field product_details can be only one of the following:
  "externalSubscription": {
    object (ExternalSubscription)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // End of list of possible types for union field product_details.
}

string

此週期性週期性交易第一筆交易的外部交易 ID。舉例來說，如果是訂閱項目，這會是第一筆付款的交易 ID。建立週期性外部交易時為必要項目。

string

僅限輸入。在呼叫建立期間提供。在其他結帳流程啟動時從用戶端擷取。只有初次購買時才需要填寫。

enum (ExternalTransactionProgram)

僅限輸入。在呼叫建立期間提供。只有在將訂閱項目從手動報表遷移至自動報表時才能使用。

object (ExternalSubscription)

外部訂閱項目的詳細資料。

object (OtherRecurringProduct)

不屬於任何其他特定類別的週期性外部交易產品詳細資料。

{
  "subscriptionType": enum (SubscriptionType)
}

enum (SubscriptionType)

必要欄位。外部訂閱項目的類型，

{
  "regionCode": string,
  "administrativeArea": string
}

string

必要欄位。以 ISO-3166-1 Alpha-2 (聯合國區碼) 為基礎的雙字母區碼。

string

選用設定。國家/地區的頂層行政劃分。只有在印度進行交易才需要。有效值包括「ANDAMAN 和 尼拉尼、尼爾文、尼爾文

{
  "externalTransactionId": string
}

string

必要欄位。使用者初次完成購買的外部交易 ID。