Пакет google.walletobjects.v1.offer

Содержание

OfferClassService

AddMessage

rpc AddMessage(OfferClassAddMessageRequest) returns (OfferClassAddMessageResponse)

Добавляет сообщение к классу offer с указанным идентификатором.

Области действия

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

  • https://www.googleapis.com/auth/wallet_object.issuer
Get

rpc Get(OfferClassGetRequest) returns (OfferClass)

Возвращает класс offer, к которому относится указанный идентификатор.

Области действия

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

  • https://www.googleapis.com/auth/wallet_object.issuer
Insert

rpc Insert(OfferClassInsertRequest) returns (OfferClass)

Добавляет класс offer с заданными идентификатором и свойствами.

Области действия

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

  • https://www.googleapis.com/auth/wallet_object.issuer
List

rpc List(OfferClassListRequest) returns (OfferClassListResponse)

Возвращает список всех классов типа offer, которые относятся к указанному идентификатору эмитента.

Области действия

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

  • https://www.googleapis.com/auth/wallet_object.issuer
Patch

rpc Patch(OfferClassPatchRequest) returns (OfferClass)

Обновляет класс offer с указанным идентификатором. Этот метод поддерживает семантику PATCH.

Области действия

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

  • https://www.googleapis.com/auth/wallet_object.issuer
Update

rpc Update(OfferClassUpdateRequest) returns (OfferClass)

Обновляет класс offer с указанным идентификатором.

Области действия

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

  • https://www.googleapis.com/auth/wallet_object.issuer

OfferObjectService

AddMessage

rpc AddMessage(OfferObjectAddMessageRequest) returns (OfferObjectAddMessageResponse)

Добавляет сообщение к объекту offer с указанным идентификатором.

Области действия

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

  • https://www.googleapis.com/auth/wallet_object.issuer
Get

rpc Get(OfferObjectGetRequest) returns (OfferObject)

Возвращает объект offer, к которому относится указанный идентификатор.

Области действия

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

  • https://www.googleapis.com/auth/wallet_object.issuer
Insert

rpc Insert(OfferObjectInsertRequest) returns (OfferObject)

Добавляет объект offer с заданными идентификатором и свойствами.

Области действия

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

  • https://www.googleapis.com/auth/wallet_object.issuer
List

rpc List(OfferObjectListRequest) returns (OfferObjectListResponse)

Возвращает список всех объектов типа offer, которые относятся к указанному идентификатору эмитента.

Области действия

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

  • https://www.googleapis.com/auth/wallet_object.issuer
Patch

rpc Patch(OfferObjectPatchRequest) returns (OfferObject)

Обновляет объект offer с указанным идентификатором. Этот метод поддерживает семантику PATCH.

Области действия

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

  • https://www.googleapis.com/auth/wallet_object.issuer
Update

rpc Update(OfferObjectUpdateRequest) returns (OfferObject)

Обновляет объект offer с указанным идентификатором.

Области действия

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

  • https://www.googleapis.com/auth/wallet_object.issuer

OfferClass

Поля
kind
(deprecated)

string

Определяет тип ресурса. Значение: фиксированная строка "walletobjects#offerClass".
title

string

Обязательно. Заголовок предложения. Пример: "Скидка 20 % на любую футболку". Рекомендуемая длина для корректного отображения на небольших экранах – не более 60 символов.
redemption_channel

RedemptionChannel

Обязательно. Каналы реализации специального предложения.
provider

string

Обязательно. Название компании-поставщика специального предложения. Можно указать агрегатора или продавца. Рекомендуемая длина для корректного отображения на небольших экранах – не более 12 символов.
title_image

Image

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

string

Подробные сведения о предложении.
fine_print

string

Условия, при которых действует предложение, и другие примечания. Пример: "Скидка 20 % на любую футболку в магазине Adam's Apparel."
help_uri

Uri

Ссылка на справочные материалы о предложении. Пример: http://myownpersonaldomain.com/help.
localized_title

LocalizedString

Варианты поля title на других языках. Рекомендуемая длина для корректного отображения на небольших экранах – не более 60 символов.
localized_provider

LocalizedString

Варианты поля provider на других языках. Рекомендуемая длина для корректного отображения на небольших экранах – не более 12 символов.
localized_details

LocalizedString

Варианты поля details на других языках.
localized_fine_print

LocalizedString

Варианты поля fine_print на других языках.
short_title

string

Более короткий заголовок предложения. Пример: "Скидка 20 %". Рекомендуемая длина – не более 20 символов.
localized_short_title

LocalizedString

Варианты поля short_title на других языках. Рекомендуемая длина – не более 20 символов.
class_template_info

ClassTemplateInfo

Информация в шаблоне о том, как должен отображаться класс. Если этот объект не задан, то будет использоваться набор полей по умолчанию.
id

string

Обязательно. Идентификатор класса. Идентификаторы классов у одного эмитента не могут повторяться. Значение указывается в следующем формате: issuer ID.identifier. При этом первая часть предоставляется Google, а вторая – выбирается вами. Идентификатор может содержать только буквы, цифры, точки, нижние подчеркивания и дефисы.
version
(deprecated)

int64

Больше не используется
issuer_name

string

Обязательно. Название эмитента. Рекомендуемая длина для корректного отображения на небольших экранах: максимум 20 символов.
messages[]

Message

Массив сообщений, которые будут отображаться в приложении. Связанные с ним сообщения увидят все пользователи этого объекта. Максимальное число полей – 10.
allow_multiple_users_per_object
(deprecated)

bool

Вместо него используйте multipleDevicesAndHoldersAllowedStatus.
homepage_uri

Uri

URI главной страницы приложения. Если поле заполнено, ссылка на главную страницу отображается в разделе, за который обычно отвечает поле linksModuleData. Тот же результат будет, если указать URI непосредственно в поле linksModuleData.
locations[]

LatLongPoint

Список местоположений, где может использоваться объект. Эта информация необходима для показа уведомлений пользователям с учетом их местоположения. Указанные в этом объекте местоположения имеют приоритет перед указанными в классе, а они в свою очередь имеют приоритет над заданными идентификаторами Google Places ID.
review_status

ReviewStatus

Обязательно. Статус класса. Пример: draft. Задать значение draft или underReview можно через вызовы API с помощью методов insert, patch или update. Обратите внимание, что после изменения статуса draft на любой другой вернуть значение draft невозможно.

Пока класс остается на этапе разработки, для него должен быть указан статус draft. На стадии draft нельзя создавать объекты.

Когда класс будет готов для проверки, необходимо изменить значение поля на underReview. Если класс будет одобрен, статус автоматически изменится на approved. После этого класс можно будет использовать для создания и перемещения объектов.

Если вы захотите обновить класс со статусом approved, значение поля нужно будет изменить на underReview.
review

Review

Комментарий о проверке, который платформа устанавливает, когда классу присваивается отметка approved или rejected.
info_module_data
(deprecated)

InfoModuleData

Вместо него используйте textModulesData.
image_modules_data[]

ImageModuleData

Данные графического модуля. Отображается не более 1 поля из уровня объекта и 1 поля для уровня объекта класса.
text_modules_data[]

TextModuleData

Данные текстового модуля. Если для класса также задан текстовый модуль, то показываться будут оба. Отображается не более 10 полей из объекта и 10 полей из класса.
redemption_issuers[]

int64

Доступно только для партнеров, поддерживающих интеллектуальную бесконтактную технологию. За дополнительной информацией обращайтесь в службу поддержки.
country_code

string

Код страны, по которому определяется место выпуска карты. Используется, когда пользователь совершает покупки в другой стране. Этот код также необходим для показа локализованного контента, если оригинальный контент недоступен в регионе пользователя.
hero_image

Image

Дополнительный баннер, который отображается на лицевой стороне карты. Показывается только при наличии. Занимает всю ширину карты.
word_mark
(deprecated)

Image

Больше не используется.
enable_smart_tap

bool

Доступно только для партнеров, поддерживающих интеллектуальную бесконтактную технологию. За дополнительной информацией обращайтесь в службу поддержки.
hex_background_color

string

Цвет фона карты. Если он не задан, то для оформления фона будет использован преобладающий цвет главного изображения, а в случае отсутствия изображения – логотипа. Цвет указывается в следующем формате: #rrggbb, где rrggbb – это номер оттенка в системе RGB, записанный в виде шестнадцатеричного кода. Пример: #ffcc00. Также можно использовать сокращенную версию в формате #rgb, например #fc0.
localized_issuer_name

LocalizedString

Переведенное значение issuer_name. Рекомендуемая длина для корректного отображения на небольших экранах: максимум 20 символов.
multiple_devices_and_holders_allowed_status

MultipleDevicesAndHoldersAllowedStatus

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

CallbackOptions

Параметры обратного вызова, которые будут использоваться для вызова эмитента всякий раз, когда конечные пользователи станут сохранять или удалять объекты этого класса. Данная функция доступна для всех объектов в этом классе.

RedemptionChannel

Перечисления
REDEMPTION_CHANNEL_UNSPECIFIED
INSTORE
instore

Устаревший псевдоним элемента INSTORE.
ONLINE
online

Устаревший псевдоним элемента ONLINE.
BOTH
both

Устаревший псевдоним элемента BOTH.
TEMPORARY_PRICE_REDUCTION
temporaryPriceReduction

Устаревший псевдоним элемента TEMPORARY_PRICE_REDUCTION.

OfferClassAddMessageRequest

Поля
resource_id

string

Идентификатор класса. Идентификаторы классов у одного эмитента не могут повторяться. Значение указывается в следующем формате: issuer ID.identifier. При этом первая часть предоставляется Google, а вторая – выбирается вами. Идентификатор может содержать только буквы, цифры, точки, нижние подчеркивания и дефисы.
add_message_request

AddMessageRequest

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

OfferClassAddMessageResponse

Поля
resource

OfferClass

Обновленный ресурс OfferClass.

OfferClassGetRequest

Поля
resource_id

string

Идентификатор класса. Идентификаторы классов у одного эмитента не могут повторяться. Значение указывается в следующем формате: issuer ID.identifier. При этом первая часть предоставляется Google, а вторая – выбирается вами. Идентификатор может содержать только буквы, цифры, точки, нижние подчеркивания и дефисы.

OfferClassInsertRequest

Поля
resource

OfferClass

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

OfferClassListRequest

Поля
issuer_id

int64

Идентификатор эмитента, который имеет право получать список классов.
token

string

Используется для получения следующего набора результатов, если значение maxResults задано, однако в списке доступно больше классов, чем maxResults. Например, если список состоит из 200 классов, а значение maxResults – 20, в списке будут получены первые 20 классов и токен. Чтобы увидеть следующие 20 классов, выполните вызов списка ещё раз. В запросе укажите токен, а для maxResults задайте значение 20.
max_results

int32

Максимальное количество результатов в списке. Если параметр maxResults не задан, выводятся все результаты.

OfferClassListResponse

Поля
resources[]

OfferClass

Ресурсы, соответствующие запросу списка.
pagination

Pagination

Число страниц в ответе.

OfferClassPatchRequest

Поля
resource_id

string

Идентификатор класса. Идентификаторы классов у одного эмитента не могут повторяться. Значение указывается в следующем формате: issuer ID.identifier. При этом первая часть предоставляется Google, а вторая – выбирается вами. Идентификатор может содержать только буквы, цифры, точки, нижние подчеркивания и дефисы.
resource

OfferClass

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

OfferClassUpdateRequest

Поля
resource_id

string

Идентификатор класса. Идентификаторы классов у одного эмитента не могут повторяться. Значение указывается в следующем формате: issuer ID.identifier. При этом первая часть предоставляется Google, а вторая – выбирается вами. Идентификатор может содержать только буквы, цифры, точки, нижние подчеркивания и дефисы.
resource

OfferClass

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

OfferObject

Поля
kind
(deprecated)

string

Определяет тип ресурса. Значение: фиксированная строка "walletobjects#offerObject".
class_reference

OfferClass

Копия полей, унаследованных от родительского класса. Эти поля извлекаются в ходе операции GET.
id

string

Обязательно. Уникальный идентификатор объекта. Идентификаторы объектов у одного эмитента не могут повторяться. Значение указывается в следующем формате: issuer ID.identifier. При этом первая часть предоставляется Google, а вторая – выбирается вами. Идентификатор может содержать только буквы, цифры, точки, символы подчеркивания и дефисы.
class_id

string

Обязательно. Класс, связанный с объектом. Элементы должны быть одного типа. Кроме того, класс должен быть существующим и одобренным.

Идентификатор класса должен иметь формат issuer ID.identifier (первая часть предоставляется Google, вторая задается вами).
version
(deprecated)

int64

Больше не используется
state

State

Обязательно. Статус объекта. Это поле определяет, как объект будет отображаться в приложении. Например, объекты со статусом inactive показываются в разделе "Проездные с истекшим сроком действия".
barcode

Barcode

Тип и значение штрихкода.
messages[]

Message

Массив сообщений, которые будут отображаться в приложении. Связанные с ним сообщения увидят все пользователи этого объекта. Максимальное число полей – 10.
valid_time_interval

TimeInterval

Период времени, в течение которого объект сохраняет состояние active, и его можно использовать. По истечении этого срока статус объекта сменится на expired.
locations[]

LatLongPoint

Список местоположений, где может использоваться объект. Эта информация необходима для показа уведомлений пользователям с учетом их местоположения. В случае конфликта данных этот список будет использоваться вместо адресов, содержащихся в классе, которые, в свою очередь, имеют приоритет над идентификаторами мест в Google.
has_users

bool

Это поле показывает, есть ли у объекта пользователи. Заполняется автоматически.
smart_tap_redemption_value

string

Доступно только для партнеров, поддерживающих интеллектуальную бесконтактную технологию. За дополнительной информацией обращайтесь в службу поддержки.
has_linked_device

bool

Это поле показывает, связан ли объект с отдельным устройством. Заполняется автоматически, когда пользователь сохраняет объект и, тем самым, привязывает его к своему устройству. Доступно не для всех партнеров. За дополнительной информацией обращайтесь в службу поддержки.
disable_expiration_notification

bool

Это поле показывает, должны ли блокироваться уведомления. Если установлено значение true, уведомления об истечении срока действия не будут приходить пользователю, даже если это противоречит настройке, заданной в поле messages. По умолчанию установлено значение false.

В настоящее время параметр можно задать только для специальных предложений.
info_module_data

InfoModuleData

Больше не используется. Вместо него используйте textModulesData.
image_modules_data[]

ImageModuleData

Данные графического модуля. Отображается не более 1 поля из уровня объекта и 1 поля для уровня объекта класса.
text_modules_data[]

TextModuleData

Данные текстового модуля. Если для класса также задан текстовый модуль, то показываться будут оба. Отображается не более 10 полей из объекта и 10 полей из класса.

OfferObjectAddMessageRequest

Поля
resource_id

string

Уникальный идентификатор объекта. Идентификаторы объектов у одного эмитента не могут повторяться. Значение указывается в следующем формате: issuer ID.identifier. При этом первая часть предоставляется Google, а вторая – выбирается вами. Идентификатор может содержать только буквы, цифры, точки, нижние подчеркивания и дефисы.
add_message_request

AddMessageRequest

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

OfferObjectAddMessageResponse

Поля
resource

OfferObject

Обновленный ресурс OfferObject.

OfferObjectGetRequest

Поля
resource_id

string

Уникальный идентификатор объекта. Идентификаторы объектов у одного эмитента не могут повторяться. Значение указывается в следующем формате: issuer ID.identifier. При этом первая часть предоставляется Google, а вторая – выбирается вами. Идентификатор может содержать только буквы, цифры, точки, нижние подчеркивания и дефисы.

OfferObjectInsertRequest

Поля
resource

OfferObject

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

OfferObjectListRequest

Поля
class_id

string

Идентификатор класса, объекты которого будут перечислены.
token

string

Используется для получения следующего набора результатов, если значение maxResults задано, однако в списке доступно больше объектов, чем maxResults. Например, если список состоит из 200 объектов, а значение maxResults – 20, в списке будут получены первые 20 объектов и токен. Чтобы увидеть следующие 20 объектов, выполните вызов списка ещё раз. В запросе укажите токен, а для maxResults задайте значение 20.
max_results

int32

Максимальное количество результатов в списке. Если параметр maxResults не задан, выводятся все результаты.

OfferObjectListResponse

Поля
resources[]

OfferObject

Ресурсы, соответствующие запросу списка.
pagination

Pagination

Число страниц в ответе.

OfferObjectPatchRequest

Поля
resource_id

string

Уникальный идентификатор объекта. Идентификаторы объектов у одного эмитента не могут повторяться. Значение указывается в следующем формате: issuer ID.identifier. При этом первая часть предоставляется Google, а вторая – выбирается вами. Идентификатор может содержать только буквы, цифры, точки, нижние подчеркивания и дефисы.
resource

OfferObject

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

OfferObjectUpdateRequest

Поля
resource_id

string

Уникальный идентификатор объекта. Идентификаторы объектов у одного эмитента не могут повторяться. Значение указывается в следующем формате: issuer ID.identifier. При этом первая часть предоставляется Google, а вторая – выбирается вами. Идентификатор может содержать только буквы, цифры, точки, нижние подчеркивания и дефисы.
resource

OfferObject

Тело запроса.