REST Resource: externaltransactions

• 資源：ExternalTransaction
  • JSON 表示法
• ExternalTransactionTestPurchase
• OneTimeExternalTransaction
  • JSON 表示法
• RecurringExternalTransaction
  • JSON 表示法
• ExternalTransactionProgram
• ExternalSubscription
  • JSON 表示法
• SubscriptionType
• OtherRecurringProduct
• TransactionState
• ExternalTransactionAddress
  • JSON 表示法
• ExternalOfferDetails
  • JSON 表示法
• ExternalOfferLinkType
• ExternalOfferAppCategory
• 方法

資源：ExternalTransaction

外部交易的詳細資料。

JSON 表示法

{ "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, // 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. // Union field program_details can be only one of the following: "externalOfferDetails": { object (ExternalOfferDetails) } // End of list of possible types for union field program_details. }

欄位
packageName	string 僅供輸出。外部交易的資源名稱。售出應用程式內商品的應用程式套件名稱 (例如「com.some.app」)。
externalTransactionId	string 僅供輸出。這筆交易的 ID。同一套件名稱下的所有交易 ID 不得重複。建立外部交易時設定。
originalPreTaxAmount	object (Price) 必填。原始交易金額 (不含稅金)。這代表原始通知 Google 的稅前金額，不含任何退款。
originalTaxAmount	object (Price) 必填。原始稅額。這代表 Google 原先通知的稅額，不含任何退款。
currentPreTaxAmount	object (Price) 僅供輸出。目前交易的稅前金額。這是目前的稅前金額，包括可能已套用至這筆交易的任何退款。
currentTaxAmount	object (Price) 僅供輸出。目前的稅額。這代表目前的稅額，包括可能已套用至這筆交易的任何退款。
testPurchase	object (ExternalTransactionTestPurchase) 僅供輸出。如果已設定，這筆交易就是測試購買。Google 不會針對測試交易收費。
transactionTime	string (Timestamp format) 必填。交易完成的時間。 使用 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"。
createTime	string (Timestamp format) 僅供輸出。這筆交易的建立時間。這是 Google 收到交易通知的時間。 使用 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"。
transactionState	enum (TransactionState) 僅供輸出。交易目前的狀態。
userTaxAddress	object (ExternalTransactionAddress) 必填。用於計算稅金的使用者地址。
transactionProgramCode	integer 選用。交易計畫代碼，用於判斷參與合作夥伴計畫的合格應用程式服務費。加入 Play 媒體體驗計畫 (https://play.google.com/console/about/programs/mediaprogram/) 的開發人員回報其他結帳系統交易時，必須提供計畫代碼。如果您是符合資格的開發人員，請與商務拓展經理聯絡，進一步瞭解如何設定這個欄位。注意：這個欄位無法用於外部優惠交易。
聯集欄位 transaction_type。執行的交易類型。transaction_type 只能是下列其中一項：
oneTimeTransaction	object (OneTimeExternalTransaction) 這是一次性交易，不屬於訂閱項目。
recurringTransaction	object (RecurringExternalTransaction) 這筆交易屬於週期性交易系列。
聯集欄位 program_details。交易回報所需的方案特定詳細資料。詳細資料只能針對與交易相關聯的計畫設定。program_details 只能是下列其中一項：
externalOfferDetails	object (ExternalOfferDetails) 選用。準確回報外部優惠交易的必要詳細資料。

ExternalTransactionTestPurchase

這個類型沒有任何欄位。

代表使用測試帳戶執行的交易。Google 不會收取這類交易的費用。

OneTimeExternalTransaction

代表一次性交易。

JSON 表示法
{ "externalTransactionToken": string }

欄位
externalTransactionToken	string 僅限輸入。在呼叫 Create 時提供。啟動其他結帳系統流程時，從用戶端擷取。

RecurringExternalTransaction

代表週期性付款系列中的一筆交易。這可能是訂閱項目，也可能是需要多次付款的一次性產品 (例如預購)。

JSON 表示法

{ // 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. }

欄位
聯集欄位 source。 source 只能是下列其中一個設定：
initialExternalTransactionId	string 這筆週期性交易系列的第一筆交易外部交易 ID。舉例來說，如果是訂閱項目，這就是第一筆付款的交易 ID。建立週期性外部交易時必須提供。
externalTransactionToken	string 僅限輸入。在呼叫 Create 時提供。啟動其他結帳系統流程時，從用戶端擷取。僅限首次購買時填寫。
migratedTransactionProgram	enum (ExternalTransactionProgram) 僅限輸入。在呼叫 Create 時提供。只能用於將訂閱項目從手動月度回報遷移至自動回報。
聯集欄位 product_details。必填。定期外部交易中的產品詳細資料。product_details 只能是下列其中一項：
externalSubscription	object (ExternalSubscription) 外部訂閱方案的詳細資料。
otherRecurringProduct	object (OtherRecurringProduct) 不屬於任何其他特定類別的週期性外部交易產品詳細資料。

ExternalTransactionProgram

代表使用者完成交易時所參與的外部交易計畫。

列舉
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED	未指定交易計畫。未使用。
USER_CHOICE_BILLING	使用者自選結帳系統：使用者可選擇 Google Play 帳款服務或開發人員管理的結帳系統。
ALTERNATIVE_BILLING_ONLY	僅限其他帳單系統，使用者只能使用開發人員管理員帳單。

ExternalSubscription

外部訂閱方案的詳細資料。

JSON 表示法
{ "subscriptionType": enum (SubscriptionType) }

欄位
subscriptionType	enum (SubscriptionType) 必填。外部訂閱方案類型。

SubscriptionType

外部訂閱的類型。

列舉
SUBSCRIPTION_TYPE_UNSPECIFIED	未指定，請勿使用。
RECURRING	這是週期性訂閱方案，系統會在每個帳單週期向使用者收費。
PREPAID	這是預付型訂閱方案，使用者會預先付款。

OtherRecurringProduct

這個類型沒有任何欄位。

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

TransactionState

交易的狀態。

列舉
TRANSACTION_STATE_UNSPECIFIED	未指定交易狀態。未使用。
TRANSACTION_REPORTED	Google 已收到這筆交易的檢舉。
TRANSACTION_CANCELED	交易已全額退款。

ExternalTransactionAddress

使用者外部交易的地址。

JSON 表示法
{ "regionCode": string, "administrativeArea": string }

欄位
regionCode	string 必填。根據 ISO-3166-1 Alpha-2 (聯合國區域代碼) 的雙字母區域代碼。
administrativeArea	string 選用。國家/地區的最上層行政區劃分。僅適用於在印度進行的交易。有效值包括「ANDAMAN AND NICOBAR ISLANDS」、「ANDHRA PRADESH」、「ARUNACHAL PRADESH」、「ASSAM」、「BIHAR」、「CHANDIGARH」、「CHHATTISGARH」、「DADRA AND NAGAR HAVELI」、「DADRA AND NAGAR HAVELI AND DAMAN AND DIU」、「DAMAN AND DIU」、「DELHI」、「GOA」、「GUJARAT」、「HARYANA」、「HIMACHAL PRADESH」、「JAMMU AND KASHMIR」、「JHARKHAND」、「KARNATAKA」、「KERALA」、「LADAKH」、「LAKSHADWEEP」、「MADHYA PRADESH」、「MAHARASHTRA」、「MANIPUR」、「MEGHALAYA」、「MIZORAM」、「NAGALAND」、「ODISHA」、「PUDUCHERRY」、「PUNJAB」、「RAJASTHAN」、「SIKKIM」、「TAMIL NADU」、「TELANGANA」、「TRIPURA」、「UTTAR PRADESH」、「UTTARAKHAND」和「WEST BENGAL」。

ExternalOfferDetails

外部優惠計畫專屬的報表詳細資料。

JSON 表示法
{ "linkType": enum (ExternalOfferLinkType), "installedAppPackage": string, "installedAppCategory": enum (ExternalOfferAppCategory), "appDownloadEventExternalTransactionId": string }

欄位
linkType	enum (ExternalOfferLinkType) 選用。這筆交易檢舉的內容類型。回報透過 Google Play 安裝的應用程式下載次數或應用程式內購買的數位內容時，必須提供這項資訊。
installedAppPackage	string 選用。透過這筆交易下載的應用程式套件名稱。如果 linkType 為 LINK_TO_APP_DOWNLOAD，則為必填欄位。
installedAppCategory	enum (ExternalOfferAppCategory) 選用。透過這筆交易下載的應用程式類別。這必須與外部應用程式驗證程序期間在 Play 管理中心提供的類別相符。僅適用於應用程式下載。
appDownloadEventExternalTransactionId	string 選用。透過外部連結與應用程式下載事件相關聯的外部交易 ID。回報在外部安裝應用程式中進行的交易時，此為必填屬性。

ExternalOfferLinkType

外部連結類型。

列舉
EXTERNAL_OFFER_LINK_TYPE_UNSPECIFIED	未指定，請勿使用。
LINK_TO_DIGITAL_CONTENT_OFFER	購買數位內容的優惠。
LINK_TO_APP_DOWNLOAD	應用程式安裝。

ExternalOfferAppCategory

下載的應用程式類別。如要進一步瞭解應用程式類別，請參閱 https://support.google.com/googleplay/android-developer/answer/9859673。

列舉
EXTERNAL_OFFER_APP_CATEGORY_UNSPECIFIED	未指定，請勿使用。
APP	應用程式會歸類在應用程式類別下。
GAME	應用程式歸類在遊戲類別。

方法
createexternaltransaction	建立新的外部交易。
getexternaltransaction	取得現有的外部交易。
refundexternaltransaction	退款或部分退款現有的外部交易。

錯誤代碼

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

錯誤代碼	原因	說明	解析度