- HTTP-запрос
- Параметры пути
- Текст запроса
- Тело ответа
- Области действия авторизации
- Тип отмены
- Попробуйте!
Отменяет покупку подписки пользователем. Подписка остается действительной до истечения срока ее действия.
HTTP-запрос
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:cancel
URL-адрес использует синтаксис gRPC Transcoding .
Параметры пути
Параметры | |
---|---|
packageName | Имя пакета приложения, для которого была приобретена данная подписка (например, «com.some.thing»). |
subscriptionId | Примечание: с 21 мая 2025 года subscriptionId не требуется и не рекомендуется для подписки с дополнениями. Идентификатор купленной подписки (например, «monthly001»). |
token | Токен, предоставленный устройству пользователя при покупке подписки. |
Текст запроса
Тело запроса содержит данные со следующей структурой:
JSON-представление |
---|
{
"cancellationType": enum ( |
Поля | |
---|---|
cancellationType | Необязательно. Тип отмены купленной подписки. Обратите внимание, что это поле поддерживается только в HTTP-запросе. Оно недоступно в клиентских библиотеках. |
Тело ответа
В случае успеха тело ответа пустое.
Образец
Ниже приведен пример запроса:
curl -X POST \ -H "Accept: application/json" \ "https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/purchases/subscriptions/monthly.premium.plan/tokens/EXAMPLE_TOKEN_STRING_12345:cancel"
Области действия авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/androidpublisher
Тип отмены
Тип отмены, запрошенный разработчиком.
Перечисления | |
---|---|
CANCELLATION_TYPE_UNSPECIFIED | Тип отмены не указан. |
USER_REQUESTED_STOP_RENEWALS | Отмена, запрошенная пользователем, и подписка может быть восстановлена. Это только останавливает следующее продление подписки. Для подписки в рассрочку пользователям все равно необходимо завершить период обязательств. Для получения более подробной информации о продлениях и платежах см. https://developer.android.com/google/play/billing/subscriptions#installments |
DEVELOPER_REQUESTED_STOP_PAYMENTS | Отмена запрошена разработчиком, и подписка не может быть восстановлена. Это останавливает следующий платеж по подписке. Для подписки в рассрочку пользователям не нужно будет платить следующий платеж и завершать период обязательств. Для получения более подробной информации о продлениях и платежах см. https://developer.android.com/google/play/billing/subscriptions#installments Это поведение по умолчанию, когда не указан тип отмены. |