Herramienta: list_pass_classes
Recupera una lista completa de todas las clases de pases registradas en la consola empresarial de la Billetera de Google asociada con el usuario autenticado. Esta herramienta proporciona información esencial para los desarrolladores que administran pases de la Billetera, como tarjetas de lealtad, tarjetas de regalo o vuelos.
En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta de MCP list_pass_classes.
| Solicitud de 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 }' |
Esquema de entrada
Es el mensaje de solicitud para enumerar las clases de pases de un emisor.
ListPassClassesRequest
| Representación JSON |
|---|
{ "issuerId": string, "passType": enum ( |
| Campos | |
|---|---|
issuerId |
Obligatorio. Es el identificador único de la entidad emisora para la que se enumerarán las clases de pases. |
passType |
Opcional. Es el tipo de clase de pase que se incluirá en la lista. Si no se especifica, se devolverán todos los tipos de clases de pases. |
view |
Opcional. Especifica el nivel de detalle que se devolverá para cada clase de pase. |
PassType
Es el tipo de una clase de pase.
| Enums | |
|---|---|
PASS_TYPE_UNSPECIFIED |
No se especificó el tipo de pase. |
LOYALTY |
El tipo de pase es Lealtad. |
GIFT_CARD |
El tipo de pase es Tarjeta de regalo. |
OFFER |
El tipo de pase es Oferta. |
EVENT_TICKET |
El tipo de pase es Event Ticket. |
FLIGHT |
El tipo de pase es Vuelo. |
TRANSIT |
El tipo de pase es de transporte público. |
GENERIC |
El tipo de pase es genérico. |
PassClassView
Es el nivel de detalle que se devolverá para cada clase de pase.
| Enums | |
|---|---|
PASS_CLASS_VIEW_UNSPECIFIED |
Es el valor predeterminado o no establecido. La API usará la vista BASIC de forma predeterminada. |
BASIC |
Incluye información básica sobre la clase de pase. |
FULL |
Incluye todos los detalles sobre la clase de pase. |
Esquema de salida
Es el mensaje de respuesta para enumerar las clases de pases de un emisor.
ListPassClassesResponse
| Representación JSON |
|---|
{
"passClasses": [
{
object ( |
| Campos | |
|---|---|
passClasses[] |
Son las clases de pases de la entidad emisora. |
PassClass
| Representación JSON |
|---|
{ // Union field |
| Campos | |
|---|---|
Campo de unión
|
|
loyaltyClass |
Opcional. Es la clase de lealtad del emisor. |
giftCardClass |
Opcional. Es la clase de tarjeta de regalo del emisor. |
offerClass |
Opcional. Es la clase de oferta del emisor. |
eventTicketClass |
Opcional. Es la clase de entrada para eventos del emisor. |
flightClass |
Opcional. Es la clase de vuelo del emisor. |
transitClass |
Opcional. Es la clase de tránsito del emisor. |
genericClass |
Opcional. Es la clase genérica del emisor. |
LoyaltyClass
| Representación JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Campos | |
|---|---|
id |
Opcional. Es el ID de la clase de lealtad. |
issuerName |
Opcional. Es el nombre de la entidad emisora de la clase de lealtad. |
localizedIssuerName |
Opcional. Es el nombre localizado de la entidad emisora de la clase de lealtad. |
programName |
Opcional. Es el nombre del programa de la clase de lealtad. |
localizedProgramName |
Opcional. Es el nombre del programa localizado de la clase de lealtad. |
programLogoUri |
Opcional. Es el logotipo del programa de la clase de lealtad. |
hexBackgroundColor |
Opcional. Es el color de fondo de la clase de lealtad. El formato es una cadena de color hexadecimal, p.ej., "#RRGGBB". |
heroImageUri |
Opcional. Imagen de banner que se muestra en el frente de la clase de lealtad. |
discoverableProgram |
Opcional. Es la información sobre cómo se puede descubrir e instanciar la clase de lealtad desde la Billetera de Google. |
classTemplateInfo |
Opcional. Es la información de la plantilla sobre cómo se debe mostrar la clase de lealtad. |
LocalizedString
| Representación JSON |
|---|
{ "translatedValues": [ { object ( |
| Campos | |
|---|---|
translatedValues[] |
Opcional. Son los parámetros de cadena traducidos para la cadena. |
defaultValue |
Opcional. Es la cadena que se mostrará si no hay una traducción adecuada disponible. |
TranslatedString
| Representación JSON |
|---|
{ "languageCode": string, "value": string } |
| Campos | |
|---|---|
languageCode |
Opcional. Es la etiqueta de idioma BCP 47. Algunos ejemplos de valores son "en-US", "en-GB", "de" o "de-AT". |
value |
Opcional. Es la cadena traducida codificada en UTF-8. |
DiscoverableProgram
| Representación JSON |
|---|
{ "merchantSignupInfo": { object ( |
| Campos | |
|---|---|
merchantSignupInfo |
Opcional. Es la información sobre la capacidad de registrarse y agregar un valor a este programa detectable a través del sitio de un comercio. |
merchantSigninInfo |
Opcional. Es la información sobre la capacidad de acceder y agregar un valor a este programa detectable a través del sitio de un comercio. |
state |
Solo salida. Es el estado del programa detectable. |
MerchantSignupInfo
| Representación JSON |
|---|
{ "signupWebsite": { object ( |
| Campos | |
|---|---|
signupWebsite |
Opcional. Es el sitio web para registrarse en el programa detectable. |
signupSharedDatas[] |
Opcional. Son los datos del usuario que se envían en una solicitud POST a la URL del sitio web de registro. Esta información se codifica y, luego, se comparte para que el sitio web del comercio pueda completar previamente los campos que se usan para inscribir al usuario en el programa detectable. |
URI
| Representación JSON |
|---|
{
"uri": string,
"description": string,
"localizedDescription": {
object ( |
| Campos | |
|---|---|
uri |
Opcional. Es el URI. |
description |
Opcional. Título del URI que aparece en la Billetera de Google como texto. |
localizedDescription |
Opcional. Son las cadenas traducidas del título del URI que aparecen en la Billetera de Google como texto. |
MerchantSigninInfo
| Representación JSON |
|---|
{
"signinWebsite": {
object ( |
| Campos | |
|---|---|
signinWebsite |
Opcional. Es el sitio web en el que se debe acceder para el programa detectable. |
ClassTemplateInfo
| Representación JSON |
|---|
{ "cardBarcodeSectionDetails": { object ( |
| Campos | |
|---|---|
cardBarcodeSectionDetails |
Opcional. Es la información adicional que se mostrará arriba y debajo del código de barras. |
cardTemplateOverride |
Opcional. Es la anulación de la plantilla para la vista de tarjeta. |
detailsTemplateOverride |
Opcional. Es la anulación de la plantilla para la vista de detalles. |
listTemplateOverride |
Opcional. Es la anulación de plantilla para la vista de lista de pases. |
CardBarcodeSectionDetails
| Representación JSON |
|---|
{ "firstTopDetail": { object ( |
| Campos | |
|---|---|
firstTopDetail |
Opcional. Es la información opcional que se mostrará sobre el código de barras. Si se define secondTopDetail, se mostrará en el lado inicial de esta sección de detalles. |
firstBottomDetail |
Opcional. Es la información opcional que se mostrará debajo del código de barras. |
secondTopDetail |
Opcional. Es la segunda información opcional que se mostrará sobre el código de barras. Si se define firstTopDetail, se mostrará en el lado final de esta sección de detalles. |
BarcodeSectionDetail
| Representación JSON |
|---|
{
"fieldSelector": {
object ( |
| Campos | |
|---|---|
fieldSelector |
Opcional. Es la referencia a un campo existente basado en texto o en imágenes que se mostrará. |
FieldSelector
| Representación JSON |
|---|
{
"fields": [
{
object ( |
| Campos | |
|---|---|
fields[] |
Opcional. Son las referencias de campo que se usarán con las anulaciones de campo. Si se proporciona más de una referencia, se mostrará la primera que haga referencia a un campo no vacío. |
FieldReference
| Representación JSON |
|---|
{
"fieldPath": string,
"dateFormat": enum ( |
| Campos | |
|---|---|
fieldPath |
Opcional. Es la ruta de acceso al campo al que se hace referencia, con el prefijo "object" o "class" y separado por puntos. |
dateFormat |
Opcional. Es el formato de fecha para renderizar los campos de fecha y hora. |
CardTemplateOverride
| Representación JSON |
|---|
{
"cardRowTemplateInfos": [
{
object ( |
| Campos | |
|---|---|
cardRowTemplateInfos[] |
Opcional. Es la información de la plantilla sobre las filas en la vista de tarjeta. Se pueden especificar tres filas como máximo. |
CardRowTemplateInfo
| Representación JSON |
|---|
{ // Union field |
| Campos | |
|---|---|
Campo de unión row_template. Es la plantilla para una fila que contiene uno, dos o tres elementos. row_template puede ser solo uno de los parámetros siguientes: |
|
oneItem |
Opcional. Es la plantilla para una fila que contiene un elemento. |
twoItems |
Opcional. Es la plantilla para una fila que contiene dos elementos. |
threeItems |
Opcional. Es la plantilla para una fila que contiene tres elementos. |
CardRowOneItem
| Representación JSON |
|---|
{
"item": {
object ( |
| Campos | |
|---|---|
item |
Opcional. Es el elemento que se mostrará en la fila. Este elemento se centrará. |
TemplateItem
| Representación JSON |
|---|
{ "firstValue": { object ( |
| Campos | |
|---|---|
firstValue |
Opcional. Es la referencia al primer campo que se mostrará. |
secondValue |
Opcional. Es la referencia al segundo campo que se mostrará. |
predefinedItem |
Opcional. Es el elemento predefinido que se mostrará. |
CardRowTwoItems
| Representación JSON |
|---|
{ "startItem": { object ( |
| Campos | |
|---|---|
startItem |
Opcional. Es el elemento que se mostrará al comienzo de la fila. Este elemento se alineará a la izquierda. |
endItem |
Opcional. Es el elemento que se mostrará al final de la fila. Este elemento se alineará a la derecha. |
CardRowThreeItems
| Representación JSON |
|---|
{ "startItem": { object ( |
| Campos | |
|---|---|
startItem |
Opcional. Es el elemento que se mostrará al comienzo de la fila. Este elemento se alineará a la izquierda. |
middleItem |
Opcional. Es el elemento que se mostrará en el centro de la fila. Este elemento se centrará entre los elementos de inicio y finalización. |
endItem |
Opcional. Es el elemento que se mostrará al final de la fila. Este elemento se alineará a la derecha. |
DetailsTemplateOverride
| Representación JSON |
|---|
{
"detailsItemInfos": [
{
object ( |
| Campos | |
|---|---|
detailsItemInfos[] |
Opcional. Es la información de la plantilla sobre los elementos que se muestran en la lista de detalles. |
DetailsItemInfo
| Representación JSON |
|---|
{
"item": {
object ( |
| Campos | |
|---|---|
item |
Opcional. Es el elemento que se mostrará en la lista de detalles. |
ListTemplateOverride
| Representación JSON |
|---|
{ "firstRowOption": { object ( |
| Campos | |
|---|---|
firstRowOption |
Opcional. Es la referencia al campo que se mostrará en la primera fila. |
secondRowOption |
Opcional. Es la referencia al campo que se mostrará en la segunda fila. |
FirstRowOption
| Representación JSON |
|---|
{ "transitOption": enum ( |
| Campos | |
|---|---|
transitOption |
Opcional. Es la opción de transporte público que se mostrará en la primera fila. |
fieldOption |
Opcional. Es la referencia al campo que se mostrará en la primera fila. |
GiftCardClass
| Representación JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Campos | |
|---|---|
id |
Opcional. Es el ID de la clase de tarjeta de regalo. |
issuerName |
Opcional. Es el nombre de la entidad emisora de la clase de tarjeta de regalo. |
localizedIssuerName |
Opcional. Es el nombre localizado de la entidad emisora de la clase de tarjeta de regalo. |
merchantName |
Opcional. Es el nombre del comercio de la clase de tarjeta de regalo. |
localizedMerchantName |
Opcional. Es el nombre localizado del comercio de la clase de tarjeta de regalo. |
programLogoUri |
Opcional. Es el logotipo del programa de la clase de tarjeta de regalo. |
hexBackgroundColor |
Opcional. Es el color de fondo de la clase de tarjeta de regalo. El formato es una cadena de color hexadecimal, p.ej., "#RRGGBB". |
heroImageUri |
Opcional. Es la imagen del banner que se muestra en el frente de la clase de la tarjeta de regalo. |
homePageUri |
Opcional. Es el sitio web de la página principal de la aplicación. |
classTemplateInfo |
Opcional. Es la información de la plantilla sobre cómo se debe mostrar la clase de tarjeta de regalo. |
OfferClass
| Representación JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Campos | |
|---|---|
id |
Opcional. Es el ID de la clase de oferta. |
issuerName |
Opcional. Es el nombre de la entidad emisora de la clase de oferta. |
localizedIssuerName |
Opcional. Es el nombre localizado de la entidad emisora de la clase de oferta. |
provider |
Opcional. Es el proveedor de la clase de oferta. |
localizedProvider |
Opcional. Es el proveedor localizado de la clase de oferta. |
title |
Opcional. Es el título de la clase de oferta. |
localizedTitle |
Opcional. Es el título localizado de la clase de oferta. |
titleImageUri |
Opcional. Es la imagen de título de la clase de oferta. |
hexBackgroundColor |
Opcional. Es el color de fondo de la clase de oferta. El formato es una cadena de color hexadecimal, p.ej., "#RRGGBB". |
heroImageUri |
Opcional. Es la imagen de banner que se muestra en el frente de la clase de oferta. |
redemptionChannel |
Opcional. Es el canal de canje de la clase de oferta. |
classTemplateInfo |
Opcional. Es la información de la plantilla sobre cómo se debe mostrar la clase de oferta. |
EventTicketClass
| Representación JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Campos | |
|---|---|
id |
Opcional. Es el ID de la clase de entrada para evento. |
issuerName |
Opcional. Es el nombre de la entidad emisora de la clase de entrada para evento. |
localizedIssuerName |
Opcional. Es el nombre localizado de la entidad emisora de la clase de entrada para evento. |
logoUri |
Opcional. Es el logotipo de la clase de entrada para eventos. |
eventName |
Opcional. El nombre del evento |
venue |
Opcional. Es el lugar del evento. |
dateTime |
Opcional. Es la información sobre la fecha y hora del evento. |
hexBackgroundColor |
Opcional. Es el color de fondo de la clase de entrada para evento. El formato es una cadena de color hexadecimal, p.ej., "#RRGGBB". |
heroImageUri |
Opcional. Es la imagen del banner que se muestra en el frente de la clase de entrada para evento. |
classTemplateInfo |
Opcional. Es la información de la plantilla sobre cómo se debe mostrar la clase de entrada para el evento. |
EventVenue
| Representación JSON |
|---|
{ "name": { object ( |
| Campos | |
|---|---|
name |
Opcional. Es el nombre del establecimiento. |
address |
Opcional. Dirección del lugar |
EventDateTime
| Representación JSON |
|---|
{ "start": string, "end": string } |
| Campos | |
|---|---|
start |
Opcional. Fecha y hora en que comienza el evento. Si el evento abarca varios días, debe ser la fecha y hora de inicio del primer día. El formato es una fecha y hora en formato extendido ISO 8601 sin desfase, y la hora se puede especificar con una precisión de hasta milisegundos, p.ej., 2027-03-05T06:30:00. |
end |
Opcional. Fecha y hora en que finaliza el evento. Si el evento abarca varios días, debe ser la fecha y hora de finalización del último día. El formato es una fecha y hora en formato extendido ISO 8601 sin desfase, y la hora se puede especificar con una precisión de hasta milisegundos, p.ej., 2027-03-05T06:30:00. |
FlightClass
| Representación JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Campos | |
|---|---|
id |
Opcional. Es el ID de la clase de vuelo. |
issuerName |
Opcional. Es el nombre de la entidad emisora de la clase de vuelo. |
localizedIssuerName |
Opcional. Es el nombre localizado de la entidad emisora de la clase de vuelo. |
flightHeader |
Opcional. Es la información sobre la aerolínea y el número de vuelo. |
origin |
Opcional. Es la información sobre el aeropuerto de origen. |
destination |
Opcional. Es la información sobre el aeropuerto de destino. |
localScheduledDepartureDateTime |
Opcional. Fecha y hora programadas en las que se espera que la aeronave salga de la puerta (no de la pista). El formato es una fecha y hora en formato extendido ISO 8601 sin desfase, y la hora se puede especificar con una precisión de hasta milisegundos, p.ej., 2027-03-05T06:30:00. Debe ser la fecha y hora locales del aeropuerto (no una hora en UTC). |
hexBackgroundColor |
Opcional. Es el color de fondo de la clase de vuelo. El formato es una cadena de color hexadecimal, p.ej., "#RRGGBB". |
heroImageUri |
Opcional. Es la imagen de banner que se muestra en el frente de la clase de vuelo. |
classTemplateInfo |
Opcional. Es la información de la plantilla sobre cómo se debe mostrar la clase de vuelo. |
FlightHeader
| Representación JSON |
|---|
{
"carrier": {
object ( |
| Campos | |
|---|---|
carrier |
Opcional. Es la información sobre la aerolínea. |
flightNumber |
Opcional. Código de vuelo sin el código IATA de la aerolínea. El campo solo contiene dígitos, p.ej., "123". |
FlightCarrier
| Representación JSON |
|---|
{ "carrierIataCode": string, "carrierIcaoCode": string, "airlineLogoUri": string } |
| Campos | |
|---|---|
carrierIataCode |
Opcional. Es el código de aerolínea IATA de dos caracteres de la aerolínea. |
carrierIcaoCode |
Opcional. Es el código de aerolínea de la OACI de tres caracteres de la aerolínea. |
airlineLogoUri |
Opcional. Es el logotipo de la aerolínea que se describe con el código IATA de la aerolínea. |
AirportInfo
| Representación JSON |
|---|
{ "airportIataCode": string, "terminal": string, "gate": string } |
| Campos | |
|---|---|
airportIataCode |
Opcional. Código de aeropuerto IATA de tres caracteres, p.ej., "SFO". |
terminal |
Opcional. Nombre de la terminal, p.ej., "I". |
gate |
Opcional. Nombre de la puerta, p.ej., "B59". |
TransitClass
| Representación JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Campos | |
|---|---|
id |
Opcional. Es el ID de la clase de tránsito. |
issuerName |
Opcional. Es el nombre de la entidad emisora de la clase de tránsito. |
localizedIssuerName |
Opcional. Es el nombre localizado de la entidad emisora de la clase de transporte público. |
hexBackgroundColor |
Opcional. Es el color de fondo de la clase de tránsito. El formato es una cadena de color hexadecimal, p.ej., "#RRGGBB". |
heroImageUri |
Opcional. Es la imagen de banner que se muestra en el frente de la clase de tránsito. |
transitType |
Opcional. Es el tipo de transporte público de la clase de transporte público. |
classTemplateInfo |
Opcional. Es la información de la plantilla sobre cómo se debe mostrar la clase de tránsito. |
GenericClass
| Representación JSON |
|---|
{
"id": string,
"classTemplateInfo": {
object ( |
| Campos | |
|---|---|
id |
Opcional. Es el ID de la clase genérica. |
classTemplateInfo |
Opcional. Es la información de la plantilla sobre cómo se debe mostrar la clase genérica. |
| Enums | |
|---|---|
SHARED_DATA_TYPE_UNSPECIFIED |
|
FIRST_NAME |
Es el nombre del usuario. |
LAST_NAME |
|
STREET_ADDRESS |
Es la dirección del usuario en una sola línea. |
ADDRESS_LINE_ONE |
Es la dirección del usuario en varias líneas. |
ADDRESS_LINE_TWO |
|
ADDRESS_LINE_THREE |
|
CITY |
|
STATE |
|
ZIPCODE |
|
COUNTRY |
|
EMAIL |
|
PHONE |
|
Estado
Es el estado del programa detectable.
| Enums | |
|---|---|
STATE_UNSPECIFIED |
El estado no se especifica. |
TRUSTED_TESTERS |
El programa solo es visible para los verificadores que tienen acceso a la cuenta de la entidad emisora. |
LIVE |
El programa es visible para todos los usuarios. |
DISABLED |
El programa no es visible. |
DateFormat
Es el formato de fecha para renderizar los campos de fecha y hora.
| Enums | |
|---|---|
DATE_FORMAT_UNSPECIFIED |
El formato de fecha no está especificado. |
DATE_TIME |
Por ejemplo, 2018-12-14T13:00:00 se renderiza como el 14 de diciembre a la 1:00 p.m. en en_US. |
DATE_ONLY |
P.ej., renderiza 2018-12-14T13:00:00 como el 14 de diciembre en es_US. |
TIME_ONLY |
p. ej., renderiza 2018-12-14T13:00:00 como 1:00 p.m. en en_US. |
DATE_TIME_YEAR |
Por ejemplo, renderiza 2018-12-14T13:00:00 como el 14 de diciembre de 2018, a la 1:00 p.m. en es-US. |
DATE_YEAR |
Por ejemplo, renderiza 2018-12-14T13:00:00 como el 14 de diciembre de 2018 en en_US. |
YEAR_MONTH |
p.ej., renderiza 2018-12-14T13:00:00 como 2018-12 en en_US. |
YEAR_MONTH_DAY |
p.ej., 2018-12-14T13:00:00 se renderiza como 2018-12-14 en en_US. |
PredefinedItem
Es el elemento predefinido que se mostrará.
| Enums | |
|---|---|
PREDEFINED_ITEM_UNSPECIFIED |
El elemento predefinido no está especificado. |
FREQUENT_FLYER_PROGRAM_NAME_AND_NUMBER |
El elemento predefinido es el nombre y el número de un programa de viajero frecuente. |
FLIGHT_NUMBER_AND_OPERATING_FLIGHT_NUMBER |
El elemento predefinido es un código de vuelo y un código de vuelo operativo. |
TransitOption
Es la opción de transporte público que se mostrará.
| Enums | |
|---|---|
TRANSIT_OPTION_UNSPECIFIED |
No se especificó la opción de transporte público. |
ORIGIN_AND_DESTINATION_NAMES |
La opción de transporte público son los nombres de origen y destino. |
ORIGIN_AND_DESTINATION_CODES |
La opción de transporte público son los códigos de origen y destino. |
ORIGIN_NAME |
La opción de transporte público es el nombre del origen. |
RedemptionChannel
Son los canales de canje aplicables a esta oferta.
| Enums | |
|---|---|
REDEMPTION_CHANNEL_UNSPECIFIED |
No se especificó el canal de canje. |
IN_STORE |
La oferta solo se puede canjear en la tienda. |
ONLINE |
La oferta solo se puede canjear en línea. |
BOTH |
La oferta se puede canjear en la tienda o en línea. |
TEMPORARY_PRICE_REDUCTION |
La oferta es una reducción de precio temporal. |
TransitType
Es el tipo de transporte público de la clase de transporte público.
| Enums | |
|---|---|
TRANSIT_TYPE_UNSPECIFIED |
No se especificó el tipo de transporte público. |
BUS |
El tipo de transporte público es autobús. |
RAIL |
El tipo de transporte público es tren. |
TRAM |
El tipo de transporte público es tranvía. |
FERRY |
El tipo de transporte público es ferry. |
FLIGHT |
El tipo de transporte público es vuelo. |
OTHER |
El tipo de transporte público es otro. |
Anotaciones de herramientas
Sugerencia destructiva: ❌ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌