MCP Tools Reference: paydeveloper.googleapis.com

الأداة: list_pass_classes

يستردّ هذا الطلب قائمة شاملة بجميع فئات البطاقات المسجّلة في "وحدة تحكّم المؤسسات في محفظة Google" المرتبطة بالمستخدم الذي تمّت مصادقته. وتقدّم هذه الأداة معلومات أساسية للمطوّرين الذين يديرون بطاقات "محفظة Google"، مثل بطاقات الولاء أو بطاقات الهدايا أو رحلات الطيران.

يوضّح المثال التالي كيفية استخدام 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 tool's MCP 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

تمثّل هذه السمة نوع فئة البطاقة.

عمليات التعداد
PASS_TYPE_UNSPECIFIED لم يتم تحديد نوع البطاقة.
LOYALTY نوع البطاقة هو "بطاقة ولاء".
GIFT_CARD نوع البطاقة هو "بطاقة هدايا".
OFFER نوع البطاقة هو "عرض".
EVENT_TICKET نوع البطاقة هو "تذكرة لحضور فعالية".
FLIGHT نوع البطاقة هو "رحلة جوية".
TRANSIT نوع البطاقة هو "بطاقة نقل عام".
GENERIC نوع البطاقة هو "بطاقة عامة".

PassClassView

مستوى التفاصيل المطلوب عرضه لكل فئة من فئات التذاكر.

عمليات التعداد
PASS_CLASS_VIEW_UNSPECIFIED القيمة التلقائية أو غير المضبوطة ستستخدِم واجهة برمجة التطبيقات تلقائيًا طريقة العرض BASIC.
BASIC تضمين المعلومات الأساسية عن فئة البطاقة
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".

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) الذي يظهر في "محفظة Google" كنص

localizedDescription

object (LocalizedString)

اختياريّ. السلاسل المترجَمة لعنوان معرّف الموارد المنتظم (URI) الذي يظهر في "محفظة Google" كنص

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

اختياريّ. رقم الرحلة الجوية بدون رمز اتحاد النقل الجوي الدولي لشركة الطيران يحتوي الحقل على أرقام فقط، مثل "123".

FlightCarrier

تمثيل JSON
{
  "carrierIataCode": string,
  "carrierIcaoCode": string,
  "airlineLogoUri": string
}
الحقول
carrierIataCode

string

اختياريّ. رمز الاتحاد الدولي للنقل الجوي (IATA) المكوّن من حرفين لشركة الطيران

carrierIcaoCode

string

اختياريّ. رمز شركة الطيران المكوّن من ثلاثة أحرف وفقًا لمنظمة الطيران المدني الدولي (ICAO).

airlineLogoUri

string

اختياريّ. تمثّل هذه السمة شعار شركة الطيران الموصوفة برمز الاتحاد الدولي للنقل الجوي لشركة النقل.

AirportInfo

تمثيل JSON
{
  "airportIataCode": string,
  "terminal": string,
  "gate": string
}
الحقول
airportIataCode

string

اختياريّ. رمز مطار الاتحاد الدولي للنقل الجوي المكوّن من ثلاثة أحرف، مثل "SFO".

terminal

string

اختياريّ. اسم المحطة، مثلاً "I".

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

عمليات التعداد
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_UNSPECIFIED الحالة غير محدّدة.
TRUSTED_TESTERS لا يظهر البرنامج إلا للمختبِرين الذين يمكنهم الوصول إلى حساب الجهة المصدرة.
LIVE يكون البرنامج مرئيًا لجميع المستخدمين.
DISABLED البرنامج غير مرئي.

DateFormat

تنسيق التاريخ لعرض حقول التاريخ/الوقت.

عمليات التعداد
DATE_FORMAT_UNSPECIFIED لم يتم تحديد تنسيق التاريخ.
DATE_TIME على سبيل المثال، يتم عرض 2018-12-14T13:00:00 على النحو التالي: 14 كانون الأول (ديسمبر)، 1:00 مساءً في en_US.
DATE_ONLY على سبيل المثال، يتم عرض 2018-12-14T13:00:00 على النحو التالي: 14 كانون الأول (ديسمبر) باللغة الإنجليزية (الولايات المتحدة).
TIME_ONLY على سبيل المثال، يتم عرض 2018-12-14T13:00:00 على النحو 1:00 مساءً في en_US.
DATE_TIME_YEAR على سبيل المثال، يتم عرض 2018-12-14T13:00:00 على النحو التالي: 14 كانون الأول (ديسمبر) 2018، الساعة 1:00 مساءً في en_US.
DATE_YEAR على سبيل المثال، يتم عرض 2018-12-14T13:00:00 على النحو التالي: 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

تمثّل هذه السمة العنصر المحدّد مسبقًا الذي سيتم عرضه.

عمليات التعداد
PREDEFINED_ITEM_UNSPECIFIED لم يتم تحديد العنصر المحدّد مسبقًا.
FREQUENT_FLYER_PROGRAM_NAME_AND_NUMBER العنصر المحدّد مسبقًا هو اسم برنامج المسافر الدائم ورقمه.
FLIGHT_NUMBER_AND_OPERATING_FLIGHT_NUMBER العنصر المحدّد مسبقًا هو رقم الرحلة الجوية ورقم الرحلة المشغِّلة.

TransitOption

خيار النقل العام الذي سيتم عرضه

عمليات التعداد
TRANSIT_OPTION_UNSPECIFIED لم يتم تحديد خيار النقل العام.
ORIGIN_AND_DESTINATION_NAMES خيار النقل العام هو أسماء نقطة الانطلاق والوجهة.
ORIGIN_AND_DESTINATION_CODES خيار النقل هو رموز نقطة الانطلاق والوجهة.
ORIGIN_NAME خيار النقل العام هو اسم نقطة الانطلاق.

RedemptionChannel

قنوات تحصيل القيمة السارية على هذا العرض

عمليات التعداد
REDEMPTION_CHANNEL_UNSPECIFIED لم يتم تحديد كيفية تحصيل القيمة.
IN_STORE لا يمكن الاستفادة من العرض إلا في المتجر.
ONLINE يمكن الاستفادة من العرض على الإنترنت فقط.
BOTH يمكن الاستفادة من العرض في المتجر أو على الإنترنت.
TEMPORARY_PRICE_REDUCTION العرض هو تخفيض مؤقت في السعر.

TransitType

نوع النقل العام لفئة النقل العام

عمليات التعداد
TRANSIT_TYPE_UNSPECIFIED لم يتم تحديد نوع النقل العام.
BUS نوع النقل العام هو حافلة.
RAIL نوع النقل العام هو السكك الحديدية.
TRAM نوع النقل العام هو الترام.
FERRY نوع النقل العام هو عبّارة.
FLIGHT نوع النقل العام هو رحلة جوية.
OTHER نوع النقل هو "غير ذلك".

التعليقات التوضيحية للأدوات

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