Method: purchases.subscriptions.cancel

Устарело: используйте purchases.subscriptionsv2.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 года, subscriptionId не требуется и не рекомендуется для подписок с дополнениями. Вместо него используется идентификатор приобретенной подписки (например, '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 . Это поведение по умолчанию, если тип отмены не указан.