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,也不建議用於含有加購項目的訂閱項目。所購買訂閱項目的 ID (例如「monthly001」)。

token

string

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

要求主體

要求主體的資料會採用以下結構:

JSON 表示法
{
  "developerPayload": string
}
欄位
developerPayload

string

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

回應主體

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

範例

以下是要求範例:

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