MCP Tools Reference: paydeveloper.googleapis.com

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

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

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ set_principal_role ของ MCP

Curl Request 
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": "set_principal_role",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

สคีมาอินพุต

ข้อความคำขอสำหรับเพิ่มหรืออัปเดตผู้ใช้หลักในบัญชีผู้ขาย

SetPrincipalRoleRequest

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

string

ต้องระบุ รหัสผู้ขายที่จะเพิ่มหรืออัปเดตผู้ใช้หลัก
email

string

ต้องระบุ อีเมลของผู้ใช้หลักที่จะเพิ่มหรืออัปเดต
role

enum (PrincipalRole)

ต้องระบุ บทบาทที่จะมอบให้กับผู้ใช้หลัก

PrincipalRole

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

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

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

ข้อความตอบกลับสำหรับการเพิ่มหรืออัปเดตผู้ใช้หลักในบัญชีผู้ขาย

SetPrincipalRoleResponse

การแสดง JSON 
{
  "state": enum (State)
}
ช่อง
state

enum (State)

สถานะของผู้ใช้หลักหลังจากเพิ่มหรืออัปเดต

State

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

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

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

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

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

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

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