MCP Tools Reference: paydeveloper.googleapis.com

Narzędzie: list_pass_classes

Pobiera pełną listę wszystkich klas kart zarejestrowanych w konsoli biznesowej Portfela Google powiązanej z uwierzytelnionym użytkownikiem. To narzędzie zawiera niezbędne informacje dla programistów zarządzających kartami w Portfelu, takimi jak karty lojalnościowe, karty podarunkowe czy karty pokładowe.

Poniższy przykładowy kod pokazuje, jak używać curl do wywoływania narzędzia list_pass_classes MCP.

Żądanie 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 MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schemat danych wejściowych

Wiadomość z prośbą o wyświetlenie klas kart wydanych przez wystawcę.

ListPassClassesRequest

Zapis JSON
{
  "issuerId": string,
  "passType": enum (PassType),
  "view": enum (PassClassView)
}
Pola
issuerId

string (int64 format)

Wymagane. Unikalny identyfikator wydawcy, dla którego chcesz wyświetlić listę klas kart.

passType

enum (PassType)

Opcjonalnie. Typ klasy karnetu do wyświetlenia. Jeśli nie zostanie określony, zostaną zwrócone wszystkie typy klas kart.

view

enum (PassClassView)

Opcjonalnie. Określa poziom szczegółowości, który ma być zwracany w przypadku każdej klasy karty.

PassType

Typ klasy karty.

Wartości w polu enum
PASS_TYPE_UNSPECIFIED Typ karty nie jest określony.
LOYALTY Typ karty to Loyalty.
GIFT_CARD Typ karty to karta podarunkowa.
OFFER Typ karty to Oferta.
EVENT_TICKET Typ karty to bilet na wydarzenie.
FLIGHT Typ karty to Lot.
TRANSIT Typ dokumentu to Transport publiczny.
GENERIC Typ przepustki: Ogólny.

PassClassView

Poziom szczegółowości, który ma być zwracany dla każdej klasy karty.

Wartości w polu enum
PASS_CLASS_VIEW_UNSPECIFIED Wartość domyślna lub nieokreślona. Interfejs API domyślnie wybierze widok PODSTAWOWY.
PASS_CLASS_VIEW_BASIC Podaj podstawowe informacje o rodzaju karty.
PASS_CLASS_VIEW_FULL Podaj wszystkie szczegóły dotyczące zajęć w ramach karnetu.

Schemat wyjściowy

Wiadomość z odpowiedzią na żądanie wyświetlenia klas kart wydawcy.

ListPassClassesResponse

Zapis JSON
{
  "passClasses": [
    {
      object (PassClass)
    }
  ]
}
Pola
passClasses[]

object (PassClass)

Klasy kart niepłatniczych wydawcy.

PassClass

Zapis 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.
}
Pola

Pole zbiorcze resource.

Pole resource może mieć tylko jedną z tych wartości:

loyaltyClass

object (LoyaltyClass)

Opcjonalnie. Klasa lojalności wystawcy.

giftCardClass

object (GiftCardClass)

Opcjonalnie. Klasa karty podarunkowej wydawcy.

offerClass

object (OfferClass)

Opcjonalnie. Klasa oferty specjalnej wydawcy.

eventTicketClass

object (EventTicketClass)

Opcjonalnie. Klasa biletu na wydarzenie wydawcy.

flightClass

object (FlightClass)

Opcjonalnie. Klasa lotu wydawcy.

transitClass

object (TransitClass)

Opcjonalnie. Klasa przejściowa wydawcy.

genericClass

object (GenericClass)

Opcjonalnie. Ogólna klasa wydawcy.

LoyaltyClass

Zapis 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)
  }
}
Pola
id

string

Opcjonalnie. Identyfikator klasy programu lojalnościowego.

issuerName

string

Opcjonalnie. Nazwa wystawcy klasy lojalnościowej.

localizedIssuerName

object (LocalizedString)

Opcjonalnie. Zlokalizowana nazwa wydawcy klasy lojalnościowej.

programName

string

Opcjonalnie. Nazwa programu klasy lojalnościowej.

localizedProgramName

object (LocalizedString)

Opcjonalnie. Zlokalizowana nazwa programu klasy lojalnościowej.

programLogoUri

string

Opcjonalnie. Logo programu klasy lojalnościowej.

hexBackgroundColor

string

Opcjonalnie. Kolor tła klasy programu lojalnościowego. Format to szesnastkowy ciąg znaków koloru, np. „#RRGGBB”.

heroImageUri

string

Opcjonalnie. Obraz banera wyświetlany z przodu klasy programu lojalnościowego.

discoverableProgram

object (DiscoverableProgram)

Opcjonalnie. Informacje o tym, jak można wykryć klasę lojalnościową i utworzyć jej instancję z poziomu Portfela Google.

classTemplateInfo

object (ClassTemplateInfo)

Opcjonalnie. Informacje na temat szablonu wyświetlania klasy karty lojalnościowej.

LocalizedString

Zapis JSON
{
  "translatedValues": [
    {
      object (TranslatedString)
    }
  ],
  "defaultValue": {
    object (TranslatedString)
  }
}
Pola
translatedValues[]

object (TranslatedString)

Opcjonalnie. Przetłumaczone ciągi znaków.

defaultValue

object (TranslatedString)

Opcjonalnie. Ciąg znaków, który zostanie wyświetlony, jeśli nie będzie dostępne żadne odpowiednie tłumaczenie.

TranslatedString

Zapis JSON
{
  "languageCode": string,
  "value": string
}
Pola
languageCode

string

Opcjonalnie. Tag języka BCP 47. Przykładowe wartości to „en-US”, „en-GB”, „de” lub „de-AT”.

value

string

Opcjonalnie. Przetłumaczony ciąg znaków zakodowany w UTF-8.

DiscoverableProgram

Zapis JSON
{
  "merchantSignupInfo": {
    object (MerchantSignupInfo)
  },
  "merchantSigninInfo": {
    object (MerchantSigninInfo)
  },
  "state": enum (State)
}
Pola
merchantSignupInfo

object (MerchantSignupInfo)

Opcjonalnie. Informacje o możliwości rejestracji i dodania przedmiotu wartościowego do tego wykrywalnego programu za pośrednictwem witryny sprzedawcy.

merchantSigninInfo

object (MerchantSigninInfo)

Opcjonalnie. Informacje o możliwości logowania i dodawania wartości na potrzeby tego programu za pośrednictwem witryny sprzedawcy.

state

enum (State)

Tylko dane wyjściowe. Stan wykrywalnego programu.

MerchantSignupInfo

Zapis JSON
{
  "signupWebsite": {
    object (Uri)
  },
  "signupSharedDatas": [
    enum (SharedDataType)
  ]
}
Pola
signupWebsite

object (Uri)

Opcjonalnie. Witryna, w której można zarejestrować się w wykrywalnym programie.

signupSharedDatas[]

enum (SharedDataType)

Opcjonalnie. Dane użytkownika wysyłane w żądaniu POST na adres URL witryny rejestracji. Informacje te są kodowane, a następnie udostępniane, dzięki czemu witryna sprzedawcy może wstępnie wypełnić pola używane do zarejestrowania użytkownika w wykrywalnym programie.

Uri

Zapis JSON
{
  "uri": string,
  "description": string,
  "localizedDescription": {
    object (LocalizedString)
  }
}
Pola
uri

string

Opcjonalnie. Identyfikator URI.

description

string

Opcjonalnie. Tytuł identyfikatora URI wyświetlany w Portfelu Google jako tekst.

localizedDescription

object (LocalizedString)

Opcjonalnie. Przetłumaczone ciągi tytułu identyfikatora URI wyświetlane w Portfelu Google jako tekst.

MerchantSigninInfo

Zapis JSON
{
  "signinWebsite": {
    object (Uri)
  }
}
Pola
signinWebsite

object (Uri)

Opcjonalnie. Witryna, w której można się zalogować w wykrywalnym programie.

ClassTemplateInfo

Zapis JSON
{
  "cardBarcodeSectionDetails": {
    object (CardBarcodeSectionDetails)
  },
  "cardTemplateOverride": {
    object (CardTemplateOverride)
  },
  "detailsTemplateOverride": {
    object (DetailsTemplateOverride)
  },
  "listTemplateOverride": {
    object (ListTemplateOverride)
  }
}
Pola
cardBarcodeSectionDetails

object (CardBarcodeSectionDetails)

Opcjonalnie. Dodatkowe informacje, które mają być wyświetlane powyżej i poniżej kodu kreskowego.

cardTemplateOverride

object (CardTemplateOverride)

Opcjonalnie. Nadpisanie szablonu dla widoku karty.

detailsTemplateOverride

object (DetailsTemplateOverride)

Opcjonalnie. Nadpisanie szablonu dla widoku szczegółów.

listTemplateOverride

object (ListTemplateOverride)

Opcjonalnie. Zastąpienie szablonu dla widoku listy kart.

CardBarcodeSectionDetails

Zapis JSON
{
  "firstTopDetail": {
    object (BarcodeSectionDetail)
  },
  "firstBottomDetail": {
    object (BarcodeSectionDetail)
  },
  "secondTopDetail": {
    object (BarcodeSectionDetail)
  }
}
Pola
firstTopDetail

object (BarcodeSectionDetail)

Opcjonalnie. Opcjonalne informacje do wyświetlenia nad kodem kreskowym. Zdefiniowane secondTopDetail będą wyświetlane na początku tej sekcji szczegółów.

firstBottomDetail

object (BarcodeSectionDetail)

Opcjonalnie. Opcjonalne informacje, które mają być wyświetlane pod kodem kreskowym.

secondTopDetail

object (BarcodeSectionDetail)

Opcjonalnie. Opcjonalny drugi element informacji do wyświetlenia nad kodem kreskowym. Jeśli zdefiniowano parametr firstTopDetail, zostanie on wyświetlony na końcu sekcji szczegółów.

BarcodeSectionDetail

Zapis JSON
{
  "fieldSelector": {
    object (FieldSelector)
  }
}
Pola
fieldSelector

object (FieldSelector)

Opcjonalnie. Odwołanie do istniejącego pola tekstowego lub obrazu do wyświetlenia.

FieldSelector

Zapis JSON
{
  "fields": [
    {
      object (FieldReference)
    }
  ]
}
Pola
fields[]

object (FieldReference)

Opcjonalnie. Odwołania do pól, które mają być używane z zastąpieniami pól. Jeśli podano więcej niż jedno odwołanie, zostanie wyświetlone pierwsze, które odwołuje się do niepustego pola.

FieldReference

Zapis JSON
{
  "fieldPath": string,
  "dateFormat": enum (DateFormat)
}
Pola
fieldPath

string

Opcjonalnie. Ścieżka do pola, do którego następuje odwołanie, z prefiksem „object” lub „class” i rozdzielona kropkami.

dateFormat

enum (DateFormat)

Opcjonalnie. Format daty do renderowania pól daty i godziny.

CardTemplateOverride

Zapis JSON
{
  "cardRowTemplateInfos": [
    {
      object (CardRowTemplateInfo)
    }
  ]
}
Pola
cardRowTemplateInfos[]

object (CardRowTemplateInfo)

Opcjonalnie. Informacje szablonowe dotyczące wierszy w widoku karty. Maksymalnie można określić trzy wiersze.

CardRowTemplateInfo

Zapis 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.
}
Pola
Pole zbiorcze row_template. Szablon dla wiersza zawierającego 1, 2 lub 3 elementy. row_template może mieć tylko jedną z tych wartości:
oneItem

object (CardRowOneItem)

Opcjonalnie. Szablon wiersza zawierającego jeden element.

twoItems

object (CardRowTwoItems)

Opcjonalnie. Szablon wiersza zawierającego dwa elementy.

threeItems

object (CardRowThreeItems)

Opcjonalnie. Szablon dla wiersza zawierającego trzy elementy.

CardRowOneItem

Zapis JSON
{
  "item": {
    object (TemplateItem)
  }
}
Pola
item

object (TemplateItem)

Opcjonalnie. Element do wyświetlenia w wierszu. Ten element zostanie wyśrodkowany.

TemplateItem

Zapis JSON
{
  "firstValue": {
    object (FieldSelector)
  },
  "secondValue": {
    object (FieldSelector)
  },
  "predefinedItem": enum (PredefinedItem)
}
Pola
firstValue

object (FieldSelector)

Opcjonalnie. Odwołanie do pierwszego pola do wyświetlenia.

secondValue

object (FieldSelector)

Opcjonalnie. Odniesienie do drugiego pola, które ma zostać wyświetlone.

predefinedItem

enum (PredefinedItem)

Opcjonalnie. Wstępnie zdefiniowany element do wyświetlenia.

CardRowTwoItems

Zapis JSON
{
  "startItem": {
    object (TemplateItem)
  },
  "endItem": {
    object (TemplateItem)
  }
}
Pola
startItem

object (TemplateItem)

Opcjonalnie. Element do wyświetlenia na początku wiersza. Ten element będzie wyrównany do lewej.

endItem

object (TemplateItem)

Opcjonalnie. Element do wyświetlenia na końcu wiersza. Ten element będzie wyrównany do prawej.

CardRowThreeItems

Zapis JSON
{
  "startItem": {
    object (TemplateItem)
  },
  "middleItem": {
    object (TemplateItem)
  },
  "endItem": {
    object (TemplateItem)
  }
}
Pola
startItem

object (TemplateItem)

Opcjonalnie. Element do wyświetlenia na początku wiersza. Ten element będzie wyrównany do lewej.

middleItem

object (TemplateItem)

Opcjonalnie. Element do wyświetlenia w środku wiersza. Ten element będzie wyśrodkowany między elementem początkowym i końcowym.

endItem

object (TemplateItem)

Opcjonalnie. Element do wyświetlenia na końcu wiersza. Ten element będzie wyrównany do prawej.

DetailsTemplateOverride

Zapis JSON
{
  "detailsItemInfos": [
    {
      object (DetailsItemInfo)
    }
  ]
}
Pola
detailsItemInfos[]

object (DetailsItemInfo)

Opcjonalnie. Informacje szablonowe dotyczące elementów wyświetlanych na liście szczegółów.

DetailsItemInfo

Zapis JSON
{
  "item": {
    object (TemplateItem)
  }
}
Pola
item

object (TemplateItem)

Opcjonalnie. Element do wyświetlenia na liście szczegółów.

ListTemplateOverride

Zapis JSON
{
  "firstRowOption": {
    object (FirstRowOption)
  },
  "secondRowOption": {
    object (FieldSelector)
  }
}
Pola
firstRowOption

object (FirstRowOption)

Opcjonalnie. Odwołanie do pola wyświetlanego w pierwszym wierszu.

secondRowOption

object (FieldSelector)

Opcjonalnie. Odwołanie do pola wyświetlanego w drugim wierszu.

FirstRowOption

Zapis JSON
{
  "transitOption": enum (TransitOption),
  "fieldOption": {
    object (FieldSelector)
  }
}
Pola
transitOption

enum (TransitOption)

Opcjonalnie. Opcja transportu publicznego, która ma być wyświetlana w pierwszym wierszu.

fieldOption

object (FieldSelector)

Opcjonalnie. Odwołanie do pola wyświetlanego w pierwszym wierszu.

GiftCardClass

Zapis 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)
  }
}
Pola
id

string

Opcjonalnie. Identyfikator klasy karty podarunkowej.

issuerName

string

Opcjonalnie. Nazwa wydawcy klasy karty podarunkowej.

localizedIssuerName

object (LocalizedString)

Opcjonalnie. Zlokalizowana nazwa wydawcy klasy karty podarunkowej.

merchantName

string

Opcjonalnie. Nazwa sprzedawcy klasy karty podarunkowej.

localizedMerchantName

object (LocalizedString)

Opcjonalnie. Zlokalizowana nazwa sprzedawcy klasy karty podarunkowej.

programLogoUri

string

Opcjonalnie. Logo programu klasy karty podarunkowej.

hexBackgroundColor

string

Opcjonalnie. Kolor tła klasy karty podarunkowej. Format to szesnastkowy ciąg znaków koloru, np. „#RRGGBB”.

heroImageUri

string

Opcjonalnie. Obraz banera wyświetlany z przodu karty podarunkowej.

homePageUri

object (Uri)

Opcjonalnie. Strona internetowa strony głównej aplikacji.

classTemplateInfo

object (ClassTemplateInfo)

Opcjonalnie. Informacje na temat szablonu wyświetlania klasy karty podarunkowej.

OfferClass

Zapis 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)
  }
}
Pola
id

string

Opcjonalnie. Identyfikator klasy oferty.

issuerName

string

Opcjonalnie. Nazwa wydawcy klasy oferty.

localizedIssuerName

object (LocalizedString)

Opcjonalnie. Zlokalizowana nazwa wydawcy klasy oferty.

provider

string

Opcjonalnie. Dostawca klasy oferty.

localizedProvider

object (LocalizedString)

Opcjonalnie. Zlokalizowany dostawca klasy oferty.

title

string

Opcjonalnie. Nazwa klasy oferty.

localizedTitle

object (LocalizedString)

Opcjonalnie. Zlokalizowany tytuł klasy oferty.

titleImageUri

string

Opcjonalnie. Zdjęcie tytułowe klasy oferty.

hexBackgroundColor

string

Opcjonalnie. Kolor tła klasy oferty. Format to szesnastkowy ciąg znaków koloru, np. „#RRGGBB”.

heroImageUri

string

Opcjonalnie. Obraz banera wyświetlany z przodu klasy oferty.

redemptionChannel

enum (RedemptionChannel)

Opcjonalnie. Kanał realizacji klasy oferty.

classTemplateInfo

object (ClassTemplateInfo)

Opcjonalnie. Informacje szablonu o tym, jak powinna być wyświetlana klasa oferty.

EventTicketClass

Zapis 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)
  }
}
Pola
id

string

Opcjonalnie. Identyfikator klasy biletu na wydarzenie.

issuerName

string

Opcjonalnie. Nazwa wydawcy klasy biletu na wydarzenie.

localizedIssuerName

object (LocalizedString)

Opcjonalnie. Zlokalizowana nazwa wydawcy klasy biletu na wydarzenie.

logoUri

string

Opcjonalnie. Logo klasy biletu na wydarzenie.

eventName

object (LocalizedString)

Opcjonalnie. Nazwa zdarzenia.

venue

object (EventVenue)

Opcjonalnie. Miejsce wydarzenia.

dateTime

object (EventDateTime)

Opcjonalnie. Informacje o dacie i godzinie wydarzenia.

hexBackgroundColor

string

Opcjonalnie. Kolor tła klasy biletu na wydarzenie. Format to szesnastkowy ciąg znaków koloru, np. „#RRGGBB”.

heroImageUri

string

Opcjonalnie. Obraz banera wyświetlany z przodu klasy biletu na wydarzenie.

classTemplateInfo

object (ClassTemplateInfo)

Opcjonalnie. Informacje na temat szablonu wyświetlania klasy biletu na wydarzenie.

EventVenue

Zapis JSON
{
  "name": {
    object (LocalizedString)
  },
  "address": {
    object (LocalizedString)
  }
}
Pola
name

object (LocalizedString)

Opcjonalnie. Nazwa obiektu.

address

object (LocalizedString)

Opcjonalnie. Adres miejsca.

EventDateTime

Zapis JSON
{
  "start": string,
  "end": string
}
Pola
start

string

Opcjonalnie. Data i godzina rozpoczęcia wydarzenia. Jeżeli wydarzenie trwa kilka dni, należy podać datę i godzinę rozpoczęcia pierwszego dnia. Jest to data i godzina w rozszerzonym formacie ISO 8601 bez przesunięcia.Godzinę można określić z dokładnością do milisekundy, np. 2027-03-05T06:30:00.

end

string

Opcjonalnie. Data i godzina zakończenia wydarzenia. Jeżeli wydarzenie trwa kilka dni, należy podać datę i godzinę zakończenia ostatniego dnia. Jest to data i godzina w rozszerzonym formacie ISO 8601 bez przesunięcia.Godzinę można określić z dokładnością do milisekundy, np. 2027-03-05T06:30:00.

FlightClass

Zapis 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)
  }
}
Pola
id

string

Opcjonalnie. Identyfikator klasy lotu.

issuerName

string

Opcjonalnie. Nazwa wydawcy klasy lotu.

localizedIssuerName

object (LocalizedString)

Opcjonalnie. Zlokalizowana nazwa wydawcy klasy lotu.

flightHeader

object (FlightHeader)

Opcjonalnie. Informacje o przewoźniku lotniczym i numerze lotu.

origin

object (AirportInfo)

Opcjonalnie. Informacje o lotnisku początkowym.

destination

object (AirportInfo)

Opcjonalnie. Informacje o lotnisku docelowym.

localScheduledDepartureDateTime

string

Opcjonalnie. Planowana data i godzina odejścia samolotu od bramki (ale nie opuszczenia pasa startowego). Jest to data i godzina w rozszerzonym formacie ISO 8601 bez przesunięcia.Godzinę można określić z dokładnością do milisekundy, np. 2027-03-05T06:30:00. Powinny to być lokalna data i godzina na lotnisku (a nie czas UTC).

hexBackgroundColor

string

Opcjonalnie. Kolor tła klasy lotu. Format to szesnastkowy ciąg znaków koloru, np. „#RRGGBB”.

heroImageUri

string

Opcjonalnie. Obraz banera wyświetlany z przodu zajęć.

classTemplateInfo

object (ClassTemplateInfo)

Opcjonalnie. Informacje na temat szablonu wyświetlania klasy lotu.

FlightHeader

Zapis JSON
{
  "carrier": {
    object (FlightCarrier)
  },
  "flightNumber": string
}
Pola
carrier

object (FlightCarrier)

Opcjonalnie. Informacje o przewoźniku lotniczym.

flightNumber

string

Opcjonalnie. Numer lotu bez kodu IATA przewoźnika. Pole zawiera tylko cyfry, np. „123”.

FlightCarrier

Zapis JSON
{
  "carrierIataCode": string,
  "carrierIcaoCode": string,
  "airlineLogoUri": string
}
Pola
carrierIataCode

string

Opcjonalnie. Dwuznakowy kod IATA linii lotniczej przewoźnika.

carrierIcaoCode

string

Opcjonalnie. Trzyznakowy kod ICAO linii lotniczej przewoźnika.

airlineLogoUri

string

Opcjonalnie. Logo linii lotniczej opisanej przez kod IATA przewoźnika.

AirportInfo

Zapis JSON
{
  "airportIataCode": string,
  "terminal": string,
  "gate": string
}
Pola
airportIataCode

string

Opcjonalnie. Trzyznakowy kod IATA lotniska, np. „SFO”.

terminal

string

Opcjonalnie. Nazwa terminala, np. „I”.

gate

string

Opcjonalnie. Nazwa bramki, np. „B59”.

TransitClass

Zapis JSON
{
  "id": string,
  "issuerName": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "hexBackgroundColor": string,
  "heroImageUri": string,
  "transitType": enum (TransitType),
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  }
}
Pola
id

string

Opcjonalnie. Identyfikator klasy biletu.

issuerName

string

Opcjonalnie. Nazwa wydawcy klasy transportu publicznego.

localizedIssuerName

object (LocalizedString)

Opcjonalnie. Zlokalizowana nazwa wystawcy klasy tranzytowej.

hexBackgroundColor

string

Opcjonalnie. Kolor tła klasy transportu publicznego. Format to szesnastkowy ciąg znaków koloru, np. „#RRGGBB”.

heroImageUri

string

Opcjonalnie. Obraz banera wyświetlany z przodu karty transportu publicznego.

transitType

enum (TransitType)

Opcjonalnie. Rodzaj transportu w klasie transportu publicznego.

classTemplateInfo

object (ClassTemplateInfo)

Opcjonalnie. Informacje na temat szablonu wyświetlania klasy transportu publicznego.

GenericClass

Zapis JSON
{
  "id": string,
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  }
}
Pola
id

string

Opcjonalnie. Identyfikator klasy generycznej.

classTemplateInfo

object (ClassTemplateInfo)

Opcjonalnie. Informacje na temat szablonu wyświetlania klasy ogólnej.

SharedDataType

Rodzaj danych użytkownika, które mają być udostępniane sprzedawcy podczas rejestracji.

Wartości w polu enum
SHARED_DATA_TYPE_UNSPECIFIED Nieokreślony typ udostępnianych danych.
FIRST_NAME Imię użytkownika.
LAST_NAME Nazwisko użytkownika.
STREET_ADDRESS Jednowierszowy adres użytkownika.
ADDRESS_LINE_ONE Pierwszy wiersz adresu użytkownika.
ADDRESS_LINE_TWO Drugi wiersz adresu użytkownika.
ADDRESS_LINE_THREE Trzeci wiersz adresu użytkownika.
CITY Miasto użytkownika.
STATE Stan użytkownika.
ZIPCODE Kod pocztowy użytkownika.
COUNTRY Kraj użytkownika.
EMAIL Adres e-mail użytkownika.
PHONE Numer telefonu użytkownika.

Stan

Stan wykrywalnego programu.

Wartości w polu enum
STATE_UNSPECIFIED Stan jest nieokreślony.
TRUSTED_TESTERS Program jest widoczny tylko dla testerów, którzy mają dostęp do konta wydawcy.
LIVE Program jest widoczny dla wszystkich użytkowników.
DISABLED Program jest niewidoczny.

DateFormat

Format daty używany do renderowania pól daty/czasu.

Wartości w polu enum
DATE_FORMAT_UNSPECIFIED Format daty nie został określony.
DATE_TIME Na przykład 2018-12-14T13:00:00 jest renderowane jako 14 grudnia, 13:00 w en_US.
DATE_ONLY Np. data 2018-12-14T13:00:00 jest renderowana jako 14 grudnia w en_US.
TIME_ONLY Na przykład 2018-12-14T13:00:00 jest renderowane jako 1:00 PM w języku en_US.
DATE_TIME_YEAR Na przykład 2018-12-14T13:00:00 jest renderowane jako 14 grudnia 2018 r., 13:00 w języku en_US.
DATE_YEAR Na przykład w przypadku języka en_US wartość 2018-12-14T13:00:00 zostanie wyświetlona jako Dec 14, 2018.
YEAR_MONTH Np. renderuje datę 2018-12-14T13:00:00 jako 2018-12 w formacie en_US.
YEAR_MONTH_DAY Np. renderuje datę 2018-12-14T13:00:00 jako 2018-12-14 w formacie en_US.

PredefinedItem

Wstępnie zdefiniowany element do wyświetlenia.

Wartości w polu enum
PREDEFINED_ITEM_UNSPECIFIED Wstępnie zdefiniowany element nie został określony.
FREQUENT_FLYER_PROGRAM_NAME_AND_NUMBER Wstępnie zdefiniowanym elementem jest nazwa i numer programu lojalnościowego.
FLIGHT_NUMBER_AND_OPERATING_FLIGHT_NUMBER Zdefiniowanym elementem jest numer lotu i numer lotu operacyjnego.

TransitOption

Opcja transportu publicznego, która ma być wyświetlana.

Wartości w polu enum
TRANSIT_OPTION_UNSPECIFIED Opcja transportu nie została określona.
ORIGIN_AND_DESTINATION_NAMES Opcja transportu to nazwy miejsca początkowego i docelowego.
ORIGIN_AND_DESTINATION_CODES Opcja transportu to kody miejsca początkowego i docelowego.
ORIGIN_NAME Opcja transportu to nazwa miejsca początkowego.

RedemptionChannel

Kanały wykorzystania mające zastosowanie do tej oferty specjalnej.

Wartości w polu enum
REDEMPTION_CHANNEL_UNSPECIFIED Kanał wykorzystania jest nieokreślony.
IN_STORE Ofertę można wykorzystać tylko w sklepie.
ONLINE Ofertę można wykorzystać tylko online.
BOTH Ofertę można wykorzystać w sklepie lub online.
TEMPORARY_PRICE_REDUCTION Oferta to tymczasowa obniżka ceny.

TransitType

Rodzaj transportu w klasie transportu publicznego.

Wartości w polu enum
TRANSIT_TYPE_UNSPECIFIED Typ transportu jest nieokreślony.
BUS Rodzaj transportu to autobus.
RAIL Rodzaj transportu to kolej.
TRAM Rodzaj transportu to tramwaj.
FERRY Rodzaj transportu to prom.
FLIGHT Rodzaj transportu to lot.
OTHER Rodzaj transportu to „inny”.

Adnotacje narzędzi

Adnotacje narzędzia są wysyłane do klientów MCP, aby opisać podstawowe ryzyko związane z danym narzędziem. Większość klientów traktuje te wskazówki jako niezaufane, ale można ich używać do decydowania, kiedy wysłać użytkownikowi prośbę o potwierdzenie.

Oprócz ciągu znaków tytułu zdefiniowano te wskazówki logiczne:

  • readOnlyHint: jeśli wartość jest prawdziwa, narzędzie nie modyfikuje swojego środowiska. Wartość domyślna: fałsz.
  • destructiveHint: jeśli ma wartość Prawda, narzędzie może wykonywać działania destrukcyjne. Jeśli ma wartość „false”, narzędzie może wykonywać tylko działania addytywne. Wartość domyślna: true.
  • idempotentHint: jeśli wartość to „true”, wielokrotne wywoływanie narzędzia z tymi samymi argumentami nie będzie miało dodatkowego wpływu na jego środowisko. Wartość domyślna: fałsz.
  • openWorldHint: jeśli wartość to „true”, narzędzie może wchodzić w interakcje z „otwartym światem” podmiotów zewnętrznych. Jeśli wartość jest równa false, narzędzie może wchodzić w interakcje wyłącznie z jednostkami wewnętrznymi. Na przykład narzędzie do wyszukiwania w internecie byłoby narzędziem typu otwarty świat, a narzędzie do zapamiętywania nie.

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌