تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

MCP Tools Reference: paydeveloper.googleapis.com

الأداة: `list_pass_classes`

تعرض هذه الطريقة قائمة شاملة بجميع فئات البطاقات المسجّلة في Business Console في محفظة Google المرتبطة بالمستخدم الذي تمّت مصادقته. تقدّم هذه الأداة معلومات أساسية للمطوّرين الذين يديرون بطاقات 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 }'

طلب 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)` اختياريّ. تحدّد هذه السمة مستوى التفاصيل التي سيتم عرضها لكل فئة بطاقة.

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.
`PASS_CLASS_VIEW_BASIC`	تضمين المعلومات الأساسية عن فئة البطاقة
`PASS_CLASS_VIEW_FULL`	يجب تضمين جميع تفاصيل فئة التذكرة.

مخطط النتائج

رسالة الردّ لعرض فئات البطاقات الصادرة عن جهة إصدار

ListPassClassesResponse

تمثيل JSON
{ "passClasses": [ { object (`PassClass`) } ] }

الحقول

الحقول
`passClasses[]`	`object (PassClass)` فئات البطاقات التي تصدرها الجهة.

passClasses[]

object (PassClass)

فئات البطاقات التي تصدرها الجهة.

PassClass

تمثيل JSON

تمثيل 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`. }

{

  // 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

تمثيل 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,
  "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)` اختياريّ. السلسلة التي سيتم عرضها في حال عدم توفّر ترجمة مناسبة.

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

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

object (MerchantSignupInfo)

اختياريّ. المعلومات المتعلقة بإمكانية التسجيل وإضافة قيمة لهذا البرنامج القابل للاكتشاف من خلال موقع التاجر.

merchantSigninInfo

object (MerchantSigninInfo)

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

state

enum (State)

النتائج فقط. تمثّل هذه السمة حالة البرنامج القابل للاكتشاف.

MerchantSignupInfo

تمثيل JSON
{ "signupWebsite": { object (`Uri`) }, "signupSharedDatas": [ enum (`SharedDataType`) ] }

الحقول

الحقول
`signupWebsite`	`object (Uri)` اختياريّ. الموقع الإلكتروني للاشتراك في البرنامج القابل للاكتشاف
`signupSharedDatas[]`	`enum (SharedDataType)` اختياريّ. بيانات المستخدم التي يتم إرسالها في طلب POST إلى عنوان URL الخاص بموقع الاشتراك الإلكتروني يتم ترميز هذه المعلومات ثم مشاركتها حتى يتمكّن موقع التاجر الإلكتروني من ملء الحقول مسبقًا التي تُستخدَم لتسجيل المستخدم في البرنامج القابل للاكتشاف.

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" كنص

uri

string

اختياريّ. المعرف الموحد للموارد (URI).

description

string

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

localizedDescription

object (LocalizedString)

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

MerchantSigninInfo

تمثيل JSON
{ "signinWebsite": { object (`Uri`) } }

الحقول

الحقول
`signinWebsite`	`object (Uri)` اختياريّ. الموقع الإلكتروني الذي يمكن تسجيل الدخول إليه للاستفادة من البرنامج القابل للاكتشاف

signinWebsite

object (Uri)

اختياريّ. الموقع الإلكتروني الذي يمكن تسجيل الدخول إليه للاستفادة من البرنامج القابل للاكتشاف

ClassTemplateInfo

تمثيل JSON

تمثيل 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`	`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، سيتم عرضها على الجانب الأيسر من قسم التفاصيل هذا.

firstTopDetail

object (BarcodeSectionDetail)

اختياريّ. المعلومات الاختيارية التي سيتم عرضها فوق الرمز الشريطي إذا تم تحديد secondTopDetail، سيتم عرضها على الجانب الأيمن من قسم التفاصيل هذا.

firstBottomDetail

object (BarcodeSectionDetail)

اختياريّ. المعلومات الاختيارية التي سيتم عرضها أسفل الرمز الشريطي

secondTopDetail

object (BarcodeSectionDetail)

اختياريّ. المعلومات الثانية الاختيارية التي سيتم عرضها فوق الرمز الشريطي إذا تم تحديد firstTopDetail، سيتم عرضها على الجانب الأيسر من قسم التفاصيل هذا.

BarcodeSectionDetail

تمثيل JSON
{ "fieldSelector": { object (`FieldSelector`) } }

الحقول

الحقول
`fieldSelector`	`object (FieldSelector)` اختياريّ. مرجع إلى حقل نصي أو حقل صور حالي سيتم عرضه

fieldSelector

object (FieldSelector)

اختياريّ. مرجع إلى حقل نصي أو حقل صور حالي سيتم عرضه

FieldSelector

تمثيل JSON
{ "fields": [ { object (`FieldReference`) } ] }

الحقول

الحقول
`fields[]`	`object (FieldReference)` اختياريّ. مراجع الحقول التي سيتم استخدامها مع عمليات إلغاء الحقول في حال تقديم أكثر من مرجع واحد، سيتم عرض المرجع الأول الذي يشير إلى حقل غير فارغ.

fields[]

object (FieldReference)

اختياريّ. مراجع الحقول التي سيتم استخدامها مع عمليات إلغاء الحقول في حال تقديم أكثر من مرجع واحد، سيتم عرض المرجع الأول الذي يشير إلى حقل غير فارغ.

FieldReference

تمثيل JSON
{ "fieldPath": string, "dateFormat": enum (`DateFormat`) }

الحقول

الحقول
`fieldPath`	`string` اختياريّ. مسار الحقل الذي تتم الإشارة إليه، مسبوقًا بـ "object" أو "class" ومفصولاً بنقاط
`dateFormat`	`enum (DateFormat)` اختياريّ. تنسيق التاريخ لعرض حقول التاريخ/الوقت.

fieldPath

string

اختياريّ. مسار الحقل الذي تتم الإشارة إليه، مسبوقًا بـ "object" أو "class" ومفصولاً بنقاط

dateFormat

enum (DateFormat)

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

CardTemplateOverride

تمثيل JSON
{ "cardRowTemplateInfos": [ { object (`CardRowTemplateInfo`) } ] }

الحقول

الحقول
`cardRowTemplateInfos[]`	`object (CardRowTemplateInfo)` اختياريّ. معلومات القالب حول الصفوف في عرض البطاقة. يُسمح بتحديد ثلاثة صفوف كحدّ أقصى.

cardRowTemplateInfos[]

object (CardRowTemplateInfo)

اختياريّ. معلومات القالب حول الصفوف في عرض البطاقة. يُسمح بتحديد ثلاثة صفوف كحدّ أقصى.

CardRowTemplateInfo

تمثيل JSON

تمثيل 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`. }

{

  // 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)` اختياريّ. العنصر المطلوب عرضه في الصف سيتم توسيط هذا العنصر.

item

object (TemplateItem)

اختياريّ. العنصر المطلوب عرضه في الصف سيتم توسيط هذا العنصر.

TemplateItem

تمثيل JSON
{ "firstValue": { object (`FieldSelector`) }, "secondValue": { object (`FieldSelector`) }, "predefinedItem": enum (`PredefinedItem`) }

الحقول

الحقول
`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)` اختياريّ. العنصر الذي سيتم عرضه في نهاية الصف سيتم محاذاة هذا العنصر إلى اليسار.

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)` اختياريّ. العنصر الذي سيتم عرضه في نهاية الصف سيتم محاذاة هذا العنصر إلى اليسار.

startItem

object (TemplateItem)

اختياريّ. العنصر الذي سيتم عرضه في بداية الصف ستتم محاذاة هذا العنصر إلى اليسار.

middleItem

object (TemplateItem)

اختياريّ. العنصر المراد عرضه في منتصف الصف. سيتم توسيط هذا العنصر بين عنصري البداية والنهاية.

endItem

object (TemplateItem)

اختياريّ. العنصر الذي سيتم عرضه في نهاية الصف سيتم محاذاة هذا العنصر إلى اليسار.

DetailsTemplateOverride

تمثيل JSON
{ "detailsItemInfos": [ { object (`DetailsItemInfo`) } ] }

الحقول

الحقول
`detailsItemInfos[]`	`object (DetailsItemInfo)` اختياريّ. معلومات النموذج حول العناصر المعروضة في قائمة التفاصيل

detailsItemInfos[]

object (DetailsItemInfo)

اختياريّ. معلومات النموذج حول العناصر المعروضة في قائمة التفاصيل

DetailsItemInfo

تمثيل JSON
{ "item": { object (`TemplateItem`) } }

الحقول

الحقول
`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

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

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`	نوع النقل هو "غير ذلك".

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

يتم إرسال تعليقات توضيحية للأدوات إلى عملاء MCP لوصف المخاطر الأساسية لأداة معيّنة. تتعامل معظم البرامج مع هذه التلميحات على أنّها غير موثوق بها، ولكن يمكن استخدامها لتحديد الوقت الذي قد يتم فيه إرسال طلب تأكيد إلى المستخدم.

بالإضافة إلى سلسلة العنوان، يتم تحديد تلميحات القيم المنطقية التالية على النحو التالي:

‫readOnlyHint: إذا كانت القيمة صحيحة، لن تعدّل الأداة بيئتها. القيمة التلقائية: false.
‫destructiveHint: إذا كانت القيمة صحيحة، يمكن للأداة تنفيذ إجراءات مدمّرة. إذا كانت القيمة "خطأ"، يمكن للأداة تنفيذ إجراءات إضافية فقط. القيمة التلقائية: true
idempotentHint: إذا كانت القيمة صحيحة، لن يكون لاستدعاء الأداة بشكل متكرر باستخدام الوسيطات نفسها أي تأثير إضافي على بيئتها. القيمة التلقائية: false.
openWorldHint: إذا كانت القيمة صحيحة، يمكن للأداة التفاعل مع "عالم مفتوح" من الكيانات الخارجية. إذا كانت القيمة خطأ، يمكن للأداة التفاعل مع الكيانات الداخلية فقط. على سبيل المثال، ستكون أداة البحث على الويب عالمًا مفتوحًا، بينما لن تكون أداة الذاكرة عالمًا مفتوحًا.

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

MCP Tools Reference: paydeveloper.googleapis.com تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الأداة: list_pass_classes

مخطط الإدخال

ListPassClassesRequest

PassType

PassClassView

مخطط النتائج

ListPassClassesResponse

PassClass

LoyaltyClass

LocalizedString

TranslatedString

DiscoverableProgram

MerchantSignupInfo

يوري

MerchantSigninInfo

ClassTemplateInfo

CardBarcodeSectionDetails

BarcodeSectionDetail

FieldSelector

FieldReference

CardTemplateOverride

CardRowTemplateInfo

CardRowOneItem

TemplateItem

CardRowTwoItems

CardRowThreeItems

DetailsTemplateOverride

DetailsItemInfo

ListTemplateOverride

FirstRowOption

GiftCardClass

OfferClass

EventTicketClass

EventVenue

EventDateTime

FlightClass

FlightHeader

FlightCarrier

AirportInfo

TransitClass

GenericClass

SharedDataType

ولاية

DateFormat

PredefinedItem

TransitOption

RedemptionChannel

TransitType

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

MCP Tools Reference: paydeveloper.googleapis.com

الأداة: `list_pass_classes`