MCP Tools Reference: paydeveloper.googleapis.com

כלי: update_merchant

עדכון של שדות ספציפיים של מוֹכר קיים. השדות הנתמכים כוללים את display_name,‏ mcc,‏ corporate_website_url,‏ customer_support_website_url,‏ customer_support_email ו-customer_support_phone.

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

סכימת הקלט

הודעת בקשה ל-UpdateMerchant.

UpdateMerchantFacadeRequest

ייצוג JSON 
{
  "merchantId": string,

  // Union field _display_name can be only one of the following:
  "displayName": string
  // End of list of possible types for union field _display_name.

  // Union field _mcc can be only one of the following:
  "mcc": enum (Mcc)
  // End of list of possible types for union field _mcc.

  // Union field _corporate_website_url can be only one of the following:
  "corporateWebsiteUrl": string
  // End of list of possible types for union field _corporate_website_url.

  // Union field _customer_support_website_url can be only one of the following:
  "customerSupportWebsiteUrl": string
  // End of list of possible types for union field _customer_support_website_url.

  // Union field _customer_support_email can be only one of the following:
  "customerSupportEmail": string
  // End of list of possible types for union field _customer_support_email.

  // Union field _customer_support_phone can be only one of the following:
  "customerSupportPhone": string
  // End of list of possible types for union field _customer_support_phone.
}
שדות
merchantId

string

חובה. מספר חשבון Merchant של המוכר שרוצים לעדכן.

שדה איחוד _display_name.

הערך _display_name יכול להיות רק אחד מהבאים:
displayName

string

השם המוצג של המוכר.

שדה איחוד _mcc.

הערך _mcc יכול להיות רק אחד מהבאים:
mcc

enum (Mcc)

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

שדה איחוד _corporate_website_url.

הערך _corporate_website_url יכול להיות רק אחד מהבאים:
corporateWebsiteUrl

string

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

שדה איחוד _customer_support_website_url.

הערך _customer_support_website_url יכול להיות רק אחד מהבאים:
customerSupportWebsiteUrl

string

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

שדה איחוד _customer_support_email.

הערך _customer_support_email יכול להיות רק אחד מהבאים:
customerSupportEmail

string

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

שדה איחוד _customer_support_phone.

הערך _customer_support_phone יכול להיות רק אחד מהבאים:
customerSupportPhone

string

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

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 הגרלות לוטו בבעלות הממשלה (אזורים מחוץ לארה"ב)

סכימת הפלט

הודעת התשובה ל-UpdateMerchant.

UpdateMerchantResponse

ייצוג JSON 
{
  "state": enum (State)
}
שדות
state

enum (State)

המצב של המוֹכר המעודכן.

מדינה (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, הכלי יכול ליצור אינטראקציה רק עם ישויות פנימיות. לדוגמה, כלי לחיפוש באינטרנט יהיה עולם פתוח, אבל כלי לזיכרון לא יהיה עולם פתוח.

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