MCP Tools Reference: paydeveloper.googleapis.com

כלי: list_pass_classes

הפעולה הזו מאחזרת רשימה מקיפה של כל סוגי הכרטיסים שרשומים במסוף העסקי של Google Wallet שמשויך למשתמש המאומת. הכלי הזה מספק מידע חיוני למפתחים שמנהלים כרטיסים ב-Wallet, כמו כרטיסי מועדון לקוחות, כרטיסי מתנה או כרטיסי טיסה.

בדוגמת הקוד הבאה מוצג שימוש בפקודה curl כדי להפעיל את הכלי list_pass_classes MCP.

בקשת 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
}'

סכימת הקלט

בקשת הודעה לרישום כרטיסי מועדון של מנפיק.

ListPassClassesRequest

ייצוג JSON
{
  "issuerId": string,
  "passType": enum (PassType),
  "view": enum (PassClassView)
}
שדות
issuerId

string (int64 format)

חובה. המזהה הייחודי של המנפיק שעבורו יש לרשום שיעורי מעבר.

passType

enum (PassType)

אופציונלי. סוג קורס המעבר שיש לפרט. אם לא מציינים סוג, יוחזרו כל הסוגים של כרטיסי מועדון.

view

enum (PassClassView)

אופציונלי. מציין את רמת הפירוט שתוחזר עבור כל מחלקה של כרטיס.

PassType

סוג כרטיס.

טיפוסים בני מנייה (enum)
PASS_TYPE_UNSPECIFIED לא צוין סוג הכרטיס.
LOYALTY סוג הכרטיס הוא מועדון לקוחות.
GIFT_CARD סוג הכרטיס הוא כרטיס מתנה.
OFFER סוג הכרטיס הוא מבצע.
EVENT_TICKET סוג הכרטיס הוא כרטיס לאירוע.
FLIGHT סוג הכרטיס הוא טיסה.
TRANSIT סוג הכרטיס הוא כרטיס לתחבורה ציבורית.
GENERIC סוג הכרטיס הוא Generic.

PassClassView

רמת הפירוט שתוחזר לכל כרטיס.

טיפוסים בני מנייה (enum)
PASS_CLASS_VIEW_UNSPECIFIED ערך ברירת המחדל או הערך שלא הוגדר. ה-API יוגדר כברירת מחדל לתצוגה BASIC.
PASS_CLASS_VIEW_BASIC כלול מידע בסיסי על כרטיס המעבר.
PASS_CLASS_VIEW_FULL חשוב לכלול את כל הפרטים על סוג הכרטיס.

סכימת הפלט

הודעת התגובה לבקשה לרשימת כרטיסים של מנפיק.

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.

DiscoverableProgram

ייצוג JSON
{
  "merchantSignupInfo": {
    object (MerchantSignupInfo)
  },
  "merchantSigninInfo": {
    object (MerchantSigninInfo)
  },
  "state": enum (State)
}
שדות
merchantSignupInfo

object (MerchantSignupInfo)

אופציונלי. המידע על היכולת להירשם ולהוסיף פריט בעל ערך לתוכנית הניתנת לגילוי זו דרך אתר סוחר.

merchantSigninInfo

object (MerchantSigninInfo)

אופציונלי. מידע על האפשרות להירשם למועדון הלקוחות הזה ולהוסיף כרטיס מועדון לקוחות דרך האתר של המוכר.

state

enum (State)

פלט בלבד. המצב של התוכנית הגלויה.

MerchantSignupInfo

ייצוג JSON
{
  "signupWebsite": {
    object (Uri)
  },
  "signupSharedDatas": [
    enum (SharedDataType)
  ]
}
שדות
signupWebsite

object (Uri)

אופציונלי. האתר שדרכו נרשמים לתוכנית הגלויה.

signupSharedDatas[]

enum (SharedDataType)

אופציונלי. נתוני המשתמש שנשלחים בבקשת POST לכתובת ה-URL של אתר ההרשמה. המידע הזה מוצפן ואז משותף כדי שאפשר יהיה למלא מראש את השדות באתר של המוכר שמשמשים לרישום המשתמש לתוכנית שניתן לגלות.

אורי

ייצוג JSON
{
  "uri": string,
  "description": string,
  "localizedDescription": {
    object (LocalizedString)
  }
}
שדות
uri

string

אופציונלי. ה-URI.

description

string

אופציונלי. כותרת ה-URI מופיעה בארנק גוגל כטקסט.

localizedDescription

object (LocalizedString)

אופציונלי. המחרוזות המתורגמות של שם ה-URI שמופיע ב-Google Wallet כטקסט.

MerchantSigninInfo

ייצוג 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)

אופציונלי. המידע על הפריטים שמוצג ברשימת הפרטים.

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)

אופציונלי. פרטי התבנית לגבי אופן הצגת סיווג כרטיסי האירוע.

EventVenue

ייצוג JSON
{
  "name": {
    object (LocalizedString)
  },
  "address": {
    object (LocalizedString)
  }
}
שדות
name

object (LocalizedString)

אופציונלי. שם המקום שבו ייערך האירוע.

address

object (LocalizedString)

אופציונלי. הכתובת של מקום האירוע.

EventDateTime

ייצוג 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)

אופציונלי. המידע בתבנית לגבי אופן הצגת מחלקת הטיסה.

FlightHeader

ייצוג JSON
{
  "carrier": {
    object (FlightCarrier)
  },
  "flightNumber": string
}
שדות
carrier

object (FlightCarrier)

אופציונלי. המידע על חברת התעופה.

flightNumber

string

אופציונלי. מספר הטיסה בלי קוד ה-IATA של חברת התעופה. השדה מכיל רק ספרות, למשל '123'.

FlightCarrier

ייצוג JSON
{
  "carrierIataCode": string,
  "carrierIcaoCode": string,
  "airlineLogoUri": string
}
שדות
carrierIataCode

string

אופציונלי. קוד חברת התעופה של חברת התעופה שמפעילה את הטיסה, בן שני תווים.

carrierIcaoCode

string

אופציונלי. קוד חברת התעופה של הספק בן שלושה תווים על פי תקן ICAO.

airlineLogoUri

string

אופציונלי. הלוגו של חברת התעופה שמתואר על ידי קוד ה-IATA של חברת התעופה.

AirportInfo

ייצוג JSON
{
  "airportIataCode": string,
  "terminal": string,
  "gate": string
}
שדות
airportIataCode

string

אופציונלי. קוד שדה התעופה של IATA, בן 3 תווים, למשל SFO.

terminal

string

אופציונלי. שם הטרמינל, לדוגמה "אני".

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)

אופציונלי. מידע התבנית לגבי אופן הצגת המחלקה הגנרית.

SharedDataType

סוג נתוני המשתמשים שמשותפים עם המוכר בזמן ההרשמה.

טיפוסים בני מנייה (enum)
SHARED_DATA_TYPE_UNSPECIFIED סוג נתונים משותף לא מוגדר.
FIRST_NAME השם הפרטי של המשתמש.
LAST_NAME שם המשפחה של המשתמש.
STREET_ADDRESS הכתובת של המשתמש בשורה אחת.
ADDRESS_LINE_ONE השורה הראשונה בכתובת של המשתמש.
ADDRESS_LINE_TWO שורת הכתובת השנייה של המשתמש.
ADDRESS_LINE_THREE שורת הכתובת השלישית של המשתמש.
CITY העיר של המשתמש.
STATE הסטטוס של המשתמש.
ZIPCODE המיקוד של המשתמש.
COUNTRY המדינה של המשתמש.
EMAIL כתובת האימייל של המשתמש.
PHONE מספר הטלפון של המשתמש.

מדינה (State)

המצב של התוכנית הגלויה.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED המצב לא צוין.
TRUSTED_TESTERS התוכנית גלויה רק ​​לבודקים שיש להם גישה לחשבון המנפיק.
LIVE התוכנית גלויה לכל המשתמשים.
DISABLED התוכנית לא גלויה.

DateFormat

פורמט התאריך שבו יוצגו שדות של תאריך ושעה.

טיפוסים בני מנייה (enum)
DATE_FORMAT_UNSPECIFIED פורמט התאריך לא צוין.
DATE_TIME לדוגמה, הפונקציה מחזירה את הערך 2018-12-14T13:00:00 כ-Dec 14, 1:00 PM ב-en_US.
DATE_ONLY לדוגמה, התאריך 2018-12-14T13:00:00 מוצג כ-14 בדצמבר ב-en_US.
TIME_ONLY לדוגמה, התאריך 2018-12-14T13:00:00 מוצג כ-13:00 בפורמט en_US.
DATE_TIME_YEAR לדוגמה, הערך 2018-12-14T13:00:00 מוצג כ-14 בדצמבר 2018, בשעה 13:00 באזור en_US.
DATE_YEAR לדוגמה, התאריך 2018-12-14T13:00:00 מוצג כ-Dec 14, 2018 בפורמט en_US.
YEAR_MONTH לדוגמה, הפונקציה מעבדת את 2018-12-14T13:00:00 כ- 2018-12 ב- en_US.
YEAR_MONTH_DAY לדוגמה, התאריך 2018-12-14T13:00:00 מוצג כ-2018-12-14 ב-en_US.

PredefinedItem

הפריט המוגדר מראש שיוצג.

טיפוסים בני מנייה (enum)
PREDEFINED_ITEM_UNSPECIFIED לא צוין פריט מוגדר מראש.
FREQUENT_FLYER_PROGRAM_NAME_AND_NUMBER הפריט המוגדר מראש הוא שם ומספר של תוכנית נוסע מתמיד.
FLIGHT_NUMBER_AND_OPERATING_FLIGHT_NUMBER הפריט המוגדר מראש הוא מספר טיסה ומספר טיסת הפעלה.

TransitOption

אפשרות התחבורה הציבורית שתוצג.

טיפוסים בני מנייה (enum)
TRANSIT_OPTION_UNSPECIFIED אפשרות התחבורה הציבורית לא צוינה.
ORIGIN_AND_DESTINATION_NAMES אפשרות המעבר היא שמות המוצא והיעד.
ORIGIN_AND_DESTINATION_CODES אפשרות ההובלה היא קודי המוצא והיעד.
ORIGIN_NAME אפשרות המעבר היא שם המוצא.

RedemptionChannel

הערוצים שבהם אפשר לממש את המבצע הזה.

טיפוסים בני מנייה (enum)
REDEMPTION_CHANNEL_UNSPECIFIED לא צוין ערוץ המימוש.
IN_STORE אפשר לממש את המבצע רק בחנות.
ONLINE ניתן לממש את ההצעה באופן מקוון בלבד.
BOTH אפשר לממש את המבצע בחנות או באינטרנט.
TEMPORARY_PRICE_REDUCTION המבצע הוא הוזלת מחיר זמנית.

TransitType

סוג התחבורה של סיווג התנועה.

טיפוסים בני מנייה (enum)
TRANSIT_TYPE_UNSPECIFIED לא צוין סוג התחבורה הציבורית.
BUS סוג התחבורה הוא אוטובוס.
RAIL סוג התחבורה הוא רכבת.
TRAM סוג התחבורה הוא חשמלית.
FERRY סוג התחבורה הוא מעבורת.
FLIGHT סוג התחבורה הוא טיסה.
OTHER סוג התחבורה הוא אחר.

הערות על כלים

הערות על כלים נשלחות ללקוחות MCP כדי לתאר את הסיכון הבסיסי של כלי מסוים. רוב הלקוחות מתייחסים לרמזים האלה כאל רמזים לא מהימנים, אבל אפשר להשתמש בהם כדי להחליט מתי לשלוח למשתמש בקשת אישור.

בנוסף למחרוזת הכותרת, מוגדרים הרמזים הבוליאניים הבאים:

  • readOnlyHint: אם הערך הוא true, הכלי לא משנה את הסביבה שלו. ברירת מחדל: false.
  • destructiveHint: אם הערך הוא True, הכלי יכול לבצע פעולות הרסניות. אם הערך הוא false, הכלי יכול לבצע רק פעולות של הוספה. ברירת מחדל: true.
  • idempotentHint: אם הערך הוא True, קריאה חוזרת לכלי עם אותם ארגומנטים לא תשפיע על הסביבה שלו. ברירת מחדל: false.
  • openWorldHint: אם הערך הוא True, הכלי יכול ליצור אינטראקציה עם 'עולם פתוח' של ישויות חיצוניות. אם הערך הוא false, הכלי יכול ליצור אינטראקציה רק עם ישויות פנימיות. לדוגמה, כלי לחיפוש באינטרנט יהיה עולם פתוח, אבל כלי לזיכרון לא יהיה עולם פתוח.

רמז הרסני: ❌ | רמז אידמפוטנטי: ✅ | רמז לקריאה בלבד: ✅ | רמז לעולם פתוח: ❌