ابزار: list_pass_classes
فهرست جامعی از تمام کلاسهای مجوز ثبتشده در کنسول تجاری Google Wallet مرتبط با کاربر احراز هویتشده را بازیابی میکند. این ابزار اطلاعات ضروری را برای توسعهدهندگانی که مجوزهای Wallet مانند کارتهای وفاداری، کارتهای هدیه یا پروازها را مدیریت میکنند، فراهم میکند.
مثال زیر نحوه استفاده از curl برای فراخوانی ابزار list_pass_classes MCP را نشان میدهد.
| درخواست کرل |
|---|
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 }' |
طرحواره ورودی
درخواست پیام برای فهرست کردن کلاسهای قبولی یک صادرکننده.
درخواست کلاسهای ListPass
| نمایش JSON |
|---|
{ "issuerId": string, "passType": enum ( |
| فیلدها | |
|---|---|
issuerId | الزامی. شناسه منحصر به فرد صادرکنندهای که کلاسهای قبولی برای آن فهرست میشوند. |
passType | اختیاری. نوع کلاس عبوری که باید لیست شود. اگر مشخص نشود، همه انواع کلاسهای عبوری برگردانده میشوند. |
view | اختیاری. سطح جزئیاتی که برای هر کلاس عبور باید برگردانده شود را مشخص میکند. |
طرحواره خروجی
پیام پاسخ برای فهرست کردن کلاسهای قبولی یک صادرکننده.
ListPassClassesResponse
| نمایش JSON |
|---|
{
"passClasses": [
{
object ( |
| فیلدها | |
|---|---|
passClasses[] | کلاسهای قبولی صادرکننده. |
کلاس عبور
| نمایش JSON |
|---|
{ // Union field |
| فیلدها | |
|---|---|
| |
loyaltyClass | اختیاری. کلاس وفاداری صادرکننده. |
giftCardClass | اختیاری. کلاس کارت هدیه صادرکننده. |
offerClass | اختیاری. کلاس عرضه صادرکننده. |
eventTicketClass | اختیاری. کلاس بلیط رویداد صادرکننده. |
flightClass | اختیاری. کلاس پرواز صادرکننده. |
transitClass | اختیاری. کلاس ترانزیت صادرکننده. |
genericClass | اختیاری. کلاس عمومی صادرکننده. |
کلاس وفاداری
| نمایش JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| فیلدها | |
|---|---|
id | اختیاری. شناسه کلاس وفاداری. |
issuerName | اختیاری. نام صادرکننده کلاس وفاداری. |
localizedIssuerName | اختیاری. نام صادرکننده محلی کلاس وفاداری. |
programName | اختیاری. نام برنامه کلاس وفاداری. |
localizedProgramName | اختیاری. نام برنامه محلیسازی شده کلاس وفاداری. |
programLogoUri | اختیاری. لوگوی برنامه کلاس وفاداری. |
hexBackgroundColor | اختیاری. رنگ پسزمینه کلاس وفاداری. قالب آن یک رشته رنگ هگز است، مثلاً "#RRGGBB". |
heroImageUri | اختیاری. تصویر بنری که در جلوی کلاس وفاداری نمایش داده میشود. |
discoverableProgram | اختیاری. اطلاعات مربوط به نحوه کشف و نمونهسازی کلاس وفاداری از داخل Google Wallet. |
classTemplateInfo | اختیاری. اطلاعات قالب در مورد نحوه نمایش کلاس وفاداری. |
رشته محلی
| نمایش JSON |
|---|
{ "translatedValues": [ { object ( |
| فیلدها | |
|---|---|
translatedValues[] | اختیاری. رشتههای ترجمه شده برای رشته. |
defaultValue | اختیاری. رشتهای که در صورت عدم وجود ترجمه مناسب نمایش داده میشود. |
رشته ترجمه شده
| نمایش JSON |
|---|
{ "languageCode": string, "value": string } |
| فیلدها | |
|---|---|
languageCode | اختیاری. برچسب زبان BCP 47. مقادیر مثال عبارتند از "en-US"، "en-GB"، "de" یا "de-AT". |
value | اختیاری. رشته ترجمه شده با کدگذاری UTF-8. |
برنامهی قابل کشف
| نمایش JSON |
|---|
{ "merchantSignupInfo": { object ( |
| فیلدها | |
|---|---|
merchantSignupInfo | اختیاری. اطلاعات مربوط به امکان ثبت نام و اضافه کردن یک آیتم ارزشمند به این برنامه قابل کشف از طریق یک سایت تجاری. |
merchantSigninInfo | اختیاری. اطلاعات مربوط به امکان ورود و اضافه کردن یک آیتم ارزشمند به این برنامه قابل کشف از طریق یک سایت تجاری. |
state | فقط خروجی. وضعیت برنامه قابل کشف. |
اطلاعات ثبت نام فروشنده
| نمایش JSON |
|---|
{ "signupWebsite": { object ( |
| فیلدها | |
|---|---|
signupWebsite | اختیاری. وبسایتی که باید در آن در برنامهی قابل کشف ثبتنام کنید. |
signupSharedDatas[] | اختیاری. دادههای کاربر که در یک درخواست POST به آدرس اینترنتی وبسایت ثبتنام ارسال میشود. این اطلاعات کدگذاری شده و سپس به اشتراک گذاشته میشود تا وبسایت فروشنده بتواند فیلدهای مورد استفاده برای ثبتنام کاربر در برنامهی قابل کشف را از قبل پر کند. |
اوری
| نمایش JSON |
|---|
{
"uri": string,
"description": string,
"localizedDescription": {
object ( |
| فیلدها | |
|---|---|
uri | اختیاری. آدرس اینترنتی (URI). |
description | اختیاری. عنوان URI که به صورت متن در Google Wallet نمایش داده میشود. |
localizedDescription | اختیاری. رشتههای ترجمهشده عنوان URI که به صورت متن در Google Wallet نمایش داده میشوند. |
اطلاعات ورود به سیستم فروشنده
| نمایش JSON |
|---|
{
"signinWebsite": {
object ( |
| فیلدها | |
|---|---|
signinWebsite | اختیاری. وبسایتی که باید برای ورود به برنامهی قابل کشف، وارد آن شوید. |
اطلاعات الگوی کلاس
| نمایش JSON |
|---|
{ "cardBarcodeSectionDetails": { object ( |
| فیلدها | |
|---|---|
cardBarcodeSectionDetails | اختیاری. اطلاعات اضافی که در بالا و پایین بارکد نمایش داده میشود. |
cardTemplateOverride | اختیاری. قالب برای نمای کارت بازنویسی میشود. |
detailsTemplateOverride | اختیاری. قالب برای نمای جزئیات بازنویسی میشود. |
listTemplateOverride | اختیاری. قالب برای نمای لیست گذرگاهها بازنویسی میشود. |
جزئیات بخش بارکد کارت
| نمایش JSON |
|---|
{ "firstTopDetail": { object ( |
| فیلدها | |
|---|---|
firstTopDetail | اختیاری. اطلاعات اختیاری که بالای بارکد نمایش داده میشود. اگر secondTopDetail تعریف شده باشد، این اطلاعات در سمت شروع این بخش جزئیات نمایش داده میشود. |
firstBottomDetail | اختیاری. اطلاعات اختیاری که قرار است زیر بارکد نمایش داده شود. |
secondTopDetail | اختیاری. بخش دوم اطلاعات اختیاری که بالای بارکد نمایش داده میشود. اگر firstTopDetail تعریف شده باشد، در انتهای این بخش جزئیات نمایش داده خواهد شد. |
جزئیات بخش بارکد
| نمایش JSON |
|---|
{
"fieldSelector": {
object ( |
| فیلدها | |
|---|---|
fieldSelector | اختیاری. ارجاع به یک فیلد متنی یا تصویری موجود که قرار است نمایش داده شود. |
انتخابگر فیلد
| نمایش JSON |
|---|
{
"fields": [
{
object ( |
| فیلدها | |
|---|---|
fields[] | اختیاری. فیلدی که قرار است با لغو فیلدها استفاده شود، به فیلد ارجاع میدهد. اگر بیش از یک ارجاع ارائه شود، اولین ارجاعی که به فیلد غیر خالی ارجاع میدهد، نمایش داده خواهد شد. |
فیلدرفرنس
| نمایش JSON |
|---|
{
"fieldPath": string,
"dateFormat": enum ( |
| فیلدها | |
|---|---|
fieldPath | اختیاری. مسیر فیلد مورد ارجاع، با پیشوند «object» یا «class» و جدا شده با نقطه. |
dateFormat | اختیاری. قالب تاریخ برای نمایش فیلدهای تاریخ/زمان. |
لغو قالب کارت
| نمایش JSON |
|---|
{
"cardRowTemplateInfos": [
{
object ( |
| فیلدها | |
|---|---|
cardRowTemplateInfos[] | اختیاری. اطلاعات قالب در مورد ردیفها در نمای کارت. حداکثر سه ردیف مجاز به تعیین هستند. |
اطلاعات الگوی ردیف کارت
| نمایش JSON |
|---|
{ // Union field |
| فیلدها | |
|---|---|
فیلد اتحادیه row_template . قالب برای ردیفی که شامل یک، دو یا سه مورد است. row_template فقط میتواند یکی از موارد زیر باشد: | |
oneItem | اختیاری. قالب برای ردیفی که شامل یک آیتم است. |
twoItems | اختیاری. قالب برای ردیفی که شامل دو آیتم است. |
threeItems | اختیاری. قالب برای ردیفی که شامل سه آیتم است. |
ردیف کارت، یک مورد
| نمایش JSON |
|---|
{
"item": {
object ( |
| فیلدها | |
|---|---|
item | اختیاری. آیتمی که قرار است در ردیف نمایش داده شود. این آیتم در مرکز قرار خواهد گرفت. |
مورد الگو
| نمایش JSON |
|---|
{ "firstValue": { object ( |
| فیلدها | |
|---|---|
firstValue | اختیاری. ارجاع به اولین فیلدی که نمایش داده میشود. |
secondValue | اختیاری. ارجاع به فیلد دومی که قرار است نمایش داده شود. |
predefinedItem | اختیاری. مورد از پیش تعریف شدهای که قرار است نمایش داده شود. |
دو آیتم از ردیف کارتها
| نمایش JSON |
|---|
{ "startItem": { object ( |
| فیلدها | |
|---|---|
startItem | اختیاری. آیتمی که قرار است در ابتدای ردیف نمایش داده شود. این آیتم در سمت چپ ترازبندی خواهد شد. |
endItem | اختیاری. آیتمی که قرار است در انتهای ردیف نمایش داده شود. این آیتم در سمت راست ترازبندی خواهد شد. |
ردیف کارت سه آیتم
| نمایش JSON |
|---|
{ "startItem": { object ( |
| فیلدها | |
|---|---|
startItem | اختیاری. آیتمی که قرار است در ابتدای ردیف نمایش داده شود. این آیتم در سمت چپ ترازبندی خواهد شد. |
middleItem | اختیاری. آیتمی که قرار است در وسط ردیف نمایش داده شود. این آیتم بین آیتمهای شروع و پایان در مرکز قرار میگیرد. |
endItem | اختیاری. آیتمی که قرار است در انتهای ردیف نمایش داده شود. این آیتم در سمت راست ترازبندی خواهد شد. |
جزئیاتالگو لغو شده
| نمایش JSON |
|---|
{
"detailsItemInfos": [
{
object ( |
| فیلدها | |
|---|---|
detailsItemInfos[] | اختیاری. اطلاعات قالب مربوط به موارد نمایش داده شده در لیست جزئیات. |
جزئیاتاطلاعات کالا
| نمایش JSON |
|---|
{
"item": {
object ( |
| فیلدها | |
|---|---|
item | اختیاری. موردی که قرار است در لیست جزئیات نمایش داده شود. |
نادیده گرفتن الگو لیست
| نمایش JSON |
|---|
{ "firstRowOption": { object ( |
| فیلدها | |
|---|---|
firstRowOption | اختیاری. ارجاع به فیلدی که قرار است در ردیف اول نمایش داده شود. |
secondRowOption | اختیاری. ارجاع به فیلدی که قرار است در ردیف دوم نمایش داده شود. |
گزینه ردیف اول
| نمایش JSON |
|---|
{ "transitOption": enum ( |
| فیلدها | |
|---|---|
transitOption | اختیاری. گزینه حمل و نقل عمومی که در ردیف اول نمایش داده میشود. |
fieldOption | اختیاری. ارجاع به فیلدی که قرار است در ردیف اول نمایش داده شود. |
کلاس کارت هدیه
| نمایش JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| فیلدها | |
|---|---|
id | اختیاری. شناسه کلاس کارت هدیه. |
issuerName | اختیاری. نام صادرکنندهی کلاس کارت هدیه. |
localizedIssuerName | اختیاری. نام صادرکننده محلی کلاس کارت هدیه. |
merchantName | اختیاری. نام تجاری کلاس کارت هدیه. |
localizedMerchantName | اختیاری. نام تجاری محلیشدهی کلاس کارت هدیه. |
programLogoUri | اختیاری. لوگوی برنامه کلاس کارت هدیه. |
hexBackgroundColor | اختیاری. رنگ پسزمینه کلاس کارت هدیه. قالب آن یک رشته رنگ هگز است، مثلاً "#RRGGBB". |
heroImageUri | اختیاری. تصویر بنر نمایش داده شده در جلوی کلاس کارت هدیه. |
homePageUri | اختیاری. وبسایت صفحه اصلی برنامه. |
classTemplateInfo | اختیاری. اطلاعات قالب در مورد نحوه نمایش کلاس کارت هدیه. |
کلاس پیشنهاد
| نمایش JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| فیلدها | |
|---|---|
id | اختیاری. شناسه کلاس پیشنهاد. |
issuerName | اختیاری. نام صادرکنندهی کلاس پیشنهادی. |
localizedIssuerName | اختیاری. نام صادرکننده محلی کلاس پیشنهاد. |
provider | اختیاری. ارائه دهنده کلاس پیشنهاد. |
localizedProvider | اختیاری. ارائه دهنده محلی کلاس پیشنهاد. |
title | اختیاری. عنوان کلاس پیشنهادی. |
localizedTitle | اختیاری. عنوان محلیشدهی کلاس پیشنهادی. |
titleImageUri | اختیاری. تصویر عنوان کلاس پیشنهاد. |
hexBackgroundColor | اختیاری. رنگ پسزمینه کلاس پیشنهاد. قالب آن یک رشته رنگ هگز است، مثلاً "#RRGGBB". |
heroImageUri | اختیاری. تصویر بنر نمایش داده شده در جلوی کلاس پیشنهادی. |
redemptionChannel | اختیاری. کانال بازخرید کلاس پیشنهادی. |
classTemplateInfo | اختیاری. اطلاعات قالب در مورد نحوه نمایش کلاس پیشنهاد. |
کلاس بلیط رویداد
| نمایش JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| فیلدها | |
|---|---|
id | اختیاری. شناسه کلاس بلیط رویداد. |
issuerName | اختیاری. نام صادرکنندهی کلاس بلیط رویداد. |
localizedIssuerName | اختیاری. نام صادرکننده محلی کلاس بلیط رویداد. |
logoUri | اختیاری. لوگوی کلاس بلیط رویداد. |
eventName | اختیاری. نام رویداد. |
venue | اختیاری. محل برگزاری رویداد. |
dateTime | اختیاری. اطلاعات مربوط به تاریخ و زمان رویداد. |
hexBackgroundColor | اختیاری. رنگ پسزمینه کلاس بلیط رویداد. قالب آن یک رشته رنگ هگز است، مثلاً "#RRGGBB". |
heroImageUri | اختیاری. تصویر بنری که در جلوی کلاس بلیط رویداد نمایش داده میشود. |
classTemplateInfo | اختیاری. اطلاعات قالب در مورد نحوه نمایش کلاس بلیط رویداد. |
محل برگزاری رویداد
| نمایش JSON |
|---|
{ "name": { object ( |
| فیلدها | |
|---|---|
name | اختیاری. نام محل برگزاری. |
address | اختیاری. آدرس محل برگزاری. |
تاریخ رویداد
| نمایش JSON |
|---|
{ "start": string, "end": string } |
| فیلدها | |
|---|---|
start | اختیاری. تاریخ/زمان شروع رویداد. اگر رویداد چندین روز را در بر میگیرد، باید تاریخ/زمان شروع در روز اول باشد. قالب، تاریخ/زمان با فرمت توسعهیافته ISO 8601 بدون انحراف است و زمان میتواند تا دقت میلیثانیه مشخص شود، مثلاً 2027-03-05T06:30:00. |
end | اختیاری. تاریخ/زمانی که رویداد پایان مییابد. اگر رویداد چندین روز طول بکشد، باید تاریخ/زمان پایان در آخرین روز باشد. قالب، تاریخ/زمان با فرمت توسعهیافته ISO 8601 بدون آفست است و زمان میتواند تا دقت میلیثانیه مشخص شود، مثلاً 2027-03-05T06:30:00. |
کلاس پرواز
| نمایش JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| فیلدها | |
|---|---|
id | اختیاری. شناسه کلاس پرواز. |
issuerName | اختیاری. نام صادرکننده کلاس پرواز. |
localizedIssuerName | اختیاری. نام صادرکننده محلی کلاس پرواز. |
flightHeader | اختیاری. اطلاعات مربوط به شرکت هواپیمایی و شماره آن. |
origin | اختیاری. اطلاعات مربوط به فرودگاه مبدا. |
destination | اختیاری. اطلاعات مربوط به فرودگاه مقصد. |
localScheduledDepartureDateTime | اختیاری. تاریخ و زمان برنامهریزیشدهای که انتظار میرود هواپیما از گیت (و نه باند) خارج شود. قالب، تاریخ/زمان با فرمت توسعهیافته ISO 8601 بدون انحراف است و زمان میتواند تا دقت میلیثانیه مشخص شود، مثلاً 2027-03-05T06:30:00. این باید تاریخ/زمان محلی فرودگاه باشد (نه زمان UTC). |
hexBackgroundColor | اختیاری. رنگ پسزمینه کلاس پرواز. قالب آن یک رشته رنگ هگز است، مثلاً "#RRGGBB". |
heroImageUri | اختیاری. تصویر بنری که در جلوی کلاس پرواز نمایش داده میشود. |
classTemplateInfo | اختیاری. اطلاعات قالب در مورد نحوه نمایش کلاس پرواز. |
سربرگ پرواز
| نمایش JSON |
|---|
{
"carrier": {
object ( |
| فیلدها | |
|---|---|
carrier | اختیاری. اطلاعات مربوط به شرکت هواپیمایی. |
flightNumber | اختیاری. شماره پرواز بدون کد یاتا شرکت هواپیمایی. این فیلد فقط شامل اعداد است، مثلاً "123". |
شرکت حمل و نقل هوایی
| نمایش JSON |
|---|
{ "carrierIataCode": string, "carrierIcaoCode": string, "airlineLogoUri": string } |
| فیلدها | |
|---|---|
carrierIataCode | اختیاری. کد دو حرفی یاتا شرکت هواپیمایی حامل. |
carrierIcaoCode | اختیاری. کد سه حرفی ایکائو شرکت هواپیمایی مربوطه. |
airlineLogoUri | اختیاری. لوگوی شرکت هواپیمایی که با کد یاتا شرکت هواپیمایی توصیف شده است. |
اطلاعات فرودگاه
| نمایش JSON |
|---|
{ "airportIataCode": string, "terminal": string, "gate": string } |
| فیلدها | |
|---|---|
airportIataCode | اختیاری. کد سه حرفی فرودگاه IATA، مثلاً "SFO". |
terminal | اختیاری. نام ترمینال، مثلاً "I". |
gate | اختیاری. نام گیت، مثلاً "B59". |
کلاس ترانزیت
| نمایش JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| فیلدها | |
|---|---|
id | اختیاری. شناسه کلاس حمل و نقل. |
issuerName | اختیاری. نام صادرکننده کلاس ترانزیت. |
localizedIssuerName | اختیاری. نام صادرکننده محلی کلاس ترانزیت. |
hexBackgroundColor | اختیاری. رنگ پسزمینه کلاس حمل و نقل. قالب آن یک رشته رنگ هگز است، مثلاً "#RRGGBB". |
heroImageUri | اختیاری. تصویر بنری که در جلوی کلاس حمل و نقل عمومی نمایش داده میشود. |
transitType | اختیاری. نوع ترانزیت کلاس ترانزیت. |
classTemplateInfo | اختیاری. اطلاعات قالب در مورد نحوه نمایش کلاس حمل و نقل. |
کلاس عمومی
| نمایش JSON |
|---|
{
"id": string,
"classTemplateInfo": {
object ( |
| فیلدها | |
|---|---|
id | اختیاری. شناسه کلاس عمومی. |
classTemplateInfo | اختیاری. اطلاعات قالب در مورد نحوه نمایش کلاس عمومی. |
حاشیهنویسی ابزار
راهنمایی مخرب: ❌ | راهنمایی بیاثر: ✅ | راهنمایی فقط خواندنی: ✅ | راهنمایی جهان باز: ❌