Method: purchases.subscriptions.acknowledge

確認訂閱交易。

HTTP 要求

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:acknowledge

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
packageName

string

購買這項訂閱項目的應用程式套件名稱 (例如「com.some.thing」)。
subscriptionId

string

注意：自 2025 年 5 月 21 日起，系統不再要求提供 subscriptionId，也不建議為加購項目使用 subscriptionId。所購買訂閱項目的 ID (例如「monthly001」)。
token

string

購買訂閱項目時提供給使用者裝置的權杖。

要求主體

要求主體會包含結構如下的資料：

JSON 表示法 
{
  "developerPayload": string,
  "externalAccountIds": {
    object (ExternalAccountIds)
  }
}
欄位
developerPayload

string

要附加至購買交易的酬載。
externalAccountIds

object (ExternalAccountIds)

(選用步驟) 應用程式中的使用者帳戶 ID。

回應主體

如果成功，回應主體會留白。

範例

以下是要求範例：

curl -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptions/monthly_premium_001/tokens/abcDEF123ghiJKL456mnoPQR789:acknowledge' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "developerPayload": "AppSpecificInfo-UserID-12345"
  }'

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/androidpublisher

ExternalAccountIds

應用程式中的使用者帳戶 ID。

JSON 表示法 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string
}
欄位
obfuscatedAccountId

string

(選用步驟) 指定經模糊處理的選用字串，只與應用程式中購買者的使用者帳戶有關。

如果傳遞此值，Google Play 可以利用此值來偵測異常活動。請勿使用這個欄位儲存任何個人識別資訊 (PII)，例如明文形式的電子郵件地址。如果嘗試在這個欄位中儲存 PII，系統會封鎖購買交易。Google Play 建議您使用加密或單向雜湊，產生混淆處理的 ID 並傳送至 Google Play。

這個 ID 的長度不得超過 64 個字元。

這個欄位只能針對重新訂閱交易設定。如要為透過標準應用程式內結帳流程進行的交易設定這個欄位，請參閱 https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid。
obfuscatedProfileId

string

(選用步驟) 指定經模糊處理的選用字串，只與應用程式中購買者的使用者設定檔有關。

如果傳遞此值，Google Play 可以利用此值來偵測異常活動。請勿使用這個欄位儲存任何個人識別資訊 (PII)，例如明文形式的電子郵件地址。如果嘗試在這個欄位中儲存 PII，系統會封鎖購買交易。Google Play 建議您使用加密或單向雜湊，產生混淆處理的 ID 並傳送至 Google Play。

這個 ID 的長度不得超過 64 個字元。

這個欄位只能針對重新訂閱交易設定。如要為透過標準應用程式內結帳流程進行的交易設定這個欄位，請參閱 https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid。