MCP Tools Reference: paydeveloper.googleapis.com

Công cụ: list_principals

Liệt kê các chủ thể (người dùng) có quyền truy cập vào một người bán cụ thể. 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ụ list_principals 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": "list_principals",
    "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 để liệt kê các bên chính của người bán.

ListPrincipalsRequest

Biểu diễn dưới dạng JSON 
{
  "merchantId": string
}
Trường
merchantId

string

Bắt buộc. Mã người bán mà bạn muốn liệt kê các pháp nhân.

Giản đồ đầu ra

Thông báo phản hồi để liệt kê các bên đại diện của người bán.

ListPrincipalsResponse

Biểu diễn dưới dạng JSON 
{
  "principals": [
    {
      object (Principal)
    }
  ]
}
Trường
principals[]

object (Principal)

Các pháp nhân có quyền truy cập vào người bán.

Tổng

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

string

Bắt buộc. Địa chỉ email của người đại diện.
displayName

string

Chỉ có đầu ra. Tên hiển thị của người dùng.
role

enum (PrincipalRole)

Vai trò của đối tượng chính đối với người bán.
state

enum (State)

Chỉ có đầu ra. Trạng thái truy cập của người dùng chính trên người bán.

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.

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 ý phá huỷ: ❌ | Gợi ý bất biến: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý thế giới mở: ❌