Google Play Voided Purchases API 提供一份訂單清單 與使用者作廢的購買交易有關您可以運用 執行撤銷系統,防止使用者 存取這些訂單中的產品
這個 API 適用於一次性應用程式內訂單和應用程式訂閱項目。
購買交易的作廢方式如下:
- 使用者申請退回訂單款項。
- 使用者取消訂單。
- 訂單遭到交易退單。
開發人員取消訂單或申請退回訂單款項。
Google 取消訂單或申請退回訂單款項。
有了 API,您就能為應用程式的所有使用者打造更平衡公平的環境,特別是遊戲應用程式。
取得存取權限
如要使用 Voided Purchases API,你必須具備查看該 API 的權限 財務資訊。您透過 OAuth 用戶端或 新建立的服務帳戶如果您使用服務帳戶,請啟用 [查看財務資料] 報表」授予此帳戶的權限。
如要進一步瞭解如何取得授權的 Google Play Developer API 存取權,請參閱 下列指南:
查看作廢的購買行為
請使用 GET
方法要求作廢的購買交易清單。在你的要求中
加入應用程式的完整套件名稱,例如
com.google.android.apps.maps
:以及
在獲得 API 存取權時收到的邀請。
GET https://www.googleapis.com/androidpublisher/v3/applications/ your_package_name/purchases/voidedpurchases?access_token=your_auth_token
您也可以在要求中加入下列參數, 選用:
- startTime
最早自 Unix 紀元以來的時間 (以毫秒為單位), 您希望在回應中顯示的購買交易。根據預設
startTime
設為 30 天前的設定。這個 API 只會顯示過去發生作廢的交易 30 天。無論先前作廢的交易為何,回覆中都不會包含這類交易 你提供的
startTime
值。- endTime
最近一次擷取自 Unix 紀元以來的時間 (以毫秒為單位), 根據預設 將
endTime
設為目前時間。- maxResults
- 每則回覆中的作廢交易數量上限。變更者: 預設值為 1000。請注意,這個參數的最大值是 同樣是 1000
- token
- 來自先前回應的接續權杖,可讓您查看更多資訊 也就是預測結果
- 類型
每則回覆中的作廢交易類型。如果設為 0 系統只會傳回作廢的應用程式內購交易。如果設為 1,系統就會作廢 購買和作廢的訂閱交易將退回。預設值為 0.
- includeQuantityBasedPartialRefund
是否納入作廢交易時,根據數量的部分退款; 這只適用於多件購買交易如果是
true
, 其他作廢的交易可能會透過voidedQuantity
退回 ,表示依數量計算的部分退款金額。 預設值為false
。
回應是包含作廢交易清單的 JSON 字串。如果有
的結果數量超過 maxResults
要求參數中指定的數字
,回應中包含 nextPageToken
值,您可以將其傳入
查看更多結果。清單中的第一個結果會顯示
最久失效的購買交易
{ "tokenPagination": { "nextPageToken": "next_page_token" }, "voidedPurchases": [ { "kind": "androidpublisher#voidedPurchase", "purchaseToken": "some_purchase_token", "purchaseTimeMillis": "1468825200000", "voidedTimeMillis": "1469430000000", "orderId": "some_order_id", "voidedSource": "0", "voidedReason": "4" }, { "kind": "androidpublisher#voidedPurchase", "purchaseToken": "some_other_purchase_token", "purchaseTimeMillis": "1468825100000", "voidedTimeMillis": "1470034800000", "orderId": "some_other_order_id", "voidedSource": "2", "voidedReason": "5" }, ] }
配額
Voided Purchases API 針對個別套件設定下列配額:
- 每日 6000 次查詢。(一天的開始和結束時間為太平洋時間午夜)。
- 在任一 30 秒期間內執行 30 次查詢。
初始要求指南
在最初的 API 要求期間,您可能會想擷取 雖然這個程序不太可能用盡,但還是有可能用盡每日配額。目的地: 以更加安全且一致的方式取得作廢的購物資料,請遵循下列 最佳做法:
- 使用
maxResults
參數的預設值。這樣一來,如果您使用 一天整天的查詢配額,您可以擷取 6,000,000 個 交易作廢。 - 如果回應包含
nextPageToken
的值,請將這個值指派給該token
參數。
最佳做法
在應用程式中使用這個 API 時,請留意 而且沒有任何一種解決方案 設計撤銷授權時,請務必考量使用者的需求 政策和策略並採用下列建議做法:
- 運用這個 API 做為全方位策略中的多項元素 非預期行為一般來說,撤銷應用程式內商品的存取權通常更有效 搭配應用程式內購買,而且價格合理 勸阻不當行為的應用程式設計,這類忠實的使用者群 企業文化拒絕這類行為,以及迅速且高效率的使用者支援 頻道。
- 請統一管理撤銷政策,確保所有使用者都能享有公平的體驗。
- 考慮建立階段性政策來解決不想要的行為。適用對象 比如,先從應用程式內發出早期違規警告,再提報 導致系統持續回應不恰當的行為。萬不得已的情況下, 讓使用者完全無法與應用程式互動
- 導入撤銷政策時,每次更新政策時,請使用 應用程式的推廣管道,通知使用者相關異動。為使用者提供 在變更對應用程式生效前,事先瞭解有哪些變更。
- 請在您採取行動 (例如: 撤銷他們對應用程式內商品的存取權。理想情況下 對決策提出爭議,因此這類爭議應獲得公正的處理。
- 監控意見回饋表單和社群論壇,瞭解使用者開啟內容的原因 或他們如何做出這類行為針對以下項目採取行動 將深入分析結果視為第一道防線