MCP Tools Reference: paydeveloper.googleapis.com

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

แสดงรายการผู้ใช้หลัก (ผู้ใช้) ที่มีสิทธิ์เข้าถึงผู้ขายที่เฉพาะเจาะจง การดำเนินการนี้ต้องมีสิทธิ์เข้าถึงระดับผู้ดูแลระบบสำหรับผู้ขาย

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกเครื่องมือ list_principals 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_principals",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

สคีมาอินพุต

ข้อความคำขอสำหรับแสดงรายการผู้ใช้หลักของผู้ขาย

ListPrincipalsRequest

การแสดง JSON 
{
  "merchantId": string
}
ช่อง
merchantId

string

ต้องระบุ รหัสผู้ขายที่จะแสดงรายการผู้ใช้หลัก

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

ข้อความตอบกลับสำหรับแสดงรายการผู้ใช้หลักของผู้ขาย

ListPrincipalsResponse

การแสดง JSON 
{
  "principals": [
    {
      object (Principal)
    }
  ]
}
ช่อง
principals[]

object (Principal)

ผู้ใช้หลักที่มีสิทธิ์เข้าถึงผู้ขาย

ผู้ใช้หลัก

การแสดง JSON 
{
  "email": string,
  "displayName": string,
  "role": enum (PrincipalRole),
  "state": enum (State)
}
ช่อง
email

string

ต้องระบุ อีเมลของผู้ใช้หลัก
displayName

string

เอาต์พุตเท่านั้น ชื่อที่แสดงของผู้ใช้หลัก
role

enum (PrincipalRole)

บทบาทของผู้ใช้หลักในผู้ขาย
state

enum (State)

เอาต์พุตเท่านั้น สถานะการเข้าถึงของผู้ใช้หลักในผู้ขาย

PrincipalRole

บทบาทที่มอบให้ผู้ใช้หลัก (ผู้ใช้) ในผู้ขายได้

Enum
PRINCIPAL_ROLE_UNSPECIFIED ไม่ได้ระบุบทบาท
ADMIN สิทธิ์เข้าถึงผู้ขายโดยสมบูรณ์ รวมถึงการจัดการผู้ใช้
DEVELOPER สิทธิ์เข้าถึงที่ออกแบบมาสำหรับนักพัฒนาแอปที่ผสานรวมกับผู้ขาย

สถานะ

สถานะการเข้าถึงของผู้ใช้หลักในผู้ขาย

Enum
STATE_UNSPECIFIED ไม่ได้ระบุสถานะการเข้าถึง
ACTIVE ผู้ใช้หลักมีสิทธิ์เข้าถึงที่ใช้งานอยู่และได้รับการยอมรับ
PENDING ผู้ใช้หลักได้รับคำเชิญแต่ยังไม่ได้ยอมรับคำเชิญ
EXPIRED คำเชิญของผู้ใช้หลักหมดอายุแล้ว

คำอธิบายประกอบของเครื่องมือ

ระบบจะส่งคำอธิบายประกอบของเครื่องมือไปยังไคลเอ็นต์ MCP เพื่ออธิบายความเสี่ยงพื้นฐานของเครื่องมือที่ระบุ ไคลเอ็นต์ส่วนใหญ่จะถือว่าคำแนะนำเหล่านี้ไม่น่าเชื่อถือ แต่คุณสามารถใช้คำแนะนำเหล่านี้เพื่อตัดสินใจว่าจะส่งข้อความแจ้งให้ยืนยันไปยังผู้ใช้เมื่อใด

นอกจากสตริงชื่อแล้ว ระบบยังกำหนดคำแนะนำแบบบูลีนต่อไปนี้ดังนี้

  • readOnlyHint: หากเป็นจริง แสดงว่าเครื่องมือจะไม่แก้ไขสภาพแวดล้อม ค่าเริ่มต้น: เท็จ
  • destructiveHint: หากเป็นจริง แสดงว่าเครื่องมือสามารถดำเนินการที่ทำให้เกิดความเสียหายได้ หากเป็นเท็จ แสดงว่าเครื่องมือสามารถดำเนินการเพิ่มเติมได้เท่านั้น ค่าเริ่มต้น: จริง
  • idempotentHint: หากเป็นจริง แสดงว่าการเรียกเครื่องมือซ้ำๆ ด้วยอาร์กิวเมนต์เดียวกันจะไม่มีผลเพิ่มเติมต่อสภาพแวดล้อม ค่าเริ่มต้น: เท็จ
  • openWorldHint: หากเป็นจริง แสดงว่าเครื่องมือสามารถโต้ตอบกับ "โอเพนเวิลด์" ของเอนทิตีภายนอกได้ หากเป็นเท็จ แสดงว่าเครื่องมือสามารถโต้ตอบกับเอนทิตีภายในเท่านั้น ตัวอย่างเช่น เครื่องมือค้นหาเว็บจะเป็นโอเพนเวิลด์ แต่เครื่องมือหน่วยความจำจะไม่เป็นโอเพนเวิลด์

คำแนะนำที่ทำให้เกิดความเสียหาย: ❌ | คำแนะนำที่ทำให้เกิดผลลัพธ์เหมือนเดิม: ✅ | คำแนะนำแบบอ่านอย่างเดียว: ✅ | คำแนะนำแบบโลกเปิด: ❌