Google Play Developer API

注意：從2019年12月1日起，Google Play Developer API僅適用于版本3及更高版本。如果您使用的是較低版本的API，則必須在此日期之前遷移到版本3。如需詳細了解如何遷移到版本3，請參閱Google Play Developer API的變化。

Google Play Developer API是一種基于REST的網(wǎng)絡(luò)服務(wù)，利用這種服務(wù)，您可以執(zhí)行應用發(fā)布和應用管理任務(wù)。您可以使用此API將您的發(fā)布操作與版本管理流程集成。

并不是所有的開發(fā)者都需要使用這些API-在大多數(shù)情況下，您需要繼續(xù)使用Google Play管理中心直接管理應用。不過，如果您有大量APK需要管理，或者需要跟蹤用戶的購買交易和訂閱，您可能會發(fā)現(xiàn)此API非常有用。

使用Google Play Developer API，您可以自動執(zhí)行各種應用管理任務(wù)，包括：

·上傳和發(fā)布應用的新版本

·修改應用的Google Play商店商品詳情，包括已本地化的文字和圖形

·管理您的應用內(nèi)商品清單、商品購買狀態(tài)和應用訂閱

利用Google Play Developer API，您可以集中精力設(shè)計和開發(fā)應用，同時減少版本管理的時間和工作，即使您將應用推向新市場也能如此。

Google Play Developer API包括兩個組件：

·利用Publishing API，您可以上傳和發(fā)布應用，以及執(zhí)行其他發(fā)布相關(guān)的任務(wù)。

·利用Subscriptions and In-App Purchases API，您可以管理應用內(nèi)購買和訂閱。（以前稱為“Purchase Status API”。）

Publishing API

您可以通過Google Play Developer Publishing API自動執(zhí)行與應用分發(fā)操作相關(guān)的常態(tài)任務(wù)，其中包括與Play管理中心為開發(fā)者提供的功能類似的功能，例如：

·上傳應用的新版本

·通過將APK分配至各個軌道（Alpha版、Beta版、分階段發(fā)布版本或正式版）來發(fā)布應用

·創(chuàng)建和修改Google Play商店中的商品詳情，包括已本地化的文字和圖形與多設(shè)備屏幕截圖

這些任務(wù)使用修改功能執(zhí)行，并采用事務(wù)型方式進行更改-將多項更改綁定到一個草稿修改中，然后一次性提交所有更改。（只有提交修改后，這些更改才會生效。）

注意：并不是所有開發(fā)者都需要使用此API。您也可以通過Google Play管理中心獲得此API提供的所有功能。不過，利用此API，您可以將應用和商品詳情更新流程與您現(xiàn)有的工具集成，這種功能對某些開發(fā)者來說非常實用。特別是，如果您有大量APK需要管理或者擁有多種不同語言區(qū)域的本地化商品詳情，則可能會發(fā)現(xiàn)此API非常實用。

Subscriptions and In-App Purchases API

利用此API，您可以管理應用的應用內(nèi)商品和訂閱目錄。此外，利用Subscriptions and In-App Purchases API，您還可以通過標準的GET請求快速檢索任何購買交易的詳情。在該請求中，您需要提供購買交易的相關(guān)信息：應用軟件包名稱、購買或訂閱ID及購買令牌。服務(wù)器通過JSON對象響應，此對象將說明關(guān)聯(lián)的購買交易詳情、訂單狀態(tài)、開發(fā)者載荷和其他信息。

您可以通過多種方式使用Purchase Status API，例如，使用它報告和協(xié)調(diào)各個訂單，以及驗證購買和訂閱過期。您也可以使用此API來了解已取消的訂單和確認應用內(nèi)商品是否已經(jīng)消耗，包括它們是否是先消耗然后又被取消。

注意：Subscriptions and In-App Purchases API不使用Publishing API所用的新事務(wù)型“修改”功能。Inappproducts、Purchases.products和Purchases.subscriptions資源的方法會立即生效。每個資源的API參考文檔頁面都會特別指出該資源所用的方法是否使用“修改”模式。

Purchase Status API是Google Play Developer API v.2.0的一部分，可以通過Google Developers Console獲得。

使用API

如需開始發(fā)起API調(diào)用，您需要直接從Google Play管理中心設(shè)置和管理Google Play Developer API。此API只能由您Google Play開發(fā)者帳號的所有者管理。

如需訪問API，您需要執(zhí)行以下操作：

1.設(shè)置一個新的API項目或一個現(xiàn)有的API項目

2.設(shè)置一個或多個獲得授權(quán)的客戶端，它們可以是下列兩種選擇之一：

·OAuth客戶端

·服務(wù)帳號

如需了解完整詳情，請參閱Google Play Developer API使用入門頁面。

分階段修改

利用Google Play Developer Publishing API的Edits方法，您可以準備并提交對Google Play應用的更改。在準備好更新后，只需一個操作即可將其部署。您可以進行的更改包括：

·上傳一個或多個APK

·將不同的APK分配到不同的“軌道”：Alpha版、Beta版、分階段發(fā)布版本和正式版

·為應用創(chuàng)建和修改已本地化的商品詳情

·為應用的商品詳情上傳屏幕截圖和其他圖像

分階段完成所有需要的更改后，只需一步操作即可將其全部提交。

如需了解分階段修改的完整詳情，請參閱Google Play Developer API Edits頁面。

注意：新的事務(wù)型“修改”功能只能由Publishing API使用。Subscriptions and In-App Purchases API的方法將立即生效。每個資源的API參考文檔頁面都會特別指出該資源所用的方法是否使用“修改”模式。

有效使用API

管理對Google Play Developer API的訪問有助于確保為使用它的所有應用創(chuàng)建一個高效的環(huán)境（如配額中所述）。盡管您可以為自己的應用請求較高的每日配額，我們?nèi)詮娏医ㄗh您通過以下方式盡可能減少訪問次數(shù)：

發(fā)布

·限制應用更新的次數(shù)-發(fā)布Alpha或Beta更新的頻率每天不要超過一次。（正式版應用的更新頻率應當更低。）每次更新都會消耗用戶的時間，還可能花費他們的金錢。如果您更新的頻率過于頻繁，用戶會開始忽略更新，甚至卸載產(chǎn)品。（當然，如果您的應用存在嚴重問題，則可以通過更新實施修復。）

一次性購買

·僅針對新的購買交易查詢Purchase Status API-發(fā)生購買時，您的應用會將購買令牌和其他詳情傳遞到您的后端服務(wù)器，服務(wù)器可以使用Purchase Status API驗證購買交易。

·將購買詳情緩存到您的服務(wù)器上-如果可能，請將應用內(nèi)商品和訂閱的購買詳情緩存到您的后端服務(wù)器上。如果您的應用在運行時聯(lián)系后端服務(wù)器來驗證購買交易的有效性，您的服務(wù)器可以基于緩存的詳情驗證購買交易，以便最大程度減少Purchase Status API的使用并為用戶提供盡可能快的響應（和最佳體驗）。

訂閱

·將訂閱信息存儲在您的服務(wù)器上，避免進行不必要的API調(diào)用。當您的應用需要驗證訂閱時，您應該依賴服務(wù)器上的緩存信息，而不是重復向Google發(fā)出API調(diào)用。

·在以下兩種情況下，您的安全服務(wù)器應使用Google Play Developer API獲取訂閱信息：

·您的服務(wù)器收到了之前沒有見過的新購買令牌。

·您的服務(wù)器收到一條實時開發(fā)者通知(RTDN)，該通知指明您需要使用購買令牌來獲取新的訂閱信息。

此外，還請注意以下事項：

·請勿通過定期輪詢API來獲取訂閱狀態(tài)。例如，不要每天調(diào)用API來檢查每項訂閱。

·由于您在訂閱到期或續(xù)訂時會收到RTDN，因此無需根據(jù)預定的過期時間安排API調(diào)用。

按照上面的這些指導原則操作，您的實現(xiàn)將為用戶提供絕佳的性能。

配額

對于使用Google Play Developer API的應用來說，初始免費配額被限制為每天200000次請求（每款應用）。此配額應當可以滿足發(fā)布Activity和正常的訂閱驗證需求。

如果您需要為自己的應用請求更高的配額，請使用Google Developers Console Quotas窗格中的“Request more”鏈接。