Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates

Обновляет пакет статусов предложений, относящихся к контенту для однократных покупок.

HTTP-запрос

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdateStates

URL имеет синтаксис gRPC Transcoding.

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

Параметры
packageName

string

Обязательно. Родительское приложение (название пакета) обновленных предложений контента для однократных покупок.

productId

string

Обязательно. Идентификатор товара родительского контента для однократных покупок, если все обновленные предложения относятся к одному и тому же контенту для однократных покупок. Если пакетное обновление охватывает несколько товаров, оплачиваемых однократно, укажите в этом поле "-".

purchaseOptionId

string

Обязательно. Идентификатор основного способа покупки, если все обновленные предложения относятся к одному способу покупки. Если пакетное обновление охватывает несколько вариантов покупки, задайте для этого поля значение "-".

Тело запроса

Ниже приведена структура данных в теле запроса.

JSON-представление
{
  "requests": [
    {
      object (UpdateOneTimeProductOfferStateRequest)
    }
  ]
}
Поля
requests[]

object (UpdateOneTimeProductOfferStateRequest)

Обязательно. Список запросов на обновление, содержащий до 100 элементов. Все запросы должны обновлять разные предложения.

Тело ответа

Сообщение ответа для offers.batchUpdateStates.

Ниже приведена структура данных в ответе, полученном на запрос.

JSON-представление
{
  "oneTimeProductOffers": [
    {
      object (OneTimeProductOffer)
    }
  ]
}
Поля
oneTimeProductOffers[]

object (OneTimeProductOffer)

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

Области авторизации

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

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

UpdateOneTimeProductOfferStateRequest

Сообщение с запросом на обновление статуса предложения, относящегося к контенту для однократных покупок.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "activateOneTimeProductOfferRequest": {
    object (ActivateOneTimeProductOfferRequest)
  },
  "cancelOneTimeProductOfferRequest": {
    object (CancelOneTimeProductOfferRequest)
  },
  "deactivateOneTimeProductOfferRequest": {
    object (DeactivateOneTimeProductOfferRequest)
  }
  // End of mutually exclusive fields.
}
Поля
Тип перехода, который нужно применить. Необходимо указать только один. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей:
activateOneTimeProductOfferRequest

object (ActivateOneTimeProductOfferRequest)

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

cancelOneTimeProductOfferRequest

object (CancelOneTimeProductOfferRequest)

Отменяет предложение. После отмены предложение станет недоступно пользователям. Все ожидающие заказы, связанные с этим предложением, будут отменены. Этот переход статуса относится только к предзаказам.

deactivateOneTimeProductOfferRequest

object (DeactivateOneTimeProductOfferRequest)

Деактивирует специальное предложение. После этого оно станет недоступно пользователям. Этот переход статуса относится только к специальным предложениям со скидками и игровыми наградами.

Конец взаимоисключающих полей.

CancelOneTimeProductOfferRequest

Сообщение с запросом для offers.cancel.

JSON-представление
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Поля
packageName

string

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

productId

string

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

purchaseOptionId

string

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

offerId

string

Обязательно. Идентификатор предложения, которое нужно отменить.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

Необязательное поле. Допустимая задержка при распространении этого обновления. По умолчанию используется latency-sensitive.

DeactivateOneTimeProductOfferRequest

Сообщение запроса для offers.deactivate.

JSON-представление
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Поля
packageName

string

Обязательно. Название пакета родительского приложения, для которого нужно деактивировать специальное предложение.

productId

string

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

purchaseOptionId

string

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

offerId

string

Обязательно. Идентификатор предложения, которое нужно деактивировать.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

Необязательное поле. Допустимая задержка при распространении этого обновления. По умолчанию используется latency-sensitive.