Method: purchases.subscriptions.cancel

Отменяет покупку подписки пользователем. Подписка остаётся действительной до истечения срока её действия. Новая версия доступна по адресу purchases.subscriptionsv2.cancel для лучшей поддержки клиентской библиотеки.

HTTP-запрос

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

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

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

Параметры
packageName

string

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

subscriptionId

string

Примечание: с 21 мая 2025 года идентификатор подписки не требуется и не рекомендуется для подписок с дополнениями. Идентификатор приобретённой подписки (например, «monthly001»).

token

string

Токен, предоставленный устройству пользователя при покупке подписки.

Текст запроса

Тело запроса содержит данные со следующей структурой:

JSON-представление 
{
  "cancellationType": enum (CancellationType)
}
Поля
cancellationType

enum ( CancellationType )

Необязательно. Тип отмены приобретённой подписки. Обратите внимание, что это поле поддерживается только в HTTP-запросе. Оно недоступно в клиентских библиотеках. Пользователи клиентских библиотек могут использовать вместо него purchases.subscriptionsv2.cancel.

Тело ответа

В случае успеха тело ответа пустое.

Образец

Ниже приведен пример запроса:

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 . Это поведение по умолчанию, если тип отмены не указан.