MCP Tools Reference: paydeveloper.googleapis.com

Công cụ: set_principal_role

Đặt vai trò của một người đại diện (người dùng) trên một người bán hoặc thêm một người đại diện mới có vai trò được chỉ định. Bên uỷ quyền sẽ nhận được một lời mời qua email và phải chấp nhận lời mời đó thì quyền truy cập của họ mới có hiệu lực. Thao tác này yêu cầu người bán có quyền truy cập của Quản trị viên.

Mã mẫu sau đây cho biết cách sử dụng curl để gọi công cụ set_principal_role MCP.

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

Giản đồ đầu vào

Thông báo yêu cầu thêm hoặc cập nhật một người đại diện trên người bán.

SetPrincipalRoleRequest

Biểu diễn dưới dạng JSON 
{
  "merchantId": string,
  "email": string,
  "role": enum (PrincipalRole)
}
Trường
merchantId

string

Bắt buộc. Mã người bán để thêm hoặc cập nhật người đại diện.
email

string

Bắt buộc. Địa chỉ email của người dùng chính cần thêm hoặc cập nhật.
role

enum (PrincipalRole)

Bắt buộc. Vai trò cần cấp cho người dùng.

PrincipalRole

Một vai trò có thể được cấp cho một pháp nhân (người dùng) trên một người bán.

Enum
PRINCIPAL_ROLE_UNSPECIFIED Vai trò không được chỉ định.
ADMIN Có toàn quyền truy cập vào người bán, bao gồm cả quyền quản lý người dùng.
DEVELOPER Quyền truy cập dành cho những nhà phát triển tích hợp với người bán.

Giản đồ đầu ra

Thông báo phản hồi khi thêm hoặc cập nhật một người đại diện trên người bán.

SetPrincipalRoleResponse

Biểu diễn dưới dạng JSON 
{
  "state": enum (State)
}
Trường
state

enum (State)

Trạng thái của người dùng chính sau khi thêm hoặc cập nhật.

Tiểu bang

Trạng thái quyền truy cập của một pháp nhân trên một người bán.

Enum
STATE_UNSPECIFIED Trạng thái truy cập chưa được chỉ định.
ACTIVE Chủ thể có quyền truy cập đang hoạt động và đã được chấp nhận.
PENDING Người đại diện đã được mời nhưng chưa chấp nhận lời mời.
EXPIRED Lời mời của người dùng chính đã hết hạn.

Chú giải công cụ

Chú thích công cụ được gửi đến các ứng dụng MCP để mô tả rủi ro cơ bản của một công cụ nhất định. Hầu hết các ứng dụng đều coi những gợi ý này là không đáng tin cậy, nhưng bạn có thể dùng chúng để quyết định thời điểm gửi lời nhắc xác nhận cho người dùng.

Cùng với chuỗi tiêu đề, các gợi ý boolean sau đây được xác định như sau:

  • readOnlyHint: Nếu đúng, công cụ sẽ không sửa đổi môi trường của công cụ. Mặc định: false.
  • destructiveHint: Nếu đúng, công cụ có thể thực hiện các hành động phá huỷ. Nếu là false, thì công cụ chỉ có thể thực hiện các thao tác bổ sung. Mặc định: true.
  • idempotentHint: Nếu đúng, thì việc gọi công cụ nhiều lần với cùng một đối số sẽ không có thêm tác động nào đến môi trường của công cụ. Mặc định: false.
  • openWorldHint: Nếu đúng, công cụ này có thể tương tác với "thế giới mở" của các thực thể bên ngoài. Nếu là false, thì công cụ chỉ có thể tương tác với các thực thể nội bộ. Ví dụ: một công cụ tìm kiếm trên web sẽ là thế giới mở, trong khi một công cụ bộ nhớ sẽ không phải là thế giới mở.

Gợi ý mang tính huỷ diệt: ✅ | Gợi ý mang tính luỹ đẳng: ❌ | Gợi ý chỉ đọc: ❌ | Gợi ý về thế giới mở: ❌