Method: purchases.subscriptionsv2.revoke

subscriptionsv2.отменить покупку подписки для пользователя.

HTTP-запрос

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:revoke

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

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

Параметры
packageName

string

Обязательно. Пакет приложения, для которого была приобретена данная подписка (например, 'com.some.thing').

token

string

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

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

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

JSON-представление 
{
  "revocationContext": {
    object (RevocationContext)
  }
}
Поля
revocationContext

object ( RevocationContext )

Обязательно. Дополнительные сведения об отзыве подписки.

Тело ответа

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

Образец

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

curl -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptionsv2/tokens/sample_purchase_token:revoke' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "revocationContext": {
      "proratedRefund": {}
    }
  }'

Области действия авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/androidpublisher

ОтзывКонтекст

Контекст отзыва API purchases.subscriptionsv2.revoke.

JSON-представление 
{

  // Union field RefundType can be only one of the following:
  "fullRefund": {
    object (FullRefund)
  },
  "proratedRefund": {
    object (ProratedRefund)
  },
  "itemBasedRefund": {
    object (ItemBasedRefund)
  }
  // End of list of possible types for union field RefundType.
}
Поля
Поле объединения RefundType . Определяет тип возврата, который должен быть предоставлен. Тип возврата должен быть указан как часть допустимого запроса. RefundType может быть только одним из следующих:
fullRefund

object ( FullRefund )

Необязательно. Используется, когда пользователям необходимо вернуть полную сумму последнего платежа по каждому пункту подписки.

proratedRefund

object ( ProratedRefund )

Необязательно. Используется, когда пользователям следует вернуть пропорциональную сумму, уплаченную ими за подписку, в зависимости от оставшегося времени подписки.

itemBasedRefund

object ( ItemBasedRefund )

Необязательно. Используется, когда необходимо вернуть определенную позицию в подписке с дополнительными позициями.

ПолныйВозврат

Этот тип не имеет полей.

Используется для определения, является ли тип возврата в RevocationContext полным возвратом.

ПропорциональныйВозврат

Этот тип не имеет полей.

Используется для определения, является ли тип возврата в RevocationContext пропорциональным возвратом.

Возврат на основе товара

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

JSON-представление 
{
  "productId": string
}
Поля
productId

string

Обязательно. Если подписка является подпиской с дополнениями, идентификатор продукта подписки, который необходимо отменить.