MCP Tools Reference: paydeveloper.googleapis.com

כלי: list_merchants

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

בדוגמת הקוד הבאה מוצג שימוש בפקודה curl כדי להפעיל את הכלי list_merchants 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_merchants",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

בקשת הודעה למוֹכרים בכרטיסי מוצר.

ListMerchantsRequest

ייצוג JSON 
{
  "view": enum (MerchantView)
}
שדות
view

enum (MerchantView)

אופציונלי. מציינת את רמת הפירוט שתוחזר לכל מוֹכר.

MerchantView

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

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

סכימת הפלט

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

ListMerchantsResponse

ייצוג JSON 
{
  "merchants": [
    {
      object (Merchant)
    }
  ]
}
שדות
merchants[]

object (Merchant)

המוֹכרים שלמשתמש יש גישה אליהם.

מוֹכר

ייצוג JSON 
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
שדות
merchantId

string

פלט בלבד. המזהה הייחודי של המוכר.
displayName

string

חובה. השם המוצג של המוכר.
regionCode

string

חובה. קוד האזור של מיקום העסק של המוכר. הפורמט הוא קודי האזורים במאגר CLDR של Unicode, למשל US. אין תמיכה בהודו (IN).
mcc

enum (Mcc)

חובה. קוד הקטגוריה של המוֹכר (MCC).
corporateWebsiteUrl

string

חובה. האתר של התאגיד של המוֹכר.
customerSupportWebsiteUrl

string

חובה. אתר תמיכת הלקוחות של המוכר.
customerSupportEmail

string

חובה. כתובת האימייל של המוקד לתמיכת לקוחות של המוכר.
customerSupportPhone

string

חובה. מספר הטלפון של תמיכת הלקוחות של המוֹכר.
state

enum (State)

פלט בלבד. המצב של המוֹכר.

Mcc

קוד קטגוריית המוֹכר (MCC) של מוֹכר.

טיפוסים בני מנייה (enum)
OTHERS אחרים
MISC_FOOD_STORES חנויות מזון שונות – חנויות נוחות ושוקי מזון מיוחדים
MISC_APPAREL חנויות שונות לביגוד ולאביזרים
ARTISTS_SUPPLY חנויות לציוד אומנות ולמלאכת יד
AUTOMOTIVE_PARTS חנויות לחלקי חילוף ואביזרים לרכב
HEALTH_AND_BEAUTY חנות למוצרי בריאות ויופי
BOOKS_PERIODICALS ספרים, כתבי עת ועיתונים
CAMERA_STORES חנויות לציוד צילום ומצלמות
COMPUTERS_EQUIPMENT מחשבים, ציוד היקפי למחשב, תוכנה
COMPUTER_SOFTWARE חנויות לתוכנות מחשב
ELECTRONICS_SALES מכירות של מוצרי אלקטרוניקה
GIFT_SHOPS Card Shops, Gift, Novelty, and Souvenir Shops
EATING_PLACES מסעדות ומקומות לאכול
MISC_GENERAL_MERCHANDISE מוצרים כלליים שונים
HOME_SUPPLY חנויות מחסן לציוד לבית
COMPUTER_NETWORK_SERVICES שירותי רשת מחשבים
DIGITAL_GOODS_MEDIA מוצרים דיגיטליים: ספרים, סרטים, מוזיקה
DIGITAL_GOODS_GAMES מוצרים דיגיטליים: משחקים
DIGITAL_GOODS_APPLICATIONS מוצרים דיגיטליים: אפליקציות (לא כולל משחקים)
POLITICAL_ORGANIZATIONS ארגונים פוליטיים
CHARITABLE_ORGANIZATIONS ארגוני צדקה ושירותים חברתיים
DRUG_STORES בתי מרקחת
REAL_ESTATE_RENTALS סוכני נדל"ן ומנהלים – השכרות
MISC_PERSONAL_SERVICES שירותים אישיים שונים, לא מסווגים במקום אחר
SPORTING_GOODS חנויות למוצרי ספורט
STATIONERY_OFFICE_SUPPLIES ציוד משרדי, נייר למכתבים, נייר להדפסה וכתיבה
THEATRICAL_TICKET_AGENCIES סוכנויות כרטיסים לתיאטרון
TIMESHARES בעלות תקופתית
TOURIST_ATTRACTIONS אטרקציות לתיירים ותערוכות
HOBBY_TOY_GAME_SHOPS חנויות של תחביבים, צעצועים ומשחקים
PET_SHOPS חנויות לחיות מחמד, חנויות למזון וציוד לחיות מחמד
OTHER_LODGING מקומות לינה אחרים – בתי מלון, מוטלים, אתרי נופש
TELECOMMUNICATION_SERVICES שירותי טלקומוניקציה
TRANSPORTATION_SERVICES שירותי תחבורה
OTHER_AIRLINES חברות תעופה אחרות
TRAVEL_AGENCIES סוכנויות נסיעות ומפעילי סיורים
GOVERNMENT_OWNED_LOTTERIES_US הגרלות לוטו בבעלות הממשלה (באזור ארה"ב בלבד)
GOVERNMENT_LICENSED_CASINOS_US בתי קזינו אונליין עם רישיון ממשלתי (הימורים אונליין) (באזור ארה"ב בלבד)
BETTING הימורים (כולל כרטיסי לוטו, צ'יפים למשחקי קזינו, הימורים מחוץ למסלול המרוצים והימורים)
GOVERNMENT_OWNED_LOTTERIES_NON_US הגרלות לוטו בבעלות הממשלה (אזורים מחוץ לארה"ב)

מדינה (State)

הסטטוס של מוֹכר.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED לא צוין סטטוס המוכר.
VERIFIED המוכר מאומת ומאושר.
IN_REVIEW העריכה של פרופיל המוכר נמצאת בבדיקה.
REJECTED העריכה של פרופיל המוֹכר נדחית.
INCOMPLETE_SIGNUP פרופיל המוכר לא הושלם.
SANCTIONS_HIT פרופיל המוכר מושפע מסנקציות.
READY_FOR_REVIEW פרופיל המוֹכר הושלם ומוכן לבדיקה.
DISABLED פרופיל המוכר מושבת או לא פעיל.

הערות על כלים

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

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

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

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