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,
  "externalAccountIds": {
    object (ExternalAccountIds)
  }
}
字段
developerPayload

string

附加到购买交易的载荷。
externalAccountIds

object (ExternalAccountIds)

可选。应用中的用户账号标识符。

响应正文

如果成功，则响应正文为空。

示例

以下是一个示例请求：

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

应用中的用户账号标识符。

JSON 表示法 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string
}
字段
obfuscatedAccountId

string

可选。指定一个可选的混淆字符串，该字符串与购买者在您应用中的用户账号唯一关联。

如果您传递此值，Google Play 可以使用它来检测不正常的活动。请勿使用此字段存储任何个人身份信息 (PII)，例如明文电子邮件地址。尝试在此字段中存储 PII 会导致购买交易被阻止。Google Play 建议您使用加密或单向哈希来生成混淆的标识符，然后将其发送给 Google Play。

此标识符的长度不得超过 64 个字符。

此字段只能针对重新订阅购买交易进行设置。如需为使用标准应用内购结算流程完成的购买设置此字段，请参阅 https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid。
obfuscatedProfileId

string

可选。指定一个可选的混淆字符串，该字符串与购买者在您应用中的用户个人资料唯一关联。

如果您传递此值，Google Play 可以使用它来检测不正常的活动。请勿使用此字段存储任何个人身份信息 (PII)，例如明文电子邮件地址。尝试在此字段中存储 PII 会导致购买交易被阻止。Google Play 建议您使用加密或单向哈希来生成混淆的标识符，然后将其发送给 Google Play。

此标识符的长度不得超过 64 个字符。

此字段只能针对重新订阅购买交易进行设置。如需为按照标准应用内购结算流程完成的购买设置此字段，请参阅 https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid。