MCP Tools Reference: drivemcp.googleapis.com

Инструмент: copy_file

Вызовите этот инструмент, чтобы скопировать существующий файл на Google Диске. Инструмент позволяет указать новое название и родительскую папку для копии. Если название не указано, копия будет называться "Копия {исходное название}". Если родительская папка не указана, копия будет создана в той же папке, что и исходный файл, за исключением случаев, когда у запрашивающего пользователя нет прав на запись в эту папку. В этом случае копия будет создана в корневой папке пользователя. Возвращает вновь созданный объект File после успешного копирования.

В примере ниже показано, как использовать curl для вызова инструмента MCP copy_file.

Запрос 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

Обязательно. Идентификатор файла, который нужно скопировать.

Объединенное поле _title.

Поле _title может иметь одно из следующих значений:

title

string

Название нового файла. Если оставить поле пустым, название будет выглядеть так: "Копия [название исходного файла]".

Объединенное поле _parent_id.

Поле _parent_id может иметь одно из следующих значений:

parentId

string

Идентификатор родительской папки для созданного файла. Если поле не заполнено, файл будет создан в той же родительской папке, что и исходный файл.

Схема вывода

Ресурс файла.

Файл

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

Идентификатор полученного файла.

title

string

Название файла.

parentId

string

Идентификатор родительского объекта файла (необязательно).

Объединенное поле _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

Исходное расширение имени файла. Заполняется только для файлов с контентом, хранящимся на Диске.

Объединенное поле _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)

Время, когда отправителю запроса был предоставлен доступ к файлу.

Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: "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)

Время создания файла.

Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: "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)

Время последнего изменения файла.

Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: "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)

Время, когда отправитель запроса в последний раз просматривал файл.

Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: "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)

Представляет секунды времени UTC с начала эпохи Unix (1970-01-01T00:00:00Z). Значение должно быть в диапазоне от -62135596800 до 253402300799 включительно (что соответствует периоду с 0001-01-01T00:00:00Z до 9999-12-31T23:59:59Z).

nanos

integer

Доля секунды в наносекундах. Это поле содержит наносекундную часть длительности, а не альтернативу секундам. Свойство может принимать только неотрицательное целочисленное значение, даже если значение временной отметки в секундах является отрицательным. Значение должно быть в диапазоне от 0 до 999 999 999 включительно.

Аннотации инструментов

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ✅

Области авторизации

Требует одной из следующих областей применения OAuth:

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