MCP Tools Reference: drivemcp.googleapis.com

도구: copy_file

이 도구를 호출하여 Google Drive에서 기존 파일을 복사합니다. 이 도구를 사용하면 사본의 새 제목과 상위 폴더를 지정할 수 있습니다. 제목이 지정되지 않으면 사본 제목은 'Copy of {original title}'이 됩니다. 상위 폴더가 지정되지 않으면 요청하는 사용자에게 해당 폴더에 대한 쓰기 액세스 권한이 없는 경우를 제외하고 사본이 원본 파일과 동일한 폴더에 생성됩니다. 이 경우 사본은 사용자의 루트 폴더에 생성됩니다. 복사가 완료되면 새로 생성된 파일 객체를 반환합니다.

다음 샘플에서는 curl을 사용하여 copy_file 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": "copy_file",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

파일을 복사하는 요청입니다.

CopyFileRequest

JSON 표현 
{
  "fileId": string,

  "title": string

  "parentId": string
}
필드
fileId

string

필수 항목입니다. 복사할 파일의 ID입니다.

통합 필드 _title.

_title는 다음 중 하나여야 합니다.
title

string

새로 생성된 파일의 제목입니다. 비어 있으면 제목은 'Copy of [original file title]'이 됩니다.

통합 필드 _parent_id.

_parent_id는 다음 중 하나여야 합니다.
parentId

string

새로 생성된 파일의 상위 ID입니다. 비어 있으면 파일이 원본 파일과 동일한 상위 항목으로 생성됩니다.

출력 스키마

파일 리소스입니다.

파일

JSON 표현 
{
  "id": string,
  "title": string,
  "parentId": string,

  "mimeType": string

  "fileSize": string

  "description": string

  "fileExtension": string

  "contentSnippet": string

  "viewUrl": string

  "sharedWithMeTime": string

  "createdTime": string

  "modifiedTime": string

  "viewedByMeTime": string

  "owner": string

  "canAddChildren": boolean
}
필드
id

string

가져온 파일의 ID입니다.
title

string

파일의 제목입니다.
parentId

string

파일의 상위 ID (선택사항)입니다.

통합 필드 _mime_type.

_mime_type는 다음 중 하나여야 합니다.
mimeType

string

파일의 MIME 유형입니다.

통합 필드 _file_size.

_file_size는 다음 중 하나여야 합니다.
fileSize

string (int64 format)

파일의 크기(바이트)입니다.

통합 필드 _description.

_description는 다음 중 하나여야 합니다.
description

string

파일에 대한 설명입니다.

통합 필드 _file_extension.

_file_extension는 다음 중 하나여야 합니다.
fileExtension

string

파일의 원래 파일 확장자입니다. Drive에 저장된 콘텐츠가 있는 파일에만 채워집니다.

통합 필드 _content_snippet.

_content_snippet는 다음 중 하나여야 합니다.
contentSnippet

string

파일 콘텐츠에 관해 생성된 스니펫입니다.

통합 필드 _view_url.

_view_url는 다음 중 하나여야 합니다.
viewUrl

string

파일을 볼 수 있는 URL입니다.

통합 필드 _shared_with_me_time.

_shared_with_me_time는 다음 중 하나여야 합니다.
sharedWithMeTime

string (Timestamp format)

파일이 요청자와 공유된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

통합 필드 _created_time.

_created_time는 다음 중 하나여야 합니다.
createdTime

string (Timestamp format)

파일이 생성된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

통합 필드 _modified_time.

_modified_time는 다음 중 하나여야 합니다.
modifiedTime

string (Timestamp format)

파일이 수정된 가장 최근 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

통합 필드 _viewed_by_me_time.

_viewed_by_me_time는 다음 중 하나여야 합니다.
viewedByMeTime

string (Timestamp format)

요청자가 파일을 본 가장 최근 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

통합 필드 _owner.

_owner는 다음 중 하나여야 합니다.
owner

string

파일 소유자의 이메일 주소입니다.

통합 필드 _can_add_children.

_can_add_children는 다음 중 하나여야 합니다.
canAddChildren

boolean

요청자가 이 폴더에 하위 항목을 추가할 수 있는지 여부입니다. 폴더가 아닌 유형의 경우 항상 false입니다.

타임스탬프

JSON 표현 
{
  "seconds": string,
  "nanos": integer
}
필드
seconds

string (int64 format)

Unix epoch 1970-01-01T00:00:00Z 이후 UTC 시간의 초 단위로 표현합니다. 범위는 -62135596800~253402300799(포함)여야 합니다(0001-01-01T00:00:00Z~9999-12-31T23:59:59Z에 해당).
nanos

integer

나노초 단위의 음수가 아닌 초수입니다. 이 필드는 초의 대안이 아니라 기간의 나노초 부분입니다. 음수의 초수 값에는 시간에 반영되는 음수가 아닌 나노초 값이 있어야 합니다. 범위는 0~999,999,999(포함)여야 합니다.

도구 주석

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

승인 범위

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file