MCP Tools Reference: drivemcp.googleapis.com

도구: get_file_permissions

이 도구를 호출하여 드라이브 파일의 권한을 나열합니다.

다음 샘플에서는 curl을 사용하여 get_file_permissions MCP 도구를 호출하는 방법을 보여줍니다.

curl 요청 
curl --location 'https://drivemcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_file_permissions",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

파일 권한을 가져오는 요청입니다.

GetFilePermissionsRequest

JSON 표현 
{
  "fileId": string
}
필드
fileId

string

필수 항목입니다. 권한을 가져올 파일의 ID입니다.

출력 스키마

파일 권한을 가져오는 응답입니다.

GetFilePermissionsResponse

JSON 표현 
{
  "permissions": [
    {
      object (Permission)
    }
  ]
}
필드
permissions[]

object (Permission)

권한 목록입니다.

권한

JSON 표현 
{

  "role": string

  "displayName": string

  "type": string

  "emailAddress": string

  "view": string
}
필드

통합 필드 _role.

_role은 다음 중 하나여야 합니다.
role

string

파일에 대한 권한 부여 대상의 역할입니다. 가능한 역할은 다음과 같습니다. * owner * organizer * fileOrganizer * writer * commenter * reader

통합 필드 _display_name.

_display_name는 다음 중 하나여야 합니다.
displayName

string

출력 전용입니다. 권한 값의 '예쁜' 이름입니다. 다음은 각 권한 유형의 예시 목록입니다. * user - Google 계정에 정의된 사용자의 전체 이름(예: '김민경') * group - Google 그룹의 이름(예: '회사 관리자') * domain - 문자열 도메인 이름(예: 'cymbalgroup.com') * anyone - displayName이 없습니다.

통합 필드 _type.

_type은 다음 중 하나여야 합니다.
type

string

권한 부여 대상의 유형입니다. 지원되는 값은 다음과 같습니다. * user * group * domain * anyone

통합 필드 _email_address.

_email_address은 다음 중 하나여야 합니다.
emailAddress

string

이 권한이 참조하는 사용자 또는 그룹의 이메일 주소입니다.

통합 필드 _view.

_view은 다음 중 하나여야 합니다.
view

string

이 권한이 적용되는 뷰를 지정합니다(있는 경우). 지원되는 값은 다음과 같습니다. * published * metadata

도구 주석

파괴적 힌트: ❌ | 멱등성 힌트: ✅ | 읽기 전용 힌트: ✅ | 개방형 세계 힌트: ❌

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly