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ład pokazuje, jak za pomocą znaku curl wywołać narzędzie 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 tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
Schemat wejściowy
Prośba o wiadomość dotyczącą klas kart wydawcy.
ListPassClassesRequest
| Zapis JSON |
|---|
{ "issuerId": string, "passType": enum ( |
| Pola | |
|---|---|
issuerId |
Wymagane. Unikalny identyfikator wydawcy, dla którego chcesz wyświetlić listę klas kart. |
passType |
Opcjonalnie. Typ klasy karty niepłatniczej do wyświetlenia. Jeśli nie zostanie określony, zostaną zwrócone wszystkie typy klas kart. |
view |
Opcjonalnie. Określa poziom szczegółowości zwracanych informacji o każdej klasie karty. |
Schemat wyjściowy
Wiadomość z odpowiedzią na żądanie wyświetlenia klas kart wydawcy.
ListPassClassesResponse
| Zapis JSON |
|---|
{
"passClasses": [
{
object ( |
| Pola | |
|---|---|
passClasses[] |
Klasy dokumentów wydawcy. |
PassClass
| Zapis JSON |
|---|
{ // Union field |
| Pola | |
|---|---|
Pole zbiorcze Pole |
|
loyaltyClass |
Opcjonalnie. Klasa programu lojalnościowego wydawcy. |
giftCardClass |
Opcjonalnie. Klasa karty podarunkowej wydawcy. |
offerClass |
Opcjonalnie. Klasa oferty wydawcy. |
eventTicketClass |
Opcjonalnie. Klasa biletu na wydarzenie wydawcy. |
flightClass |
Opcjonalnie. Klasa lotu wydawcy. |
transitClass |
Opcjonalnie. Klasa przejściowa wydawcy. |
genericClass |
Opcjonalnie. Ogólna klasa wydawcy. |
LoyaltyClass
| Zapis JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Pola | |
|---|---|
id |
Opcjonalnie. Identyfikator klasy programu lojalnościowego. |
issuerName |
Opcjonalnie. Nazwa wystawcy klasy programu lojalnościowego. |
localizedIssuerName |
Opcjonalnie. Zlokalizowana nazwa wydawcy klasy lojalnościowej. |
programName |
Opcjonalnie. Nazwa programu klasy lojalnościowej. |
localizedProgramName |
Opcjonalnie. Zlokalizowana nazwa programu klasy lojalnościowej. |
programLogoUri |
Opcjonalnie. Logo programu klasy lojalnościowej. |
hexBackgroundColor |
Opcjonalnie. Kolor tła klasy programu lojalnościowego. Format to szesnastkowy ciąg znaków koloru, np. „#RRGGBB”. |
heroImageUri |
Opcjonalnie. Obraz banera wyświetlany z przodu klasy programu lojalnościowego. |
discoverableProgram |
Opcjonalnie. Informacje o tym, jak można wykryć klasę lojalnościową i utworzyć jej instancję z poziomu Portfela Google. |
classTemplateInfo |
Opcjonalnie. Informacje o szablonie dotyczące sposobu wyświetlania klasy lojalnościowej. |
LocalizedString
| Zapis JSON |
|---|
{ "translatedValues": [ { object ( |
| Pola | |
|---|---|
translatedValues[] |
Opcjonalnie. Przetłumaczone ciągi znaków. |
defaultValue |
Opcjonalnie. Ciąg znaków do wyświetlenia, gdy nie jest dostępne odpowiednie tłumaczenie. |
TranslatedString
| Zapis JSON |
|---|
{ "languageCode": string, "value": string } |
| Pola | |
|---|---|
languageCode |
Opcjonalnie. Tag języka zgodny ze standardem BCP 47. Przykładowe wartości to „en-US”, „en-GB”, „de” lub „de-AT”. |
value |
Opcjonalnie. Przetłumaczony ciąg znaków zakodowany w UTF-8. |
DiscoverableProgram
| Zapis JSON |
|---|
{ "merchantSignupInfo": { object ( |
| Pola | |
|---|---|
merchantSignupInfo |
Opcjonalnie. Informacje o możliwości rejestracji i dodawania wartości na potrzeby tego programu za pośrednictwem witryny sprzedawcy. |
merchantSigninInfo |
Opcjonalnie. Informacje o możliwości logowania i dodawania wartości na potrzeby tego programu za pośrednictwem witryny sprzedawcy. |
state |
Tylko dane wyjściowe. Stan wykrywalnego programu. |
MerchantSignupInfo
| Zapis JSON |
|---|
{ "signupWebsite": { object ( |
| Pola | |
|---|---|
signupWebsite |
Opcjonalnie. Witryna, w której można zarejestrować się w wykrywalnym programie. |
signupSharedDatas[] |
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 ( |
| Pola | |
|---|---|
uri |
Opcjonalnie. Identyfikator URI. |
description |
Opcjonalnie. Tytuł identyfikatora URI wyświetlany w Portfelu Google jako tekst. |
localizedDescription |
Opcjonalnie. Przetłumaczone ciągi znaków tytułu identyfikatora URI wyświetlane w Portfelu Google jako tekst. |
MerchantSigninInfo
| Zapis JSON |
|---|
{
"signinWebsite": {
object ( |
| Pola | |
|---|---|
signinWebsite |
Opcjonalnie. Witryna, w której można się zalogować w wykrywalnym programie. |
ClassTemplateInfo
| Zapis JSON |
|---|
{ "cardBarcodeSectionDetails": { object ( |
| Pola | |
|---|---|
cardBarcodeSectionDetails |
Opcjonalnie. Dodatkowe informacje, które mają być wyświetlane powyżej i poniżej kodu kreskowego. |
cardTemplateOverride |
Opcjonalnie. Zastąpienie szablonu dla widoku karty. |
detailsTemplateOverride |
Opcjonalnie. Zastąpienie szablonu dla widoku szczegółów. |
listTemplateOverride |
Opcjonalnie. Zastąpienie szablonu dla widoku listy kart. |
CardBarcodeSectionDetails
| Zapis JSON |
|---|
{ "firstTopDetail": { object ( |
| Pola | |
|---|---|
firstTopDetail |
Opcjonalnie. Opcjonalne informacje do wyświetlenia nad kodem kreskowym. Zdefiniowane secondTopDetail będą wyświetlane na początku tej sekcji szczegółów. |
firstBottomDetail |
Opcjonalnie. Opcjonalne informacje do wyświetlenia pod kodem kreskowym. |
secondTopDetail |
Opcjonalnie. Opcjonalny drugi element informacji do wyświetlenia nad kodem kreskowym. Zdefiniowane firstTopDetail będą wyświetlane na końcu tej sekcji szczegółów. |
BarcodeSectionDetail
| Zapis JSON |
|---|
{
"fieldSelector": {
object ( |
| Pola | |
|---|---|
fieldSelector |
Opcjonalnie. Odwołanie do istniejącego pola tekstowego lub obrazu do wyświetlenia. |
FieldSelector
| Zapis JSON |
|---|
{
"fields": [
{
object ( |
| Pola | |
|---|---|
fields[] |
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 ( |
| Pola | |
|---|---|
fieldPath |
Opcjonalnie. Ścieżka do pola, do którego następuje odwołanie, z prefiksem „object” lub „class” i rozdzielona kropkami. |
dateFormat |
Opcjonalnie. Format daty do renderowania pól daty i godziny. |
CardTemplateOverride
| Zapis JSON |
|---|
{
"cardRowTemplateInfos": [
{
object ( |
| Pola | |
|---|---|
cardRowTemplateInfos[] |
Opcjonalnie. Informacje o szablonie dla wierszy w widoku karty. Można podać maksymalnie 3 wiersze. |
CardRowTemplateInfo
| Zapis JSON |
|---|
{ // Union field |
| 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 |
Opcjonalnie. Szablon dla wiersza zawierającego jeden element. |
twoItems |
Opcjonalnie. Szablon dla wiersza zawierającego dwa elementy. |
threeItems |
Opcjonalnie. Szablon dla wiersza zawierającego trzy elementy. |
CardRowOneItem
| Zapis JSON |
|---|
{
"item": {
object ( |
| Pola | |
|---|---|
item |
Opcjonalnie. Element do wyświetlenia w wierszu. Ten element zostanie wyśrodkowany. |
TemplateItem
| Zapis JSON |
|---|
{ "firstValue": { object ( |
| Pola | |
|---|---|
firstValue |
Opcjonalnie. Odwołanie do pierwszego pola do wyświetlenia. |
secondValue |
Opcjonalnie. Odwołanie do drugiego pola do wyświetlenia. |
predefinedItem |
Opcjonalnie. Wstępnie zdefiniowany element do wyświetlenia. |
CardRowTwoItems
| Zapis JSON |
|---|
{ "startItem": { object ( |
| Pola | |
|---|---|
startItem |
Opcjonalnie. Element do wyświetlenia na początku wiersza. Ten element będzie wyrównany do lewej. |
endItem |
Opcjonalnie. Element do wyświetlenia na końcu wiersza. Ten element będzie wyrównany do prawej. |
CardRowThreeItems
| Zapis JSON |
|---|
{ "startItem": { object ( |
| Pola | |
|---|---|
startItem |
Opcjonalnie. Element do wyświetlenia na początku wiersza. Ten element będzie wyrównany do lewej. |
middleItem |
Opcjonalnie. Element do wyświetlenia na środku wiersza. Ten element będzie wyśrodkowany między elementem początkowym i końcowym. |
endItem |
Opcjonalnie. Element do wyświetlenia na końcu wiersza. Ten element będzie wyrównany do prawej. |
DetailsTemplateOverride
| Zapis JSON |
|---|
{
"detailsItemInfos": [
{
object ( |
| Pola | |
|---|---|
detailsItemInfos[] |
Opcjonalnie. Informacje o szablonie dotyczące elementów wyświetlanych na liście szczegółów. |
DetailsItemInfo
| Zapis JSON |
|---|
{
"item": {
object ( |
| Pola | |
|---|---|
item |
Opcjonalnie. Element do wyświetlenia na liście szczegółów. |
ListTemplateOverride
| Zapis JSON |
|---|
{ "firstRowOption": { object ( |
| Pola | |
|---|---|
firstRowOption |
Opcjonalnie. Odwołanie do pola wyświetlanego w pierwszym wierszu. |
secondRowOption |
Opcjonalnie. Odwołanie do pola wyświetlanego w drugim wierszu. |
FirstRowOption
| Zapis JSON |
|---|
{ "transitOption": enum ( |
| Pola | |
|---|---|
transitOption |
Opcjonalnie. Opcja transportu publicznego, która ma być wyświetlana w pierwszym wierszu. |
fieldOption |
Opcjonalnie. Odwołanie do pola wyświetlanego w pierwszym wierszu. |
GiftCardClass
| Zapis JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Pola | |
|---|---|
id |
Opcjonalnie. Identyfikator klasy karty podarunkowej. |
issuerName |
Opcjonalnie. Nazwa wystawcy klasy karty podarunkowej. |
localizedIssuerName |
Opcjonalnie. Zlokalizowana nazwa wydawcy klasy karty podarunkowej. |
merchantName |
Opcjonalnie. Nazwa sprzedawcy klasy karty podarunkowej. |
localizedMerchantName |
Opcjonalnie. Zlokalizowana nazwa sprzedawcy klasy karty podarunkowej. |
programLogoUri |
Opcjonalnie. Logo programu klasy karty podarunkowej. |
hexBackgroundColor |
Opcjonalnie. Kolor tła klasy karty podarunkowej. Format to szesnastkowy ciąg znaków koloru, np. „#RRGGBB”. |
heroImageUri |
Opcjonalnie. Obraz banera wyświetlany z przodu klasy karty podarunkowej. |
homePageUri |
Opcjonalnie. Witryna strony głównej aplikacji. |
classTemplateInfo |
Opcjonalnie. Informacje o szablonie wyświetlania klasy karty podarunkowej. |
OfferClass
| Zapis JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Pola | |
|---|---|
id |
Opcjonalnie. Identyfikator klasy oferty. |
issuerName |
Opcjonalnie. Nazwa wystawcy klasy oferty. |
localizedIssuerName |
Opcjonalnie. Zlokalizowana nazwa wydawcy klasy oferty. |
provider |
Opcjonalnie. Dostawca klasy oferty. |
localizedProvider |
Opcjonalnie. Zlokalizowany dostawca klasy oferty. |
title |
Opcjonalnie. Nazwa klasy oferty. |
localizedTitle |
Opcjonalnie. Zlokalizowany tytuł klasy oferty. |
titleImageUri |
Opcjonalnie. Zdjęcie tytułowe klasy oferty. |
hexBackgroundColor |
Opcjonalnie. Kolor tła klasy oferty. Format to szesnastkowy ciąg znaków koloru, np. „#RRGGBB”. |
heroImageUri |
Opcjonalnie. Obraz banera wyświetlany z przodu klasy oferty. |
redemptionChannel |
Opcjonalnie. Kanał wykorzystania klasy oferty. |
classTemplateInfo |
Opcjonalnie. Informacje na temat szablonu wyświetlania klasy oferty. |
EventTicketClass
| Zapis JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Pola | |
|---|---|
id |
Opcjonalnie. Identyfikator klasy biletu na wydarzenie. |
issuerName |
Opcjonalnie. Nazwa wystawcy klasy biletu na wydarzenie. |
localizedIssuerName |
Opcjonalnie. Zlokalizowana nazwa wydawcy klasy biletu na wydarzenie. |
logoUri |
Opcjonalnie. Logo klasy biletu na wydarzenie. |
eventName |
Opcjonalnie. Nazwa zdarzenia. |
venue |
Opcjonalnie. Miejsce wydarzenia. |
dateTime |
Opcjonalnie. Informacje o dacie i godzinie wydarzenia. |
hexBackgroundColor |
Opcjonalnie. Kolor tła klasy biletu na wydarzenie. Format to szesnastkowy ciąg znaków koloru, np. „#RRGGBB”. |
heroImageUri |
Opcjonalnie. Obraz banera wyświetlany z przodu klasy biletu na wydarzenie. |
classTemplateInfo |
Opcjonalnie. Informacje o szablonie dotyczące sposobu wyświetlania klasy biletu na wydarzenie. |
EventVenue
| Zapis JSON |
|---|
{ "name": { object ( |
| Pola | |
|---|---|
name |
Opcjonalnie. Nazwa obiektu. |
address |
Opcjonalnie. Adres miejsca. |
EventDateTime
| Zapis JSON |
|---|
{ "start": string, "end": string } |
| Pola | |
|---|---|
start |
Opcjonalnie. Data i godzina rozpoczęcia wydarzenia. Jeśli wydarzenie obejmuje wiele dni, powinny to być data i godzina 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 |
Opcjonalnie. Data i godzina zakończenia wydarzenia. Jeśli wydarzenie obejmuje wiele dni, powinny to być data i godzina 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 ( |
| Pola | |
|---|---|
id |
Opcjonalnie. Identyfikator klasy lotu. |
issuerName |
Opcjonalnie. Nazwa wystawcy klasy lotu. |
localizedIssuerName |
Opcjonalnie. Zlokalizowana nazwa wydawcy klasy lotu. |
flightHeader |
Opcjonalnie. Informacje o przewoźniku lotniczym i numerze lotu. |
origin |
Opcjonalnie. Informacje o lotnisku odlotu. |
destination |
Opcjonalnie. Informacje o lotnisku docelowym. |
localScheduledDepartureDateTime |
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 |
Opcjonalnie. Kolor tła klasy lotu. Format to szesnastkowy ciąg znaków koloru, np. „#RRGGBB”. |
heroImageUri |
Opcjonalnie. Obraz banera wyświetlany z przodu zajęć. |
classTemplateInfo |
Opcjonalnie. Informacje o szablonie wyświetlania klasy lotu. |
FlightHeader
| Zapis JSON |
|---|
{
"carrier": {
object ( |
| Pola | |
|---|---|
carrier |
Opcjonalnie. Informacje o przewoźniku lotniczym. |
flightNumber |
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 |
Opcjonalnie. Dwuznakowy kod IATA linii lotniczej przewoźnika. |
carrierIcaoCode |
Opcjonalnie. Trzyznakowy kod ICAO linii lotniczej przewoźnika. |
airlineLogoUri |
Opcjonalnie. Logo linii lotniczej opisanej przez kod IATA przewoźnika. |
AirportInfo
| Zapis JSON |
|---|
{ "airportIataCode": string, "terminal": string, "gate": string } |
| Pola | |
|---|---|
airportIataCode |
Opcjonalnie. Trzyznakowy kod IATA lotniska, np. „SFO”. |
terminal |
Opcjonalnie. Nazwa terminala, np. „I”. |
gate |
Opcjonalnie. Nazwa bramki, np. „B59”. |
TransitClass
| Zapis JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Pola | |
|---|---|
id |
Opcjonalnie. Identyfikator klasy tranzytowej. |
issuerName |
Opcjonalnie. Nazwa wystawcy klasy transportu publicznego. |
localizedIssuerName |
Opcjonalnie. Zlokalizowana nazwa wydawcy klasy transportu publicznego. |
hexBackgroundColor |
Opcjonalnie. Kolor tła klasy transportu publicznego. Format to szesnastkowy ciąg znaków koloru, np. „#RRGGBB”. |
heroImageUri |
Opcjonalnie. Obraz banera wyświetlany z przodu zajęć. |
transitType |
Opcjonalnie. Rodzaj tranzytu w klasie tranzytu. |
classTemplateInfo |
Opcjonalnie. Informacje na temat szablonu wyświetlania klasy transportu publicznego. |
GenericClass
| Zapis JSON |
|---|
{
"id": string,
"classTemplateInfo": {
object ( |
| Pola | |
|---|---|
id |
Opcjonalnie. Identyfikator klasy ogólnej. |
classTemplateInfo |
Opcjonalnie. Informacje o szablonie dotyczące sposobu wyświetlania klasy ogólnej. |
Adnotacje narzędzi
Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌