新功能：Steamworks 銷售資料 API

1660121

https://steamcommunity.com/group ... /532096678169150062
隆重推出透過程式存取遊戲的收益、單位和其它資料的功能。

我們很興奮地宣佈我們推出了一個全新工具，這能讓開發者更輕易地存取 Steamworks：財務服務 API 中的銷售資料。 開發者可以呼叫此 API 並透過程式取得收益和產品單位的資料，無須再透過網頁瀏覽器登入我們的銷售資料網站。

全新銷售資料 API

IPartnerFinancialsService 是一個簡單的全新 API，它的功能正如所想一般很單純：取得所有關於收益、產品單位、序號啟用、組合包和遊戲內交易的有用資料。
其中包含所有先前能於可下載 CSV 檔中可見的資料，並亦包含一些額外資料。

要使用此 API，Steamworks 管理員帳戶必須前往管理群組頁面來產生新的財務服務 WebAPI 金鑰。

我們還希望提及兩個重大細節：

• 新的這個 API 呼叫需要一種獨特的 WebAPI 金鑰，這僅能用於取得銷售資料。 換句話說， 若之前有用於遊戲內銷售之類的 WebAPI 金鑰，並無法用它來呼叫 GetDetailedSales。 相同地，財務 WebAPI 群組並不包含任何使用者或應用程式，所以它無法用於進行小額交易或檢查特定遊戲的 DLC 所有權等操作。
• 透過程式存取 API 金鑰代表使用者不需要登入 Steam 帳戶，只需使用 API 金鑰即可。 因此 API 金鑰的安全非常重要。 我們提供了額外的安全功能——建立 IP 位址的允許名單以提供 API 存取權。但就算使用此功能，也不應該透過電子郵件、聊天訊息等方式分享 API 金鑰。在準備好了解技術詳情並開始使用時，請查看此處的文獻。
  
  

如何使用這個全新的 API？

我們嘗試為各式各樣使用 Steam 的開發者打造有價值的工具。 新的銷售資料 API 能提供一些協助識別模式和未來折扣決策所需資訊的機會，像是：

• 將遊戲出售所使用的各個商店和平台的銷售資料匯出至自己的主控台或表格中
• 比較不同折扣之間的每日收益，這可能會在考慮折扣百分比與時間時非常有幫助
  
  

• 不用在網頁瀏覽器中開啟各分頁互相比較，即可檢視如退款或地區性細項等相關詳情
  
  

除了讓現有的資料更容易存取之外，此 API 也會提供一些先前無法獲得的新資料：透過申請取得的序號啟用報告。開發者一直以來都能透過登入 Steamworks Sales & Activations（銷售與啟用）網站來查詢依標籤和國家 / 地區分組的 Steam 序號啟用資料。 許多開發者要求我們為此資料提供更多相關細節：可將申請來源與啟用之序號關聯起來的功能。 每個批次的序號都有獨特的數字 ID，現在 GetDetailedSales 呼叫將在輸出中包含新的「key_request_id」。

例如在幾個月的時間內，開發者可能申請兩個批次，各 1000 個序號且具有「零售商 A」的標籤。 以前開發者只能看到具有該標籤的序號在某段時間內依國家 / 地區分組的啟用數量。 GetDetailedSales 提供序號的申請 ID 並附帶啟用資訊，如此就可分別追蹤所申請的兩個批次。

此功能和其它近期推出的 Steamworks 更新與改良有什麼關聯？

我們持續在努力改善並擴展 Steam 為遊戲開發者提供的各種工具。 許多此類工具的目的是簡化並綜合資料。 儘管開發者總是能從 Steamworks 的不同網站和頁面擷取零散的資訊，或是匯入自己的主控台，但是並非所有遊戲工作室都有時間和資源來這麼做，而我們認為這也會讓那些有資源這麼做的工作室能更輕易地達成目的。

若對全新的銷售資料 API 有任何意見回饋，或是希望我們能優先處理什麼問題，請與我們聯絡！

Steam 團隊