REST Resource: eventticketclass

Ресурс: EventTicketClass

JSON-представление 
{
  "kind": string,
  "eventName": {
    object (LocalizedString)
  },
  "eventId": string,
  "logo": {
    object (Image)
  },
  "venue": {
    object (EventVenue)
  },
  "dateTime": {
    object (EventDateTime)
  },
  "confirmationCodeLabel": enum (ConfirmationCodeLabel),
  "customConfirmationCodeLabel": {
    object (LocalizedString)
  },
  "seatLabel": enum (SeatLabel),
  "customSeatLabel": {
    object (LocalizedString)
  },
  "rowLabel": enum (RowLabel),
  "customRowLabel": {
    object (LocalizedString)
  },
  "sectionLabel": enum (SectionLabel),
  "customSectionLabel": {
    object (LocalizedString)
  },
  "gateLabel": enum (GateLabel),
  "customGateLabel": {
    object (LocalizedString)
  },
  "finePrint": {
    object (LocalizedString)
  },
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  },
  "id": string,
  "version": string,
  "issuerName": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "allowMultipleUsersPerObject": boolean,
  "homepageUri": {
    object (Uri)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "reviewStatus": enum (ReviewStatus),
  "review": {
    object (Review)
  },
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "redemptionIssuers": [
    string
  ],
  "countryCode": string,
  "heroImage": {
    object (Image)
  },
  "wordMark": {
    object (Image)
  },
  "enableSmartTap": boolean,
  "hexBackgroundColor": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "multipleDevicesAndHoldersAllowedStatus": enum (MultipleDevicesAndHoldersAllowedStatus),
  "callbackOptions": {
    object (CallbackOptions)
  },
  "securityAnimation": {
    object (SecurityAnimation)
  },
  "viewUnlockRequirement": enum (ViewUnlockRequirement),
  "wideLogo": {
    object (Image)
  },
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "appLinkData": {
    object (AppLinkData)
  },
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
Поля
kind
(deprecated)

string

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

event Name

object ( LocalizedString )

Необходимый. Название мероприятия, например «LA Dodgers at SF Giants».

event Id

string

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

Если это предусмотрено, группировка будет стабильной. Будьте осторожны с непреднамеренными столкновениями, чтобы избежать группировки заявок, которые не следует группировать. Если вы используете только один класс для каждого события, вы можете просто установить для него classId (с частью идентификатора издателя или без нее).

Если не указано иное, платформа попытается использовать другие данные для группировки заявок (потенциально нестабильно).

venue

object ( EventVenue )

Подробности о месте проведения мероприятия.

date Time

object ( EventDateTime )

Информация о дате и времени события.

confirmation Code Label

enum ( ConfirmationCodeLabel )

Метка, используемая для значения кода подтверждения ( eventTicketObject.reservationInfo.confirmationCode ) в представлении сведений о карте. Каждый доступный параметр сопоставляется с набором локализованных строк, поэтому пользователю отображаются переводы в зависимости от его языкового стандарта.

И confirmationCodeLabel , и customConfirmationCodeLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Код подтверждения». Если поле кода подтверждения не задано, эта метка не будет использоваться.

custom Confirmation Code Label

object ( LocalizedString )

Пользовательская метка, используемая для значения кода подтверждения ( eventTicketObject.reservationInfo.confirmationCode ) в представлении сведений о карте. Это следует использовать только в том случае, если метки «Код подтверждения» по умолчанию или одного из параметров confirmationCodeLabel недостаточно.

И confirmationCodeLabel , и customConfirmationCodeLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Код подтверждения». Если поле кода подтверждения не задано, эта метка не будет использоваться.

seat Label

enum ( SeatLabel )

Метка, используемая для значения места ( eventTicketObject.seatInfo.seat ) в подробном представлении карты. Каждый доступный параметр сопоставляется с набором локализованных строк, поэтому пользователю отображаются переводы в зависимости от его языкового стандарта.

Оба seatLabel и customSeatLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Место». Если поле места не установлено, эта метка не будет использоваться.

custom Seat Label

object ( LocalizedString )

Пользовательская метка, используемая для значения места ( eventTicketObject.seatInfo.seat ) в подробном представлении карты. Это следует использовать только в том случае, если метки Seat по умолчанию или одного из параметров seatLabel недостаточно.

Оба seatLabel и customSeatLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Место». Если поле места не установлено, эта метка не будет использоваться.

row Label

enum ( RowLabel )

Метка, используемая для значения строки ( eventTicketObject.seatInfo.row ) в подробном представлении карты. Каждый доступный параметр сопоставляется с набором локализованных строк, поэтому пользователю отображаются переводы в зависимости от его языкового стандарта.

И rowLabel , и customRowLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Строка». Если поле строки не установлено, эта метка не будет использоваться.

custom Row Label

object ( LocalizedString )

Пользовательская метка, используемая для значения строки ( eventTicketObject.seatInfo.row ) в подробном представлении карты. Это следует использовать только в том случае, если метки «Row» по умолчанию или одного из параметров rowLabel недостаточно.

И rowLabel , и customRowLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Строка». Если поле строки не установлено, эта метка не будет использоваться.

section Label

enum ( SectionLabel )

Метка, используемая для значения раздела ( eventTicketObject.seatInfo.section ) в подробном представлении карты. Каждый доступный параметр сопоставляется с набором локализованных строк, поэтому пользователю отображаются переводы в зависимости от его языкового стандарта.

Оба sectionLabel и customSectionLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Раздел». Если поле раздела не задано, эта метка не будет использоваться.

custom Section Label

object ( LocalizedString )

Пользовательская метка, используемая для значения раздела ( eventTicketObject.seatInfo.section ) в подробном представлении карты. Это следует использовать только в том случае, если метки «Раздел» по умолчанию или одного из параметров sectionLabel недостаточно.

Оба sectionLabel и customSectionLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Раздел». Если поле раздела не задано, эта метка не будет использоваться.

gate Label

enum ( GateLabel )

Метка, используемая для значения шлюза ( eventTicketObject.seatInfo.gate ) в подробном представлении карты. Каждый доступный параметр сопоставляется с набором локализованных строк, поэтому пользователю отображаются переводы в зависимости от его языкового стандарта.

И gateLabel , и customGateLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Ворота». Если поле ворота не установлено, эта метка не будет использоваться.

custom Gate Label

object ( LocalizedString )

Пользовательская метка, используемая для значения шлюза ( eventTicketObject.seatInfo.gate ) в подробном представлении карты. Это следует использовать только в том случае, если метки Gate по умолчанию или одного из параметров gateLabel недостаточно.

И gateLabel , и customGateLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Ворота». Если поле ворота не установлено, эта метка не будет использоваться.

fine Print

object ( LocalizedString )

Мелкий шрифт, условия билета.

class Template Info

object ( ClassTemplateInfo )

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

id

string

Необходимый. Уникальный идентификатор класса. Этот идентификатор должен быть уникальным для всех классов издателя. Это значение должно соответствовать формату issuer ID . identifier , первый из которых выдается Google, а второй выбирается вами. Ваш уникальный идентификатор должен содержать только буквенно-цифровые символы, «.», «_» или «-».

version
(deprecated)

string ( int64 format)

Устарело

issuer Name

string

Необходимый. Название эмитента. Рекомендуемая максимальная длина — 20 символов, чтобы обеспечить отображение всей строки на небольших экранах.

messages[]

object ( Message )

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

allowMultipleUsersPerObject
(deprecated)

boolean

Устарело. Вместо этого используйте multipleDevicesAndHoldersAllowedStatus .

homepage Uri

object ( Uri )

URI домашней страницы вашего приложения. Заполнение URI в этом поле приводит к точно такому же поведению, как и заполнение URI в linkedModuleData (при визуализации объекта ссылка на домашнюю страницу отображается в том, что обычно считается разделом linkedModuleData объекта).

locations[]
(deprecated)

object ( LatLongPoint )

Примечание. Это поле в настоящее время не поддерживается для запуска географических уведомлений.

review Status

enum ( ReviewStatus )

Необходимый. Статус класса. В этом поле можно установить draft или underReview используя вызовы API вставки, исправления или обновления. После изменения состояния проверки с draft его нельзя будет вернуть обратно в draft .

Это поле следует оставить для draft пока класс находится в стадии разработки. draft класс нельзя использовать для создания какого-либо объекта.

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

При обновлении уже approved класса вам следует продолжать устанавливать в этом поле значение underReview .

review

object ( Review )

Комментарии к обзору, устанавливаемые платформой, когда класс помечается как approved или rejected .

infoModuleData
(deprecated)

object ( InfoModuleData )

Устарело. Вместо этого используйте textModulesData.

image Modules Data[]

object ( ImageModuleData )

Данные модуля изображения. Максимальное количество отображаемых полей — 1 на уровне объекта и 1 на уровне объекта класса.

text Modules Data[]

object ( TextModuleData )

Текстовые данные модуля. Если в классе также определены данные текстового модуля, будут отображены оба. Максимальное количество отображаемых полей — 10 для объекта и 10 для класса.

redemption Issuers[]

string ( int64 format)

Определяет, какие эмитенты погашения могут выкупить пропуск через Smart Tap. Эмитенты погашения идентифицируются по идентификатору эмитента. У эмитентов погашения должен быть настроен хотя бы один ключ Smart Tap.

Поля enableSmartTap и smartTapRedemptionLevel на уровне объекта также должны быть настроены правильно, чтобы пропуск поддерживал Smart Tap.

country Code

string

Код страны, используемый для отображения страны карты (если пользователь не находится в этой стране), а также для отображения локализованного контента, когда контент недоступен в языковом стандарте пользователя.

hero Image

object ( Image )

Дополнительное изображение баннера, отображаемое на лицевой стороне карты. Если его нет, ничего не будет отображаться. Изображение будет отображаться с шириной 100%.

wordMark
(deprecated)

object ( Image )

Устарело.

enable Smart Tap

boolean

Определяет, поддерживает ли этот класс Smart Tap. Поля redemptionIssuers и smartTapRedemptionLevel уровня объекта также должны быть настроены правильно, чтобы пропуск поддерживал Smart Tap.

hex Background Color

string

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

localized Issuer Name

object ( LocalizedString )

Переведенные строки для имени эмитента. Рекомендуемая максимальная длина — 20 символов, чтобы обеспечить отображение всей строки на небольших экранах.

multiple Devices And Holders Allowed Status

enum ( MultipleDevicesAndHoldersAllowedStatus )

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

callback Options

object ( CallbackOptions )

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

security Animation

object ( SecurityAnimation )

Дополнительная информация об анимации безопасности. Если этот параметр установлен, при деталях прохода будет отображаться анимация безопасности.

view Unlock Requirement

enum ( ViewUnlockRequirement )

Просмотрите параметры требований к разблокировке для билета на мероприятие.

notify Preference

enum ( NotificationSettingsForUpdates )

Должны ли обновления полей этого класса вызывать уведомления. Если установлено значение NOTIFY, мы попытаемся отправить пользователям уведомление об обновлении поля. Эти уведомления будут отправляться пользователям только в том случае, если поле входит в белый список. Если не указано, уведомление не будет сгенерировано. Этот параметр является временным и его необходимо устанавливать при каждом запросе PATCH или UPDATE, иначе уведомление не будет активировано.

value Added Module Data[]

object ( ValueAddedModuleData )

Дополнительные данные модуля с добавленной стоимостью. Максимум десять в классе. Для прохода будут отображаться только десять, приоритет отдается тем, которые принадлежат объекту.

МероприятиеМесто проведения

JSON-представление 
{
  "kind": string,
  "name": {
    object (LocalizedString)
  },
  "address": {
    object (LocalizedString)
  }
}
Поля
kind
(deprecated)

string

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

name

object ( LocalizedString )

Название места проведения, например «AT&T Park».

Это необходимо.

address

object ( LocalizedString )

Адрес места проведения, например «24 Willie Mays Plaza\nSan Francisco, CA 94107». Строки адреса разделяются символами перевода строки ( \n ).

Это необходимо.

СобытиеДатаВремя

JSON-представление 
{
  "kind": string,
  "doorsOpen": string,
  "start": string,
  "end": string,
  "doorsOpenLabel": enum (DoorsOpenLabel),
  "customDoorsOpenLabel": {
    object (LocalizedString)
  }
}
Поля
kind
(deprecated)

string

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

doors Open

string

Дата/время открытия дверей на площадке.

Это дата/время расширенного формата ISO 8601 со смещением или без него. Время может быть указано с точностью до наносекунды. Смещения могут быть указаны с точностью до секунды (хотя секунды смещения не являются частью ISO 8601).

Например:

1985-04-12T23:20:50.52Z будет через 20 минут 50,52 секунды после 23-го часа 12 апреля 1985 года по всемирному координированному времени.

1985-04-12T19:20:50.52-04:00 будет через 20 минут и 50,52 секунды после 19-го часа 12 апреля 1985 года, за 4 часа до UTC (тот же момент времени, что и в приведенном выше примере). Если бы мероприятие проходило в Нью-Йорке, это было бы эквивалентно восточному летнему времени (EDT). Помните, что смещение варьируется в регионах, где соблюдается летнее время (или летнее время), в зависимости от времени года.

1985-04-12T19:20:50.52 будет через 20 минут и 50,52 секунды после 19-го часа 12 апреля 1985 года без какой-либо информации о смещении.

Часть даты/времени без смещения считается «локальной датой/временем». Это должна быть местная дата/время места проведения. Например, если событие происходит в 20 часов 5 июня 2018 года в месте проведения, локальная часть даты/времени должна быть 2018-06-05T20:00:00 . Если местная дата/время в месте проведения на 4 часа раньше UTC, может быть добавлено смещение -04:00 .

Без информации о смещении некоторые богатые функции могут быть недоступны.

start

string

Дата/время начала события. Если мероприятие длится несколько дней, это должна быть дата/время начала первого дня.

Это дата/время расширенного формата ISO 8601 со смещением или без него. Время может быть указано с точностью до наносекунды. Смещения могут быть указаны с точностью до секунды (хотя секунды смещения не являются частью ISO 8601).

Например:

1985-04-12T23:20:50.52Z будет через 20 минут 50,52 секунды после 23-го часа 12 апреля 1985 года по всемирному координированному времени.

1985-04-12T19:20:50.52-04:00 будет через 20 минут и 50,52 секунды после 19-го часа 12 апреля 1985 года, за 4 часа до UTC (тот же момент времени, что и в приведенном выше примере). Если бы мероприятие проходило в Нью-Йорке, это было бы эквивалентно восточному летнему времени (EDT). Помните, что смещение варьируется в регионах, где соблюдается летнее время (или летнее время), в зависимости от времени года.

1985-04-12T19:20:50.52 будет через 20 минут 50,52 секунды после 19-го часа 12 апреля 1985 года без информации о смещении.

Часть даты/времени без смещения считается «локальной датой/временем». Это должна быть местная дата/время места проведения. Например, если событие происходит в 20 часов 5 июня 2018 года в месте проведения, локальная часть даты/времени должна быть 2018-06-05T20:00:00 . Если местная дата/время в месте проведения на 4 часа раньше UTC, может быть добавлено смещение -04:00 .

Без информации о смещении некоторые богатые функции могут быть недоступны.

end

string

Дата/время окончания события. Если событие длится несколько дней, это должна быть дата/время окончания последнего дня.

Это дата/время расширенного формата ISO 8601 со смещением или без него. Время может быть указано с точностью до наносекунды. Смещения могут быть указаны с точностью до секунды (хотя секунды смещения не являются частью ISO 8601).

Например:

1985-04-12T23:20:50.52Z будет через 20 минут 50,52 секунды после 23-го часа 12 апреля 1985 года по всемирному координированному времени.

1985-04-12T19:20:50.52-04:00 будет через 20 минут и 50,52 секунды после 19-го часа 12 апреля 1985 года, за 4 часа до UTC (тот же момент времени, что и в приведенном выше примере). Если бы мероприятие проходило в Нью-Йорке, это было бы эквивалентно восточному летнему времени (EDT). Помните, что смещение варьируется в регионах, где соблюдается летнее время (или летнее время), в зависимости от времени года.

1985-04-12T19:20:50.52 будет через 20 минут и 50,52 секунды после 19-го часа 12 апреля 1985 года без какой-либо информации о смещении.

Часть даты/времени без смещения считается «локальной датой/временем». Это должна быть местная дата/время места проведения. Например, если событие происходит в 20 часов 5 июня 2018 года в месте проведения, локальная часть даты/времени должна быть 2018-06-05T20:00:00 . Если местная дата/время в месте проведения на 4 часа раньше UTC, может быть добавлено смещение -04:00 .

Без информации о смещении некоторые богатые функции могут быть недоступны.

doors Open Label

enum ( DoorsOpenLabel )

Метка, используемая для значения открытия дверей ( doorsOpen ) в подробном представлении карты. Каждый доступный параметр сопоставляется с набором локализованных строк, поэтому пользователю отображаются переводы в зависимости от его языкового стандарта.

Оба doorsOpenLabel и customDoorsOpenLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Двери открыты». Если поле «Двери открыты», эта метка не будет использоваться.

custom Doors Open Label

object ( LocalizedString )

Пользовательская метка, используемая для значения открытия дверей ( doorsOpen ) в подробном представлении карты. Это следует использовать только в том случае, если метки «Двери открыты» по умолчанию или одного из параметров doorsOpenLabel недостаточно.

Оба doorsOpenLabel и customDoorsOpenLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Двери открыты». Если поле «Двери открыты», эта метка не будет использоваться.

ДвериОткрытыйЭтикетка

Перечисления
DOORS_OPEN_LABEL_UNSPECIFIED
DOORS_OPEN
doorsOpen

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

GATES_OPEN
gatesOpen

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

КодПодтвержденияМетка

Перечисления
CONFIRMATION_CODE_LABEL_UNSPECIFIED
CONFIRMATION_CODE
confirmationCode

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

CONFIRMATION_NUMBER
confirmationNumber

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

ORDER_NUMBER
orderNumber

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

RESERVATION_NUMBER
reservationNumber

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

SeatLabel

Перечисления
SEAT_LABEL_UNSPECIFIED
SEAT
seat

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

Строкаметка

Перечисления
ROW_LABEL_UNSPECIFIED
ROW
row

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

Метка раздела

Перечисления
SECTION_LABEL_UNSPECIFIED
SECTION
section

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

THEATER
theater

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

Метка ворот

Перечисления
GATE_LABEL_UNSPECIFIED
GATE
gate

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

DOOR
door

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

ENTRANCE
entrance

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

Методы

addmessage

 Добавляет сообщение в класс билета события, на который ссылается данный идентификатор класса.

get

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

insert

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

list

 Возвращает список всех классов билетов событий для данного идентификатора издателя.

patch

 Обновляет класс билета события, на который ссылается данный идентификатор класса.

update

 Обновляет класс билета события, на который ссылается данный идентификатор класса.