MCP Tools Reference: paydeveloper.googleapis.com

כלי: list_google_pay_integrations

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

בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP‏ list_google_pay_integrations.

בקשת 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 tool's MCP 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 של המוכר באפליקציית Android.

חותמת זמן

ייצוג ב-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 בדומיין אינטרנט של מוכר או באפליקציית Android.

טיפוסים בני מנייה (enum)
INTEGRATION_STATE_UNSPECIFIED לא צוין סטטוס השילוב.
NOT_STARTED הסטטוס הזה מציין שהאפליקציה ל-Android משויכת למפתח (ב-חנות 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.

הערות על כלים

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