الأداة: 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 ( |
| الحقول | |
|---|---|
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". |
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" كنص |
localizedDescription |
اختياريّ. السلاسل المترجَمة لعنوان معرّف الموارد المنتظم (URI) الذي يظهر في "محفظة Google" كنص |
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. يجب أن يكون هذا هو التاريخ/الوقت المحلي في المطار (وليس بالتوقيت العالمي المنسَّق). |
hexBackgroundColor |
اختياريّ. لون خلفية فئة الرحلة. التنسيق هو سلسلة لون ست عشري، مثل "#RRGGBB". |
heroImageUri |
اختياريّ. صورة البانر المعروضة على واجهة فئة الرحلة الجوية |
classTemplateInfo |
اختياريّ. تمثّل هذه السمة معلومات النموذج حول كيفية عرض درجة السفر. |
FlightHeader
| تمثيل JSON |
|---|
{
"carrier": {
object ( |
| الحقول | |
|---|---|
carrier |
اختياريّ. تعرض هذه السمة معلومات عن شركة الطيران. |
flightNumber |
اختياريّ. رقم الرحلة الجوية بدون رمز اتحاد النقل الجوي الدولي لشركة الطيران يحتوي الحقل على أرقام فقط، مثل "123". |
FlightCarrier
| تمثيل JSON |
|---|
{ "carrierIataCode": string, "carrierIcaoCode": string, "airlineLogoUri": string } |
| الحقول | |
|---|---|
carrierIataCode |
اختياريّ. رمز الاتحاد الدولي للنقل الجوي المكوّن من حرفين لشركة الطيران |
carrierIcaoCode |
اختياريّ. تمثّل هذه السمة رمز ICAO المكوَّن من ثلاثة أحرف لشركة الطيران. |
airlineLogoUri |
اختياريّ. تمثّل هذه السمة شعار شركة الطيران المحدّدة برمز الاتحاد الدولي للنقل الجوي. |
AirportInfo
| تمثيل JSON |
|---|
{ "airportIataCode": string, "terminal": string, "gate": string } |
| الحقول | |
|---|---|
airportIataCode |
اختياريّ. رمز مطار الاتحاد الدولي للنقل الجوي المكوّن من ثلاثة أحرف، مثل "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 |
اختياريّ. معلومات النموذج حول كيفية عرض الفئة العامة |
التعليقات التوضيحية للأدوات
Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌