MCP Tools Reference: paydeveloper.googleapis.com

เครื่องมือ: list_google_pay_integrations

แสดงสถานะปัจจุบันและรายละเอียดการกำหนดค่าสำหรับการผสานรวม Google Pay ทั้งหมดที่เชื่อมโยงกับรหัสผู้ขายที่เฉพาะเจาะจง โดยจะให้ความคิดเห็นเกี่ยวกับสถานะของการผสานรวมและการตรวจสอบเอกสารได้ทันที นอกจากนี้ คุณต้องแจ้งให้ผู้ใช้ทราบว่าสามารถสร้าง/อัปเดตการผสานรวมได้ใน Google Pay และ Wallet Console (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

ต้องระบุ รหัสผู้ขายที่จะแสดงการผสานรวม

สคีมาเอาต์พุต

ข้อความตอบกลับสำหรับการแสดงรายการการผสานรวม 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
ฟิลด์ Union item รายการการผสานรวม ต้องตั้งค่าอย่างใดอย่างหนึ่งในสองอย่างนี้ item ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
webDomain

string

โดเมนเว็บของผู้ขาย
androidAppPackage

string

ชื่อแพ็กเกจแอป Android ของร้านค้า

การประทับเวลา

การแสดง JSON 
{
  "seconds": string,
  "nanos": integer
}
ช่อง
seconds

string (int64 format)

แสดงวินาทีของเวลา UTC ตั้งแต่ Epoch ของ Unix 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 Store) และนักพัฒนาแอปยังไม่ได้เริ่มกระบวนการผสานรวมใดๆ สำหรับแอป
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: หากเป็นจริง เครื่องมือจะไม่แก้ไขสภาพแวดล้อม ค่าเริ่มต้น: เท็จ
  • destructiveHint: หากเป็นจริง เครื่องมือจะดำเนินการที่ทำลายข้อมูลได้ หากเป็นเท็จ เครื่องมือจะดำเนินการได้เฉพาะการดำเนินการเพิ่มเติมเท่านั้น ค่าเริ่มต้น: จริง
  • idempotentHint: หากเป็นจริง การเรียกใช้เครื่องมือซ้ำๆ ด้วยอาร์กิวเมนต์เดียวกันจะไม่ส่งผลกระทบเพิ่มเติมต่อสภาพแวดล้อมของเครื่องมือ ค่าเริ่มต้น: เท็จ
  • openWorldHint: หากเป็นจริง เครื่องมือจะโต้ตอบกับ "โอเพนเวิลด์" ของเอนทิตีภายนอกได้ หากเป็นเท็จ เครื่องมือจะโต้ตอบกับเอนทิตีภายในเท่านั้น ตัวอย่างเช่น เครื่องมือค้นหาเว็บจะเป็นแบบโอเพนเวิลด์ แต่เครื่องมือความทรงจำจะไม่ใช่แบบโอเพนเวิลด์

คำใบ้ที่ทำลาย: ❌ | คำใบ้ที่ทำซ้ำได้: ✅ | คำใบ้แบบอ่านอย่างเดียว: ✅ | คำใบ้แบบโลกเปิด: ❌