כלי: 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 ( |
| שדות | |
|---|---|
issuerId |
חובה. המזהה הייחודי של המנפיק שעבורו רוצים להציג את מחלקות הכרטיסים. |
passType |
אופציונלי. סוג כרטיס המועדון שרוצים להציג. אם לא מציינים סוג, יוחזרו כל הסוגים של כרטיסי מועדון. |
view |
אופציונלי. מציינת את רמת הפירוט שתוחזר לכל מחלקה של כרטיס. |
סכימת פלט
הודעת התגובה לבקשה לרשימת כרטיסים של מנפיק.
ListPassClassesResponse
| ייצוג JSON |
|---|
{
"passClasses": [
{
object ( |
| שדות | |
|---|---|
passClasses[] |
סוגי הכרטיסים של המנפיק. |
PassClass
| ייצוג JSON |
|---|
{ // Union field |
| שדות | |
|---|---|
שדה איחוד הערך |
|
loyaltyClass |
אופציונלי. סוג מועדון הלקוחות של המנפיק. |
giftCardClass |
אופציונלי. הסיווג של כרטיס המתנה לפי המנפיק. |
offerClass |
אופציונלי. סוג ההצעה של המנפיק. |
eventTicketClass |
אופציונלי. הסיווג של הכרטיס לאירוע שהונפק על ידי המנפיק. |
flightClass |
אופציונלי. סיווג הטיסה של המנפיק. |
transitClass |
אופציונלי. סיווג המעבר של המנפיק. |
genericClass |
אופציונלי. הסיווג הגנרי של הגורם שהנפיק את הכרטיס. |
LoyaltyClass
| ייצוג JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| שדות | |
|---|---|
id |
אופציונלי. המזהה של מועדון הלקוחות. |
issuerName |
אופציונלי. שם המנפיק של כרטיס המועדון. |
localizedIssuerName |
אופציונלי. השם של מנפיק כרטיס המועדון, שמותאם לשוק המקומי. |
programName |
אופציונלי. שם התוכנית של מועדון הלקוחות. |
localizedProgramName |
אופציונלי. השם של מועדון הלקוחות שמותאם לשוק המקומי. |
programLogoUri |
אופציונלי. הלוגו של מועדון הלקוחות. |
hexBackgroundColor |
אופציונלי. צבע הרקע של מועדון הלקוחות. הפורמט הוא מחרוזת של קוד צבע הקסדצימלי, למשל #RRGGBB. |
heroImageUri |
אופציונלי. תמונת הבאנר שמוצגת בחזית של כרטיס מועדון הלקוחות. |
discoverableProgram |
אופציונלי. מידע על האופן שבו אפשר לגלות את מחלקת המועדון ולהפעיל אותה מתוך Google Wallet. |
classTemplateInfo |
אופציונלי. המידע בתבנית לגבי אופן ההצגה של כרטיס המועדון. |
LocalizedString
| ייצוג JSON |
|---|
{ "translatedValues": [ { object ( |
| שדות | |
|---|---|
translatedValues[] |
אופציונלי. המחרוזות המתורגמות של המחרוזת. |
defaultValue |
אופציונלי. המחרוזת שתוצג אם לא יהיה תרגום מתאים. |
TranslatedString
| ייצוג JSON |
|---|
{ "languageCode": string, "value": string } |
| שדות | |
|---|---|
languageCode |
אופציונלי. תג השפה BCP 47. דוגמאות לערכים: 'en-US', 'en-GB', 'de' או 'de-AT'. |
value |
אופציונלי. המחרוזת המתורגמת בקידוד UTF-8. |
DiscoverableProgram
| ייצוג JSON |
|---|
{ "merchantSignupInfo": { object ( |
| שדות | |
|---|---|
merchantSignupInfo |
אופציונלי. מידע על האפשרות להירשם למועדון הלקוחות הזה ולהוסיף הטבה דרך האתר של המוכר. |
merchantSigninInfo |
אופציונלי. מידע על האפשרות להירשם למועדון הלקוחות הזה דרך האתר של המוכר ולהוסיף כרטיס מועדון. |
state |
פלט בלבד. המצב של התוכנית הגלויה. |
MerchantSignupInfo
| ייצוג JSON |
|---|
{ "signupWebsite": { object ( |
| שדות | |
|---|---|
signupWebsite |
אופציונלי. האתר שדרכו נרשמים לתוכנית הגילוי. |
signupSharedDatas[] |
אופציונלי. נתוני המשתמש שנשלחים בבקשת POST לכתובת ה-URL של אתר ההרשמה. המידע הזה מוצפן ואז משותף כדי שאפשר יהיה למלא מראש את השדות באתר של המוֹכר שמשמשים לרישום המשתמש לתוכנית הגלויה. |
אורי
| ייצוג JSON |
|---|
{
"uri": string,
"description": string,
"localizedDescription": {
object ( |
| שדות | |
|---|---|
uri |
אופציונלי. ה-URI. |
description |
אופציונלי. הכותרת של ה-URI שמופיעה ב-Google Wallet כטקסט. |
localizedDescription |
אופציונלי. המחרוזות המתורגמות של שם ה-URI שמופיע ב-Google Wallet כטקסט. |
MerchantSigninInfo
| ייצוג JSON |
|---|
{
"signinWebsite": {
object ( |
| שדות | |
|---|---|
signinWebsite |
אופציונלי. האתר שאליו צריך להיכנס כדי להפעיל את התוכנית הגלויה. |
ClassTemplateInfo
| ייצוג JSON |
|---|
{ "cardBarcodeSectionDetails": { object ( |
| שדות | |
|---|---|
cardBarcodeSectionDetails |
אופציונלי. המידע הנוסף שיוצג מעל הברקוד ומתחתיו. |
cardTemplateOverride |
אופציונלי. שינוי מברירת המחדל של התבנית בתצוגת כרטיסי מיקום. |
detailsTemplateOverride |
אופציונלי. החלפת התבנית בתצוגת הפרטים. |
listTemplateOverride |
אופציונלי. החלפת התבנית של תצוגת הרשימה של הכרטיסים. |
CardBarcodeSectionDetails
| ייצוג JSON |
|---|
{ "firstTopDetail": { object ( |
| שדות | |
|---|---|
firstTopDetail |
אופציונלי. המידע האופציונלי שיוצג מעל הברקוד. אם מוגדר secondTopDetail, הוא יוצג בצד ההתחלה של קטע הפרטים הזה. |
firstBottomDetail |
אופציונלי. המידע האופציונלי שיוצג מתחת לברקוד. |
secondTopDetail |
אופציונלי. המידע השני (אופציונלי) שיוצג מעל הברקוד. אם מוגדר firstTopDetail, הוא יוצג בצד הסיום של קטע הפרטים הזה. |
BarcodeSectionDetail
| ייצוג JSON |
|---|
{
"fieldSelector": {
object ( |
| שדות | |
|---|---|
fieldSelector |
אופציונלי. ההפניה לשדה קיים של טקסט או תמונה שיוצג. |
FieldSelector
| ייצוג JSON |
|---|
{
"fields": [
{
object ( |
| שדות | |
|---|---|
fields[] |
אופציונלי. ההפניות לשדות שבהן צריך להשתמש עם החלפות שדות. אם מספקים יותר מהפניה אחת, תוצג ההפניה הראשונה שמתייחסת לשדה לא ריק. |
FieldReference
| ייצוג JSON |
|---|
{
"fieldPath": string,
"dateFormat": enum ( |
| שדות | |
|---|---|
fieldPath |
אופציונלי. הנתיב לשדה שאליו מתבצעת ההפניה, שמתחיל ב-object או ב-class ומופרד בנקודות. |
dateFormat |
אופציונלי. פורמט התאריך שבו יוצגו שדות של תאריך ושעה. |
CardTemplateOverride
| ייצוג JSON |
|---|
{
"cardRowTemplateInfos": [
{
object ( |
| שדות | |
|---|---|
cardRowTemplateInfos[] |
אופציונלי. המידע על השורות בתבנית בתצוגת כרטיסי מיקום. אפשר לציין עד שלוש שורות. |
CardRowTemplateInfo
| ייצוג JSON |
|---|
{ // Union field |
| שדות | |
|---|---|
שדה איחוד row_template. התבנית לשורה שמכילה פריט אחד, שניים או שלושה. הערך row_template יכול להיות רק אחד מהבאים: |
|
oneItem |
אופציונלי. התבנית לשורה שמכילה פריט אחד. |
twoItems |
אופציונלי. תבנית לשורה שמכילה שני פריטים. |
threeItems |
אופציונלי. תבנית לשורה שמכילה שלושה פריטים. |
CardRowOneItem
| ייצוג JSON |
|---|
{
"item": {
object ( |
| שדות | |
|---|---|
item |
אופציונלי. הפריט שיוצג בשורה. הפריט הזה יוצג במרכז. |
TemplateItem
| ייצוג JSON |
|---|
{ "firstValue": { object ( |
| שדות | |
|---|---|
firstValue |
אופציונלי. ההפניה לשדה הראשון שיוצג. |
secondValue |
אופציונלי. ההפניה לשדה השני שיוצג. |
predefinedItem |
אופציונלי. הפריט המוגדר מראש שיוצג. |
CardRowTwoItems
| ייצוג JSON |
|---|
{ "startItem": { object ( |
| שדות | |
|---|---|
startItem |
אופציונלי. הפריט שיוצג בתחילת השורה. הפריט ייושר לימין. |
endItem |
אופציונלי. הפריט שיוצג בסוף השורה. הפריט הזה ייושר לימין. |
CardRowThreeItems
| ייצוג JSON |
|---|
{ "startItem": { object ( |
| שדות | |
|---|---|
startItem |
אופציונלי. הפריט שיוצג בתחילת השורה. הפריט ייושר לימין. |
middleItem |
אופציונלי. הפריט שיוצג באמצע השורה. הפריט הזה ימוקם במרכז בין פריטי ההתחלה והסיום. |
endItem |
אופציונלי. הפריט שיוצג בסוף השורה. הפריט הזה ייושר לימין. |
DetailsTemplateOverride
| ייצוג JSON |
|---|
{
"detailsItemInfos": [
{
object ( |
| שדות | |
|---|---|
detailsItemInfos[] |
אופציונלי. המידע על הפריטים שמוצג ברשימת הפרטים. |
DetailsItemInfo
| ייצוג JSON |
|---|
{
"item": {
object ( |
| שדות | |
|---|---|
item |
אופציונלי. הפריט שיוצג ברשימת הפרטים. |
ListTemplateOverride
| ייצוג JSON |
|---|
{ "firstRowOption": { object ( |
| שדות | |
|---|---|
firstRowOption |
אופציונלי. ההפניה לשדה שיוצג בשורה הראשונה. |
secondRowOption |
אופציונלי. ההפניה לשדה שיוצג בשורה השנייה. |
FirstRowOption
| ייצוג JSON |
|---|
{ "transitOption": enum ( |
| שדות | |
|---|---|
transitOption |
אופציונלי. אפשרות התחבורה הציבורית שתוצג בשורה הראשונה. |
fieldOption |
אופציונלי. ההפניה לשדה שיוצג בשורה הראשונה. |
GiftCardClass
| ייצוג JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| שדות | |
|---|---|
id |
אופציונלי. המזהה של קטגוריית כרטיסי המתנה. |
issuerName |
אופציונלי. שם המנפיק של כרטיס המתנה. |
localizedIssuerName |
אופציונלי. השם המקומי של מנפיק כרטיס המתנה. |
merchantName |
אופציונלי. שם המוכר של סוג כרטיס המתנה. |
localizedMerchantName |
אופציונלי. שם המוכר המותאם לשפה המקומית של סוג כרטיס המתנה. |
programLogoUri |
אופציונלי. הלוגו של התוכנית של קטגוריית כרטיסי המתנה. |
hexBackgroundColor |
אופציונלי. צבע הרקע של קטגוריית כרטיסי המתנה. הפורמט הוא מחרוזת של קוד צבע הקסדצימלי, למשל #RRGGBB. |
heroImageUri |
אופציונלי. תמונת הבאנר שמוצגת בחלק הקדמי של כרטיס המתנה. |
homePageUri |
אופציונלי. כתובת האתר של דף הבית של האפליקציה. |
classTemplateInfo |
אופציונלי. המידע בתבנית לגבי אופן ההצגה של קטגוריית כרטיסי המתנה. |
OfferClass
| ייצוג JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| שדות | |
|---|---|
id |
אופציונלי. המזהה של מחלקת המבצע. |
issuerName |
אופציונלי. שם המנפיק של מחלקת המבצע. |
localizedIssuerName |
אופציונלי. השם המקומי של מנפיק כרטיס המועדון. |
provider |
אופציונלי. הספק של כרטיס המועדון. |
localizedProvider |
אופציונלי. הספק המותאם לשוק המקומי של קטגוריית המבצעים. |
title |
אופציונלי. השם של מחלקת המבצע. |
localizedTitle |
אופציונלי. השם של כרטיס המועדון שמותאם לשוק המקומי. |
titleImageUri |
אופציונלי. תמונת הכותרת של כרטיס המועדון. |
hexBackgroundColor |
אופציונלי. צבע הרקע של קטגוריית המבצע. הפורמט הוא מחרוזת של קוד צבע הקסדצימלי, למשל #RRGGBB. |
heroImageUri |
אופציונלי. תמונת הבאנר שמוצגת בחלק הקדמי של כרטיס המועדון. |
redemptionChannel |
אופציונלי. ערוץ המימוש של קטגוריית המבצעים. |
classTemplateInfo |
אופציונלי. התבנית מכילה מידע על האופן שבו כרטיס המועדון צריך להופיע. |
EventTicketClass
| ייצוג JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| שדות | |
|---|---|
id |
אופציונלי. המזהה של קטגוריית הכרטיסים לאירוע. |
issuerName |
אופציונלי. שם המנפיק של קטגוריית הכרטיסים לאירוע. |
localizedIssuerName |
אופציונלי. השם המקומי של מנפיק הכרטיס לאירוע. |
logoUri |
אופציונלי. הלוגו של הכרטיס לאירוע. |
eventName |
אופציונלי. שם האירוע. |
venue |
אופציונלי. מקום האירוע. |
dateTime |
אופציונלי. המידע על התאריך והשעה של האירוע. |
hexBackgroundColor |
אופציונלי. צבע הרקע של כרטיס לאירוע. הפורמט הוא מחרוזת של קוד צבע הקסדצימלי, למשל #RRGGBB. |
heroImageUri |
אופציונלי. תמונת הבאנר שמוצגת בחזית של קטגוריית הכרטיסים לאירוע. |
classTemplateInfo |
אופציונלי. התבנית מכילה מידע על האופן שבו צריך להציג את קטגוריית הכרטיסים לאירוע. |
EventVenue
| ייצוג JSON |
|---|
{ "name": { object ( |
| שדות | |
|---|---|
name |
אופציונלי. שם המקום שבו ייערך האירוע. |
address |
אופציונלי. הכתובת של המקום. |
EventDateTime
| ייצוג JSON |
|---|
{ "start": string, "end": string } |
| שדות | |
|---|---|
start |
אופציונלי. התאריך והשעה שבהם האירוע מתחיל. אם האירוע נמשך כמה ימים, צריך לציין את תאריך ושעת ההתחלה ביום הראשון. הפורמט הוא תאריך ושעה בפורמט מורחב של ISO 8601 ללא היסט, והשעה יכולה להיות מוגדרת עד לרמת דיוק של אלפית השנייה, למשל 2027-03-05T06:30:00. |
end |
אופציונלי. התאריך והשעה שבהם האירוע מסתיים. אם האירוע נמשך כמה ימים, צריך לציין את תאריך ושעת הסיום ביום האחרון. הפורמט הוא תאריך ושעה בפורמט מורחב של ISO 8601 ללא היסט, והשעה יכולה להיות מוגדרת עד לרמת דיוק של אלפית השנייה, למשל 2027-03-05T06:30:00. |
FlightClass
| ייצוג JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| שדות | |
|---|---|
id |
אופציונלי. המזהה של קטגוריית הטיסה. |
issuerName |
אופציונלי. שם המנפיק של כרטיס הטיסה. |
localizedIssuerName |
אופציונלי. השם המקומי של מנפיק כרטיס הטיסה. |
flightHeader |
אופציונלי. המידע על חברת התעופה ומספר הטיסה. |
origin |
אופציונלי. המידע על נמל התעופה שממנו ממריאה הטיסה. |
destination |
אופציונלי. המידע על נמל התעופה שבו נוחתת הטיסה. |
localScheduledDepartureDateTime |
אופציונלי. התאריך והשעה המתוכננים שבהם המטוס צפוי לצאת מהשער (לא ממסלול ההמראה). הפורמט הוא תאריך ושעה בפורמט מורחב של ISO 8601 ללא היסט, והשעה יכולה להיות מוגדרת עד לרמת דיוק של אלפית השנייה, למשל 2027-03-05T06:30:00. התאריך והשעה המקומיים בשדה התעופה (לא שעון UTC). |
hexBackgroundColor |
אופציונלי. צבע הרקע של מחלקת הטיסה. הפורמט הוא מחרוזת של קוד צבע הקסדצימלי, למשל #RRGGBB. |
heroImageUri |
אופציונלי. תמונת הבאנר שמוצגת בחלק הקדמי של כיתת הטיסה. |
classTemplateInfo |
אופציונלי. המידע בתבנית לגבי אופן ההצגה של מחלקת הטיסה. |
FlightHeader
| ייצוג JSON |
|---|
{
"carrier": {
object ( |
| שדות | |
|---|---|
carrier |
אופציונלי. המידע על חברת התעופה. |
flightNumber |
אופציונלי. מספר הטיסה בלי קוד ה-IATA של חברת התעופה. השדה מכיל רק ספרות, למשל '123'. |
FlightCarrier
| ייצוג JSON |
|---|
{ "carrierIataCode": string, "carrierIcaoCode": string, "airlineLogoUri": string } |
| שדות | |
|---|---|
carrierIataCode |
אופציונלי. קוד חברת התעופה של חברת התעופה שמורכב משני תווים לפי תקן IATA. |
carrierIcaoCode |
אופציונלי. קוד חברת התעופה של הספק בן שלושה תווים על פי תקן ICAO. |
airlineLogoUri |
אופציונלי. הלוגו של חברת התעופה שמתואר על ידי קוד ה-IATA של חברת התעופה. |
AirportInfo
| ייצוג JSON |
|---|
{ "airportIataCode": string, "terminal": string, "gate": string } |
| שדות | |
|---|---|
airportIataCode |
אופציונלי. קוד שדה התעופה של IATA בן שלוש אותיות, למשל SFO. |
terminal |
אופציונלי. שם המסוף, לדוגמה 'I'. |
gate |
אופציונלי. שם השער, למשל B59. |
TransitClass
| ייצוג JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| שדות | |
|---|---|
id |
אופציונלי. המזהה של כרטיס הנסיעה. |
issuerName |
אופציונלי. שם המנפיק של כרטיס התחבורה הציבורית. |
localizedIssuerName |
אופציונלי. השם של מנפיק כרטיס התחבורה הציבורית, מותאם לשוק המקומי. |
hexBackgroundColor |
אופציונלי. צבע הרקע של כרטיס המעבר. הפורמט הוא מחרוזת של קוד צבע הקסדצימלי, למשל #RRGGBB. |
heroImageUri |
אופציונלי. תמונת הבאנר שמוצגת בחזית של כרטיס המעבר לתחבורה ציבורית. |
transitType |
אופציונלי. סוג התחבורה של סיווג התנועה. |
classTemplateInfo |
אופציונלי. המידע בתבנית לגבי אופן הצגת מחלקת הכרטיס. |
GenericClass
| ייצוג JSON |
|---|
{
"id": string,
"classTemplateInfo": {
object ( |
| שדות | |
|---|---|
id |
אופציונלי. המזהה של הקטגוריה הגנרית. |
classTemplateInfo |
אופציונלי. פרטי התבנית לגבי אופן ההצגה של הכרטיס הכללי. |
הערות על כלי
רמז הרסני: ❌ | רמז אידמפוטנטי: ✅ | רמז לקריאה בלבד: ✅ | רמז לעולם פתוח: ❌