Google Play 結(jié)算系統(tǒng)：做好準(zhǔn)備

本主題列出并說明了在您的應(yīng)用中銷售商品之前需要執(zhí)行的設(shè)置步驟。大體上講，此設(shè)置包括創(chuàng)建開發(fā)者帳號(hào)、創(chuàng)建和配置要銷售的商品，以及啟用和配置用于銷售和管理商品的API。此外，本主題還介紹了如何配置實(shí)時(shí)開發(fā)者通知，以便在商品的狀態(tài)發(fā)生變化時(shí)隨時(shí)收到通知。

設(shè)置Google Play開發(fā)者帳號(hào)

如需在Google Play上發(fā)布您的應(yīng)用和游戲，請(qǐng)使用Google Play管理中心。您還可以使用Google Play管理中心管理與結(jié)算相關(guān)的商品和設(shè)置。

如需訪問Google Play管理中心，您需要設(shè)置Google Play開發(fā)者帳號(hào)。

如需在Google Play上銷售付費(fèi)應(yīng)用和應(yīng)用內(nèi)購(gòu)商品，您還必須在Google付款中心設(shè)置付款資料，然后將該付款資料與您的Google Play開發(fā)者帳號(hào)相關(guān)聯(lián)。如需了解如何將您的付款資料與帳號(hào)相關(guān)聯(lián)，或者了解如何檢查您是否已有關(guān)聯(lián)的帳號(hào)和付款資料，請(qǐng)參閱將Google Play開發(fā)者帳號(hào)與您的付款資料相關(guān)聯(lián)。

在Google Play管理中心內(nèi)啟用結(jié)算相關(guān)功能

重要提示：如果您的應(yīng)用當(dāng)前使用AIDL來集成Google Play結(jié)算服務(wù)，請(qǐng)參閱從AIDL遷移到Google Play結(jié)算庫(kù)的遷移指南，大致了解從AIDL遷移到Google Play結(jié)算庫(kù)時(shí)需要執(zhí)行的步驟。

設(shè)置開發(fā)者帳號(hào)后，您必須發(fā)布包含Google Play結(jié)算庫(kù)的應(yīng)用版本。如需在Google Play管理中心啟用結(jié)算相關(guān)功能（如配置您要銷售的商品），必須執(zhí)行此步驟。

添加庫(kù)依賴項(xiàng)

如需集成Google Play結(jié)算系統(tǒng)，請(qǐng)先在您的應(yīng)用中添加對(duì)Google Play結(jié)算庫(kù)的依賴項(xiàng)。此庫(kù)可讓您訪問用于連接到Google Play的Android API。這樣，您便可以訪問購(gòu)買信息、查詢有關(guān)購(gòu)買交易的更新、提示用戶進(jìn)行新的購(gòu)買交易，等等。

Google的Maven代碼庫(kù)中提供了Google Play結(jié)算庫(kù)。將依賴項(xiàng)添加到應(yīng)用的build.gradle文件中，如下所示：

dependencies{

def billing_version="3.0.0"

implementation"com.android.billingclient:billing:$billing_version"

}

如果您使用的是Kotlin，Play結(jié)算庫(kù)KTX模塊包含了Kotlin擴(kuò)展程序和協(xié)程支持，可讓您在使用Google Play結(jié)算系統(tǒng)時(shí)編寫慣用的Kotlin代碼。如需將這些擴(kuò)展程序包含在項(xiàng)目中，請(qǐng)將以下依賴項(xiàng)添加到應(yīng)用的build.gradle文件中，如下所示：

dependencies{

def billing_version="3.0.0"

implementation"com.android.billingclient:billing-ktx:$billing_version"

}

上傳您的應(yīng)用

將該庫(kù)添加到您的應(yīng)用后，構(gòu)建并發(fā)布您的應(yīng)用。在此步驟中，創(chuàng)建您的應(yīng)用，然后將其發(fā)布到任何軌道，包括內(nèi)部測(cè)試軌道。

創(chuàng)建和配置您的商品

為您的應(yīng)用啟用Google Play結(jié)算服務(wù)功能后，您需要配置要銷售的商品。

創(chuàng)建一次性商品和訂閱的步驟相似。對(duì)于每個(gè)商品，您需要提供唯一的商品ID、商品名、說明和定價(jià)信息。訂閱具有其他必需的信息，如續(xù)訂期、您是否提供免費(fèi)試訂，以及訂閱是否有初次體驗(yàn)優(yōu)惠。

Google Play管理中心提供了一個(gè)可用于管理商品的網(wǎng)頁(yè)界面。

如需創(chuàng)建和配置一次性商品，請(qǐng)參閱創(chuàng)建受管理的商品。請(qǐng)注意，Google Play管理中心將一次性商品稱為“受管理的商品”。

如需創(chuàng)建和配置訂閱，請(qǐng)參閱創(chuàng)建訂閱。

作為網(wǎng)頁(yè)界面的替代方案，您還可以使用Google Play Developer API中的inappproducts REST資源管理商品。

配置Google Play Developer API

Google Play Developer API是一種服務(wù)器到服務(wù)器API，與Android平臺(tái)上的Google Play結(jié)算庫(kù)相輔相成。此API提供了Google Play結(jié)算庫(kù)中未提供的功能，如安全地驗(yàn)證購(gòu)買交易以及為用戶辦理退款。

在將Google Play結(jié)算系統(tǒng)集成到應(yīng)用的過程中，您必須通過Google Play管理中心配置對(duì)Google Play Developer API的訪問權(quán)限。有關(guān)說明，請(qǐng)參閱Google Play Developer API使用入門。

配置對(duì)Google Play Developer API的訪問權(quán)限后，請(qǐng)確保您已授予查看財(cái)務(wù)數(shù)據(jù)權(quán)限，需要具備此權(quán)限才能訪問與結(jié)算相關(guān)的功能。如需了解最佳做法以及有關(guān)配置權(quán)限的詳細(xì)信息，請(qǐng)參閱添加開發(fā)者帳號(hào)用戶并管理權(quán)限。

配置實(shí)時(shí)開發(fā)者通知

借助實(shí)時(shí)開發(fā)者通知(RTDN)機(jī)制，每當(dāng)用戶的權(quán)限在您的應(yīng)用中發(fā)生變化時(shí)，您都會(huì)收到來自Google的通知。RTDN利用Google Cloud Pub/Sub，該服務(wù)可讓您接收推送到您設(shè)置的網(wǎng)址或使用客戶端庫(kù)輪詢的數(shù)據(jù)。這些通知允許您立即對(duì)訂閱狀態(tài)的變化做出反應(yīng)，這樣就無(wú)需輪詢Google Play Developer API。請(qǐng)注意，如果Google Play Developer API的使用效率低下，可能會(huì)導(dǎo)致API配額限制。

Cloud Pub/Sub是一種完全托管的實(shí)時(shí)消息傳遞服務(wù)，您可以使用該服務(wù)在獨(dú)立應(yīng)用之間收發(fā)消息。Google Play使用Cloud Pub/Sub發(fā)布有關(guān)您所訂閱主題的推送通知。

為了接收通知，您需要?jiǎng)?chuàng)建后端服務(wù)器以使用發(fā)送到您主題的消息。您的服務(wù)器隨后便可以使用這些消息，方法是響應(yīng)對(duì)已注冊(cè)端點(diǎn)的HTTPS請(qǐng)求，或使用Cloud Pub/Sub客戶端庫(kù)。這些庫(kù)有多種語(yǔ)言版本。如需了解詳情，另請(qǐng)參閱本主題的創(chuàng)建Pub/Sub訂閱部分。

確定定價(jià)和配額

如需詳細(xì)了解定價(jià)和配額，請(qǐng)參閱定價(jià)和配額。

估算流量消耗

訂閱通知的流量大約為每個(gè)請(qǐng)求1KB的流量。每次發(fā)布和提取通知都需要一個(gè)單獨(dú)的請(qǐng)求，即每個(gè)通知大約2KB的流量。每月的通知數(shù)量取決于您的結(jié)算周期和用戶的行為。在一個(gè)結(jié)算周期內(nèi)，每個(gè)用戶應(yīng)至少有一個(gè)通知。

設(shè)置Cloud Pub/Sub

如需啟用實(shí)時(shí)開發(fā)者通知，您必須先使用自己的Google Cloud Platform(GCP)項(xiàng)目設(shè)置Cloud Pub/Sub，然后再為您的應(yīng)用啟用通知。

如需使用Cloud Pub/Sub，您必須擁有一個(gè)啟用了Cloud Pub/Sub API的GCP項(xiàng)目。如果您不熟悉GCP和Cloud Pub/Sub，請(qǐng)參閱快速入門指南。

注意：您必須分別為每個(gè)Android應(yīng)用配置實(shí)時(shí)開發(fā)者通知。這意味著，您可以選擇使用與用來訪問Play Developer API的GCP項(xiàng)目相同的GCP項(xiàng)目，也可以為每個(gè)應(yīng)用創(chuàng)建一個(gè)新的GCP項(xiàng)目。如果您有多個(gè)應(yīng)用，必須對(duì)Google Play Developer API使用相同的Google API控制臺(tái)項(xiàng)目，但可以對(duì)各個(gè)應(yīng)用使用不同的Google API控制臺(tái)項(xiàng)目。

例如，Classy Taxi示例應(yīng)用將實(shí)時(shí)開發(fā)者通知與Firebase Functions觸發(fā)器一起使用（示例代碼）。該Firebase項(xiàng)目關(guān)聯(lián)到的Google API控制臺(tái)項(xiàng)目不同于使用Google Play Developer API的Google API控制臺(tái)項(xiàng)目。

創(chuàng)建主題

如需開始接收通知，您必須創(chuàng)建一個(gè)主題，Google Play應(yīng)將通知發(fā)布到該主題。如需創(chuàng)建主題，請(qǐng)按照創(chuàng)建主題中的說明操作。

創(chuàng)建Pub/Sub訂閱

如需接收發(fā)布到某個(gè)主題的消息，您必須創(chuàng)建對(duì)該主題的Pub/Sub訂閱。如需創(chuàng)建Pub/Sub訂閱，請(qǐng)執(zhí)行以下操作：

閱讀Cloud Pub/Sub訂閱者指南，以確定是將訂閱配置為“推送訂閱”還是“拉取訂閱”。

推送訂閱允許Cloud Pub/Sub通過發(fā)出HTTPS請(qǐng)求向您的安全后端服務(wù)器發(fā)送通知。

拉取訂閱要求您的安全后端服務(wù)器向Cloud Pub/Sub服務(wù)器發(fā)起請(qǐng)求以檢索消息。

按照添加訂閱中的說明來創(chuàng)建訂閱。

注意：拉取訂閱通常用于在處理大量消息時(shí)優(yōu)化資源利用率，這一般不適用于RTDN。如果您不確定要從推送還是拉取入手，我們建議您使用推送，因?yàn)檫@種機(jī)制一般更容易實(shí)現(xiàn)。請(qǐng)參閱拉取或推送分發(fā)內(nèi)容，以幫助您確定推送訂閱還是拉取訂閱最適合您的應(yīng)用。

針對(duì)您的主題授予發(fā)布權(quán)限

Cloud Pub/Sub要求您向Google Play授予向您的主題發(fā)布通知的權(quán)限。

打開Google Cloud Console。

選擇您的項(xiàng)目，然后在左側(cè)導(dǎo)航欄中點(diǎn)擊Pub/Sub。

找到您的主題，然后打開權(quán)限詳細(xì)信息。

圖1.訪問主題權(quán)限的配置。

添加服務(wù)帳號(hào)google-play-developer-notifications system.gserviceaccount.com，然后授予其Pub/Sub發(fā)布商的角色。

圖2.將Google Play服務(wù)帳號(hào)添加為Pub/Sub發(fā)布商。

點(diǎn)擊保存以完成主題的設(shè)置。

圖3.配置的主題。

為您的應(yīng)用啟用實(shí)時(shí)開發(fā)者通知

如需為您的應(yīng)用啟用實(shí)時(shí)開發(fā)者通知，請(qǐng)執(zhí)行以下操作：

打開Google Play管理中心。

選擇您的應(yīng)用。

轉(zhuǎn)到獲利>獲利設(shè)置。

滾動(dòng)到頁(yè)面頂部的實(shí)時(shí)開發(fā)者通知部分。

圖4.實(shí)時(shí)開發(fā)者通知部分。

在主題名稱字段中，輸入您之前配置的完整Cloud Pub/Sub主題名稱。主題名稱應(yīng)采用projects/{project_id}/topics/{topic_name}格式，其中project_id是項(xiàng)目的唯一標(biāo)識(shí)符，topic_name是之前創(chuàng)建的主題的名稱。

點(diǎn)擊發(fā)送測(cè)試消息以發(fā)送測(cè)試消息。執(zhí)行測(cè)試發(fā)布有助于確保一切均已正確設(shè)置和配置。如果測(cè)試發(fā)布成功，則系統(tǒng)會(huì)顯示一條消息，指出測(cè)試發(fā)布已成功。如果有此主題的訂閱者，則該訂閱者應(yīng)收到測(cè)試消息。

如果發(fā)布失敗，則系統(tǒng)會(huì)顯示錯(cuò)誤。請(qǐng)確保主題名稱正確，并且google-play-developer-notifications system.gserviceaccount.com服務(wù)帳號(hào)擁有對(duì)該主題的Pub/Sub發(fā)布商訪問權(quán)限。

點(diǎn)擊保存更改。

驗(yàn)證您的配置

為了接收實(shí)時(shí)開發(fā)者通知，您應(yīng)創(chuàng)建安全的后端服務(wù)器，以使用發(fā)送到您的Cloud Pub/Sub主題的消息。

您可以使用Google Play管理中心的發(fā)送測(cè)試消息按鈕來測(cè)試您的配置，如上一部分中所述。如果您尚未配置后端服務(wù)器以使用通知，可以使用gcloud命令行工具來驗(yàn)證配置。有關(guān)使用gcloud處理消息的說明，請(qǐng)參閱從訂閱拉取消息。