MCP Tools Reference: paydeveloper.googleapis.com

도구: set_principal_role

판매자의 주 구성원 (사용자)의 역할을 설정하거나 지정된 역할로 새 주 구성원을 추가합니다. 주 구성원에게 이메일 초대가 전송되며 액세스 권한이 활성화되기 전에 초대를 수락해야 합니다. 이 작업을 수행하려면 판매자에 대한 관리자 액세스 권한이 필요합니다.

다음 코드 샘플은 curl을 사용하여 set_principal_role 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": "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

필수 항목입니다. 주 구성원을 추가하거나 업데이트할 판매자 ID입니다.
email

string

필수 항목입니다. 추가하거나 업데이트할 주 구성원의 이메일 주소입니다.
role

enum (PrincipalRole)

필수 항목입니다. 주 구성원에게 부여할 역할입니다.

PrincipalRole

판매자의 주 구성원 (사용자)에게 부여할 수 있는 역할입니다.

열거형
PRINCIPAL_ROLE_UNSPECIFIED 역할이 지정되지 않았습니다.
ADMIN 사용자 관리를 포함한 판매자에 대한 전체 액세스 권한입니다.
DEVELOPER 판매자와 통합하는 개발자를 위한 액세스 권한입니다.

출력 스키마

판매자의 주 구성원을 추가하거나 업데이트하는 응답 메시지입니다.

SetPrincipalRoleResponse

JSON 표현 
{
  "state": enum (State)
}
필드
state

enum (State)

추가 또는 업데이트 후 주 구성원의 상태입니다.

주

판매자의 주 구성원 액세스 상태입니다.

열거형
STATE_UNSPECIFIED 액세스 상태가 지정되지 않았습니다.
ACTIVE 주 구성원에게 활성 상태의 수락된 액세스 권한이 있습니다.
PENDING 주 구성원이 초대되었지만 아직 초대를 수락하지 않았습니다.
EXPIRED 주 구성원의 초대가 만료되었습니다.

도구 주석

도구 주석은 지정된 도구의 기본 위험을 설명하기 위해 MCP 클라이언트로 전송됩니다. 대부분의 클라이언트는 이러한 힌트를 신뢰할 수 없는 것으로 취급하지만 확인 메시지를 사용자에게 전송할 시점을 결정하는 데 사용할 수 있습니다.

제목 문자열과 함께 다음 불리언 힌트가 다음과 같이 정의됩니다.

  • readOnlyHint: true인 경우 도구가 환경을 수정하지 않습니다. 기본값: false.
  • destructiveHint: true인 경우 도구가 파괴적인 작업을 실행할 수 있습니다. false인 경우 도구는 추가 작업만 실행할 수 있습니다. 기본값: true.
  • idempotentHint: true인 경우 동일한 인수로 도구를 반복적으로 호출해도 환경에 추가적인 영향을 미치지 않습니다. 기본값: false.
  • openWorldHint: true인 경우 도구가 외부 항목의 '오픈 월드'와 상호작용할 수 있습니다. false인 경우 도구는 내부 항목과만 상호작용할 수 있습니다. 예를 들어 웹 검색 도구는 오픈 월드이지만 메모리 도구는 오픈 월드가 아닙니다.

파괴적 힌트: ✅ | 멱등성 힌트: ❌ | 읽기 전용 힌트: ❌ | 오픈 월드 힌트: ❌