MCP Tools Reference: paydeveloper.googleapis.com

Инструмент: list_pass_classes

Получает полный список всех классов пропусков, зарегистрированных в бизнес-консоли Google Wallet и связанных с авторизованным пользователем. Этот инструмент предоставляет разработчикам важную информацию для управления пропусками Wallet, такими как карты лояльности, подарочные карты или авиабилеты.

В следующем примере показано, как использовать curl для вызова инструмента MCP list_pass_classes .

Запрос Curl 
curl --location 'https://paydeveloper.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_pass_classes",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Схема ввода

Запрос на отображение списка классов пропусков эмитента.

ListPassClassesRequest

JSON-представление 
{
  "issuerId": string,
  "passType": enum (PassType),
  "view": enum (PassClassView)
}
Поля
issuerId

string ( int64 format)

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

passType

enum ( PassType )

Необязательный параметр. Тип пропуска для отображения. Если не указан, будут возвращены все типы пропусков.

view

enum ( PassClassView )

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

Схема вывода

Ответное сообщение для отображения классов пропусков эмитента.

ListPassClassesResponse

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

object ( PassClass )

Классы пропусков эмитента.

PassClass

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

  // Union field resource can be only one of the following:
  "loyaltyClass": {
    object (LoyaltyClass)
  },
  "giftCardClass": {
    object (GiftCardClass)
  },
  "offerClass": {
    object (OfferClass)
  },
  "eventTicketClass": {
    object (EventTicketClass)
  },
  "flightClass": {
    object (FlightClass)
  },
  "transitClass": {
    object (TransitClass)
  },
  "genericClass": {
    object (GenericClass)
  }
  // End of list of possible types for union field resource.
}
Поля

resource полевых работ Союза.

resource может быть только одним из следующих:

loyaltyClass

object ( LoyaltyClass )

Необязательно. Класс лояльности эмитента.

giftCardClass

object ( GiftCardClass )

Необязательно. Класс подарочной карты эмитента.

offerClass

object ( OfferClass )

Необязательно. Класс предложения эмитента.

eventTicketClass

object ( EventTicketClass )

Необязательно. Класс билета на мероприятие, указанный эмитентом.

flightClass

object ( FlightClass )

Необязательно. Класс полета эмитента.

transitClass

object ( TransitClass )

Необязательно. Транзитный класс эмитента.

genericClass

object ( GenericClass )

Необязательный параметр. Общий класс эмитента.

LoyaltyClass

JSON-представление 
{
  "id": string,
  "issuerName": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "programName": string,
  "localizedProgramName": {
    object (LocalizedString)
  },
  "programLogoUri": string,
  "hexBackgroundColor": string,
  "heroImageUri": string,
  "discoverableProgram": {
    object (DiscoverableProgram)
  },
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  }
}
Поля
id

string

Необязательный параметр. Идентификатор класса лояльности.

issuerName

string

Необязательно. Название эмитента класса лояльности.

localizedIssuerName

object ( LocalizedString )

Необязательно. Локализованное название эмитента класса лояльности.

programName

string

Необязательно. Название программы лояльности.

localizedProgramName

object ( LocalizedString )

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

programLogoUri

string

(Необязательно) Логотип программы лояльности.

hexBackgroundColor

string

Необязательный параметр. Цвет фона класса лояльности. Формат — шестнадцатеричная строка цвета, например, "#RRGGBB".

heroImageUri

string

Необязательно. Изображение баннера, отображаемое на лицевой стороне страницы программы лояльности.

discoverableProgram

object ( DiscoverableProgram )

Необязательно. Информация о том, как можно обнаружить и создать экземпляр класса лояльности в Google Wallet.

classTemplateInfo

object ( ClassTemplateInfo )

Необязательно. Информация о шаблоне, определяющая способ отображения класса лояльности.

LocalizedString

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

object ( TranslatedString )

Необязательно. Переведённые строки для данной строки.

defaultValue

object ( TranslatedString )

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

TranslatedString

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

string

Необязательный параметр. Языковой тег BCP 47. Примеры значений: "en-US", "en-GB", "de" или "de-AT".

value

string

Необязательно. Переведённая строка в кодировке UTF-8.

Программа, которую можно обнаружить

JSON-представление 
{
  "merchantSignupInfo": {
    object (MerchantSignupInfo)
  },
  "merchantSigninInfo": {
    object (MerchantSigninInfo)
  },
  "state": enum (State)
}
Поля
merchantSignupInfo

object ( MerchantSignupInfo )

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

merchantSigninInfo

object ( MerchantSigninInfo )

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

state

enum ( State )

Только вывод. Состояние обнаруживаемой программы.

Информация о регистрации продавца

JSON-представление 
{
  "signupWebsite": {
    object (Uri)
  },
  "signupSharedDatas": [
    enum (SharedDataType)
  ]
}
Поля
signupWebsite

object ( Uri )

Необязательно. Веб-сайт для регистрации в программе Discoverable.

signupSharedDatas[]

enum ( SharedDataType )

Необязательно. Данные пользователя, отправляемые в POST-запросе на URL-адрес сайта регистрации. Эта информация кодируется и затем передается, чтобы веб-сайт продавца мог предварительно заполнить поля, используемые для регистрации пользователя в программе, которую можно найти.

Ури

JSON-представление 
{
  "uri": string,
  "description": string,
  "localizedDescription": {
    object (LocalizedString)
  }
}
Поля
uri

string

Необязательно. URI.

description

string

Необязательно. Заголовок URI, отображаемый в Google Wallet в виде текста.

localizedDescription

object ( LocalizedString )

Необязательно. Переведённые строки заголовка URI, отображаемые в Google Wallet в виде текста.

Информация для входа в систему продавца

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

object ( Uri )

Необязательно. Веб-сайт для регистрации в программе поиска.

ClassTemplateInfo

JSON-представление 
{
  "cardBarcodeSectionDetails": {
    object (CardBarcodeSectionDetails)
  },
  "cardTemplateOverride": {
    object (CardTemplateOverride)
  },
  "detailsTemplateOverride": {
    object (DetailsTemplateOverride)
  },
  "listTemplateOverride": {
    object (ListTemplateOverride)
  }
}
Поля
cardBarcodeSectionDetails

object ( CardBarcodeSectionDetails )

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

cardTemplateOverride

object ( CardTemplateOverride )

Необязательно. Переопределение шаблона для представления карточек.

detailsTemplateOverride

object ( DetailsTemplateOverride )

Необязательно. Переопределение шаблона для отображения подробной информации.

listTemplateOverride

object ( ListTemplateOverride )

Необязательно. Переопределение шаблона для представления списка пропусков.

CardBarcodeSectionDetails

JSON-представление 
{
  "firstTopDetail": {
    object (BarcodeSectionDetail)
  },
  "firstBottomDetail": {
    object (BarcodeSectionDetail)
  },
  "secondTopDetail": {
    object (BarcodeSectionDetail)
  }
}
Поля
firstTopDetail

object ( BarcodeSectionDetail )

Необязательно. Дополнительная информация, которая будет отображаться над штрихкодом. Если задан параметр secondTopDetail, эта информация будет отображаться в начале данного раздела с подробными сведениями.

firstBottomDetail

object ( BarcodeSectionDetail )

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

secondTopDetail

object ( BarcodeSectionDetail )

Необязательно. Необязательный второй фрагмент информации, который будет отображаться над штрихкодом. Если задан параметр firstTopDetail, он будет отображаться в конце этого раздела с подробной информацией.

BarcodeSectionDetail

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

object ( FieldSelector )

Необязательно. Ссылка на существующее текстовое или графическое поле для отображения.

FieldSelector

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

object ( FieldReference )

Необязательно. Ссылки на поля, используемые при переопределении полей. Если указано несколько ссылок, будет отображена первая, ссылающаяся на непустое поле.

FieldReference

JSON-представление 
{
  "fieldPath": string,
  "dateFormat": enum (DateFormat)
}
Поля
fieldPath

string

Необязательно. Путь к полю, на которое делается ссылка, с префиксом "object" или "class" и разделённый точками.

dateFormat

enum ( DateFormat )

Необязательный параметр. Формат даты для отображения полей даты/времени.

CardTemplateOverride

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

object ( CardRowTemplateInfo )

Необязательно. Информация о шаблоне строк в карточном представлении. Можно указать не более трех строк.

CardRowTemplateInfo

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

  // Union field row_template can be only one of the following:
  "oneItem": {
    object (CardRowOneItem)
  },
  "twoItems": {
    object (CardRowTwoItems)
  },
  "threeItems": {
    object (CardRowThreeItems)
  }
  // End of list of possible types for union field row_template.
}
Поля
Поле объединения row_template . Шаблон для строки, содержащей один, два или три элемента. row_template может принимать только одно из следующих значений:
oneItem

object ( CardRowOneItem )

Необязательный параметр. Шаблон для строки, содержащей один элемент.

twoItems

object ( CardRowTwoItems )

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

threeItems

object ( CardRowThreeItems )

Необязательный параметр. Шаблон для строки, содержащей три элемента.

CardRowOneItem

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

object ( TemplateItem )

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

TemplateItem

JSON-представление 
{
  "firstValue": {
    object (FieldSelector)
  },
  "secondValue": {
    object (FieldSelector)
  },
  "predefinedItem": enum (PredefinedItem)
}
Поля
firstValue

object ( FieldSelector )

Необязательно. Ссылка на первое отображаемое поле.

secondValue

object ( FieldSelector )

Необязательно. Ссылка на второе поле для отображения.

predefinedItem

enum ( PredefinedItem )

Необязательный параметр. Предопределенный элемент для отображения.

CardRowTwoItems

JSON-представление 
{
  "startItem": {
    object (TemplateItem)
  },
  "endItem": {
    object (TemplateItem)
  }
}
Поля
startItem

object ( TemplateItem )

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

endItem

object ( TemplateItem )

Необязательно. Элемент, который будет отображаться в конце строки. Этот элемент будет выровнен по правому краю.

CardRowThreeItems

JSON-представление 
{
  "startItem": {
    object (TemplateItem)
  },
  "middleItem": {
    object (TemplateItem)
  },
  "endItem": {
    object (TemplateItem)
  }
}
Поля
startItem

object ( TemplateItem )

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

middleItem

object ( TemplateItem )

Необязательный параметр. Элемент, который будет отображаться посередине строки. Этот элемент будет расположен по центру между начальным и конечным элементами.

endItem

object ( TemplateItem )

Необязательно. Элемент, который будет отображаться в конце строки. Этот элемент будет выровнен по правому краю.

DetailsTemplateOverride

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

object ( DetailsItemInfo )

Необязательно. Информация о шаблоне, содержащаяся в списке подробных сведений.

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

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

object ( TemplateItem )

Необязательно. Элемент, который будет отображаться в списке с подробными сведениями.

ListTemplateOverride

JSON-представление 
{
  "firstRowOption": {
    object (FirstRowOption)
  },
  "secondRowOption": {
    object (FieldSelector)
  }
}
Поля
firstRowOption

object ( FirstRowOption )

Необязательно. Ссылка на поле, которое будет отображаться в первой строке.

secondRowOption

object ( FieldSelector )

Необязательно. Ссылка на поле, которое будет отображаться во второй строке.

FirstRowOption

JSON-представление 
{
  "transitOption": enum (TransitOption),
  "fieldOption": {
    object (FieldSelector)
  }
}
Поля
transitOption

enum ( TransitOption )

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

fieldOption

object ( FieldSelector )

Необязательно. Ссылка на поле, которое будет отображаться в первой строке.

GiftCardClass

JSON-представление 
{
  "id": string,
  "issuerName": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "merchantName": string,
  "localizedMerchantName": {
    object (LocalizedString)
  },
  "programLogoUri": string,
  "hexBackgroundColor": string,
  "heroImageUri": string,
  "homePageUri": {
    object (Uri)
  },
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  }
}
Поля
id

string

Необязательный параметр. Идентификатор класса подарочной карты.

issuerName

string

Необязательно. Название эмитента подарочной карты соответствующего класса.

localizedIssuerName

object ( LocalizedString )

Необязательно. Локализованное название эмитента класса подарочных карт.

merchantName

string

Необязательно. Название продавца для класса подарочных карт.

localizedMerchantName

object ( LocalizedString )

Необязательно. Локализованное название продавца для класса подарочных карт.

programLogoUri

string

(Необязательно) Логотип программы для класса подарочных карт.

hexBackgroundColor

string

Необязательный параметр. Цвет фона класса подарочной карты. Формат — шестнадцатеричная строка цвета, например, "#RRGGBB".

heroImageUri

string

Необязательно. Изображение баннера, отображаемое на лицевой стороне подарочной карты.

homePageUri

object ( Uri )

Необязательно. Веб-сайт, на котором размещена главная страница приложения.

classTemplateInfo

object ( ClassTemplateInfo )

Необязательно. Информация о шаблоне, определяющая способ отображения класса подарочной карты.

OfferClass

JSON-представление 
{
  "id": string,
  "issuerName": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "provider": string,
  "localizedProvider": {
    object (LocalizedString)
  },
  "title": string,
  "localizedTitle": {
    object (LocalizedString)
  },
  "titleImageUri": string,
  "hexBackgroundColor": string,
  "heroImageUri": string,
  "redemptionChannel": enum (RedemptionChannel),
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  }
}
Поля
id

string

Необязательный параметр. Идентификатор класса предложения.

issuerName

string

Необязательно. Название эмитента класса предложений.

localizedIssuerName

object ( LocalizedString )

Необязательно. Локализованное название эмитента класса предложений.

provider

string

Необязательно. Поставщик класса предложений.

localizedProvider

object ( LocalizedString )

Необязательно. Локализованный поставщик класса предложений.

title

string

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

localizedTitle

object ( LocalizedString )

Необязательно. Локализованное название класса предложений.

titleImageUri

string

Необязательно. Изображение заголовка предложения.

hexBackgroundColor

string

Необязательный параметр. Цвет фона класса предложения. Формат — шестнадцатеричная строка цвета, например, "#RRGGBB".

heroImageUri

string

Необязательно. Изображение баннера, отображаемое на лицевой стороне предложения.

redemptionChannel

enum ( RedemptionChannel )

Необязательно. Канал погашения для данного класса предложений.

classTemplateInfo

object ( ClassTemplateInfo )

Необязательно. Информация о шаблоне, определяющая способ отображения класса предложения.

EventTicketClass

JSON-представление 
{
  "id": string,
  "issuerName": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "logoUri": string,
  "eventName": {
    object (LocalizedString)
  },
  "venue": {
    object (EventVenue)
  },
  "dateTime": {
    object (EventDateTime)
  },
  "hexBackgroundColor": string,
  "heroImageUri": string,
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  }
}
Поля
id

string

Необязательный параметр. Идентификатор класса билета на мероприятие.

issuerName

string

Необязательно. Название эмитента класса билетов на мероприятие.

localizedIssuerName

object ( LocalizedString )

Необязательно. Локализованное название эмитента класса билета на мероприятие.

logoUri

string

Необязательно. Логотип класса билетов на мероприятие.

eventName

object ( LocalizedString )

Необязательно. Название мероприятия.

venue

object ( EventVenue )

Необязательно. Место проведения мероприятия.

dateTime

object ( EventDateTime )

Необязательно. Информация о дате и времени мероприятия.

hexBackgroundColor

string

Необязательный параметр. Цвет фона для класса билетов на мероприятие. Формат — шестнадцатеричная строка цвета, например, "#RRGGBB".

heroImageUri

string

Необязательно. Изображение баннера, отображаемое на лицевой стороне билета на мероприятие.

classTemplateInfo

object ( ClassTemplateInfo )

Необязательно. Информация о шаблоне, определяющая способ отображения класса билета на мероприятие.

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

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

object ( LocalizedString )

Необязательно. Название места проведения.

address

object ( LocalizedString )

Необязательно. Адрес места проведения мероприятия.

Дата и время события

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

string

Необязательно. Дата/время начала события. Если событие длится несколько дней, следует указать дату/время начала первого дня. Формат — расширенный формат даты/времени ISO 8601 без смещения, время может быть указано с точностью до миллисекунды, например, 2027-03-05T06:30:00.

end

string

Необязательно. Дата/время окончания события. Если событие длится несколько дней, следует указать дату/время окончания в последний день. Формат — расширенный формат даты/времени ISO 8601 без смещения, время может быть указано с точностью до миллисекунды, например, 2027-03-05T06:30:00.

FlightClass

JSON-представление 
{
  "id": string,
  "issuerName": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "flightHeader": {
    object (FlightHeader)
  },
  "origin": {
    object (AirportInfo)
  },
  "destination": {
    object (AirportInfo)
  },
  "localScheduledDepartureDateTime": string,
  "hexBackgroundColor": string,
  "heroImageUri": string,
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  }
}
Поля
id

string

Необязательно. Идентификатор класса полета.

issuerName

string

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

localizedIssuerName

object ( LocalizedString )

Необязательно. Локализованное название эмитента авиабилета соответствующего класса.

flightHeader

object ( FlightHeader )

Необязательно. Информация о авиакомпании и номере рейса.

origin

object ( AirportInfo )

Необязательно. Информация об аэропорте отправления.

destination

object ( AirportInfo )

Необязательно. Информация об аэропорте назначения.

localScheduledDepartureDateTime

string

Необязательно. Запланированная дата и время вылета самолета из гейта (а не со взлетно-посадочной полосы). Формат — расширенный формат даты/времени ISO 8601 без смещения, время может быть указано с точностью до миллисекунды, например, 2027-03-05T06:30:00. Это должно быть местное время в аэропорту (а не время UTC).

hexBackgroundColor

string

Необязательно. Цвет фона класса полета. Формат — шестнадцатеричная строка цвета, например, "#RRGGBB".

heroImageUri

string

Необязательно. Изображение баннера, размещенное на передней части купона на полет.

classTemplateInfo

object ( ClassTemplateInfo )

Необязательно. Информация о шаблоне, определяющая способ отображения класса полета.

Заголовок рейса

JSON-представление 
{
  "carrier": {
    object (FlightCarrier)
  },
  "flightNumber": string
}
Поля
carrier

object ( FlightCarrier )

Необязательно. Информация о авиакомпании.

flightNumber

string

Необязательно. Номер рейса без кода IATA перевозчика. Поле содержит только цифры, например, "123".

Авианосец

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

string

Необязательно. Двухсимвольный код авиакомпании IATA.

carrierIcaoCode

string

Необязательно. Трехсимвольный код авиакомпании ИКАО.

airlineLogoUri

string

(Необязательно) Логотип авиакомпании, соответствующий коду IATA.

AirportInfo

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

string

Необязательно. Трехсимвольный код аэропорта IATA, например, "SFO".

terminal

string

Необязательно. Название терминала, например, "I".

gate

string

Необязательно. Название ворот, например, "B59".

TransitClass

JSON-представление 
{
  "id": string,
  "issuerName": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "hexBackgroundColor": string,
  "heroImageUri": string,
  "transitType": enum (TransitType),
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  }
}
Поля
id

string

Необязательный параметр. Идентификатор транспортного класса.

issuerName

string

Необязательно. Название эмитента транспортного класса.

localizedIssuerName

object ( LocalizedString )

Необязательно. Локализованное название эмитента для класса транзита.

hexBackgroundColor

string

Необязательный параметр. Цвет фона для выбранного класса транспорта. Формат — шестнадцатеричная строка с указанием цвета, например, "#RRGGBB".

heroImageUri

string

Дополнительно. Изображение баннера, отображаемое на лицевой стороне билета в транспортный класс.

transitType

enum ( TransitType )

Необязательно. Тип транспорта, соответствующий классу транспорта.

classTemplateInfo

object ( ClassTemplateInfo )

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

GenericClass

JSON-представление 
{
  "id": string,
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  }
}
Поля
id

string

Необязательный параметр. Идентификатор обобщенного класса.

classTemplateInfo

object ( ClassTemplateInfo )

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

Аннотации инструментов

Подсказка о разрушительном эффекте: ❌ | Подсказка об идемпотентности: ✅ | Подсказка только для чтения: ✅ | Подсказка об открытом мире: ❌