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