MCP Tools Reference: drivemcp.googleapis.com

도구: copy_file

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

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

curl 요청 
curl --location 'https://drivemcp.googleapis.com/mcp/v1' \
--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

새로 생성된 파일의 제목입니다. 비어 있으면 제목은 '[원본 파일 제목]의 사본'이 됩니다.

통합 필드 _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(포함) 사이여야 합니다.

도구 주석

파괴적 힌트: ❌ | 동일한 힌트: ❌ | 읽기 전용 힌트: ❌ | 오픈 월드 힌트: ✅