MCP Tools Reference: paydeveloper.googleapis.com

כלי: list_google_pay_integrations

הפונקציה מחזירה את הסטטוס הנוכחי ואת פרטי ההגדרה של כל השילובים של Google Pay שמשויכים למזהה סוחר ספציפי. הוא מספק משוב מיידי על סטטוס השילוב ועל ביקורות המסמכים. בנוסף, עליך להודיע למשתמש שאפשר ליצור או לעדכן את השילוב במסוף Google Pay ו-Wallet (https://pay.google.com/business/console/).

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

סכימת הקלט

בקשת הודעה לרישום אינטגרציות של Google Pay עבור סוחר ספציפי.

ListGooglePayIntegrationsRequest

ייצוג JSON 
{
  "merchantId": string
}
שדות
merchantId

string

חובה. מספר חשבון Merchant שעבורו רוצים להציג את השילובים.

סכימת הפלט

הודעת תגובה לרישום שילובים של Google Pay.

ListGooglePayIntegrationsResponse

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

object (GooglePayIntegration)

השילובים של Google Pay של המוכר.

GooglePayIntegration

ייצוג JSON 
{
  "integrationState": enum (IntegrationState),
  "createTime": string,
  "updateTime": string,
  "integrationType": enum (IntegrationType),
  "integrationDocuments": [
    {
      object (IntegrationDocument)
    }
  ],

  // Union field item can be only one of the following:
  "webDomain": string,
  "androidAppPackage": string
  // End of list of possible types for union field item.
}
שדות
integrationState

enum (IntegrationState)

פלט בלבד. מצב השילוב של המוכר עם Google Pay.
createTime

string (Timestamp format)

פלט בלבד. מתי נוצר משאב השילוב.

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

פלט בלבד. מתי עודכן לאחרונה משאב האינטגרציה.

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
integrationType

enum (IntegrationType)

חובה. סוג השילוב של Google Pay.
integrationDocuments[]

object (IntegrationDocument)

חובה. קלט בלבד. מסמכי השילוב של Google Pay.
שדה איחוד item. פריט השילוב. חובה להגדיר אחד מהם. הערך item יכול להיות רק אחד מהבאים:
webDomain

string

הדומיין של המוכר.
androidAppPackage

string

שם חבילת ה-APK של הסוחר.

חותמת זמן

ייצוג JSON 
{
  "seconds": string,
  "nanos": integer
}
שדות
seconds

string (int64 format)

מייצג את השניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch) ‏1970-01-01T00:00:00Z. הערך חייב להיות בין ‎-62135596800 ל-‎253402300799, כולל (שמתאים לטווח 0001-01-01T00:00:00Z עד 9999-12-31T23:59:59Z).
nanos

integer

שבריר לא שלילי של שנייה ברזולוציית ננו-שנייה. השדה הזה מייצג את החלק של משך הזמן בננו-שניות, ולא מהווה חלופה לשניות. ערכי שניות שליליים עם שברים עדיין צריכים לכלול ערכי ננו-שניות לא שליליים שסופרים קדימה בזמן. הערך חייב להיות בין 0 ל-999,999,999, כולל.

IntegrationDocument

ייצוג JSON 
{
  "name": string,
  "data": string,
  "documentType": enum (DocumentType),
  "mimeType": enum (MimeType)
}
שדות
name

string

חובה. שם המסמך.
data

string (bytes format)

חובה. נתוני המסמך.

מחרוזת בקידוד Base64.
documentType

enum (DocumentType)

חובה. סוג המסמך.
mimeType

enum (MimeType)

חובה. סוג ה-MIME של המסמך.

IntegrationState

מצב האינטגרציה של Google Pay של דומיין אינטרנט של סוחר או אפליקציית אנדרואיד.

טיפוסים בני מנייה (enum)
INTEGRATION_STATE_UNSPECIFIED לא צוין סטטוס השילוב.
NOT_STARTED מצב זה מתייחס למקרים בהם אפליקציית אנדרואיד משויכת למפתח (בחנות Play) והמפתח לא התחיל תהליך אינטגרציה עבורה.
INCOMPLETE המפתח עדיין לא שלח את השילוב לבדיקה, והוא גם לא הושלם (למשל, חסרים מסמכים תומכים).
READY_FOR_REVIEW המפתח עדיין לא שלח את השילוב לבדיקה, אבל הוא מוכן לבדיקה (לדוגמה, מסמכים תומכים הועלו).
UNDER_REVIEW הבקשה להפעלת השילוב ממתינה לבדיקה של האדמין.
NEED_INFO במהלך הבדיקה, אדמין ב-gTech צריך לספק מידע נוסף לגבי השילוב.
ACTIVE השילוב פעיל כרגע.
DELETED המוֹכר מחק את השילוב.
REJECTED האינטגרציה נדחית.

IntegrationType

סוג האינטגרציה של אינטגרציה עם Google Pay.

טיפוסים בני מנייה (enum)
INTEGRATION_TYPE_UNSPECIFIED סוג השילוב לא צוין.
DIRECT_INTEGRATION סוג האינטגרציה הוא אינטגרציה ישירה.
PAYMENT_SERVICE_PROVIDER סוג השילוב הוא ספק שירותי תשלום.

DocumentType

סוג המסמך.

טיפוסים בני מנייה (enum)
DOCUMENT_TYPE_UNSPECIFIED לא צוין סוג המסמך.
ITEM_SELECTION_SCREENSHOT כאשר משתמש גולש בפריט או שירות.
PRE_PURCHASE_SCREENSHOT כשמשתמש מוכן לבצע רכישה.
PAYMENT_METHOD_SCREENSHOT כשמשתמש בוחר ב-Google Pay כאמצעי התשלום.
PAYMENT_INFO_SCREENSHOT כשפרטי התשלום ששמורים ב-Google Pay מוצגים למשתמש. טיפ: מערכת Android לא מאפשרת לצלם את המסך הזה, לכן צריך לצלם את המסך באמצעות מכשיר אחר.
POST_PURCHASE_SCREENSHOT כשמשתמש מבצע רכישה בהצלחה.
PCI_ATTESTATION_DOCUMENT מסמך הצהרה לגבי PCI בפורמט PDF.

MimeType

סוג ה-MIME של המסמך.

טיפוסים בני מנייה (enum)
MIME_TYPE_UNSPECIFIED לא צוין סוג ה-MIME.
JPEG סוג ה-Mime הוא JPEG.
PNG סוג ה-MIME הוא PNG.
WEBP סוג ה-MIME הוא WEBP.
PDF סוג ה-MIME הוא PDF.

הערות על כלים

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

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

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

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