Method: purchases.subscriptions.acknowledge

Подтверждает покупку подписки.

HTTP-запрос

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

URL использует синтаксис перекодировки gRPC .

Параметры пути

Параметры
packageName

string

Название пакета приложения, для которого была приобретена данная подписка (например, «com.some.thing»).

subscriptionId

string

Примечание: с 21 мая 2025 года идентификатор подписки не требуется и не рекомендуется для подписок с дополнениями. Идентификатор приобретённой подписки (например, «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

Внешние идентификаторы счетов

Идентификатор учетной записи пользователя в вашем приложении.

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 .