MCP Tools Reference: drivemcp.googleapis.com

Công cụ: copy_file

Hãy gọi công cụ này để sao chép một Tệp hiện có trong Google Drive. Công cụ này cho phép bạn chỉ định tiêu đề mới và thư mục mẹ cho bản sao. Nếu bạn không chỉ định tiêu đề, tiêu đề của bản sao sẽ là "Bản sao của {tiêu đề gốc}". Nếu bạn không chỉ định thư mục mẹ, bản sao sẽ được tạo trong cùng thư mục với tệp gốc, trừ phi người dùng yêu cầu không có quyền ghi vào thư mục đó. Trong trường hợp này, bản sao sẽ được tạo trong thư mục gốc của người dùng.Trả về đối tượng Tệp mới được tạo khi sao chép thành công.

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ copy_file MCP.

Yêu cầu 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
}'

Giản đồ đầu vào

Yêu cầu sao chép một tệp.

CopyFileRequest

Biểu diễn dưới dạng JSON 
{
  "fileId": string,

  "title": string

  "parentId": string
}
Trường
fileId

string

Bắt buộc. Mã của tệp cần sao chép.

Trường nhóm _title.

_title chỉ có thể là một trong những trường sau:
title

string

Tiêu đề của tệp mới được tạo. Nếu để trống, tiêu đề sẽ là "Bản sao của [tiêu đề tệp gốc]".

Trường nhóm _parent_id.

_parent_id chỉ có thể là một trong những trường sau:
parentId

string

Mã mẹ của tệp mới được tạo. Nếu để trống, tệp sẽ được tạo cùng với tệp mẹ như tệp gốc.

Giản đồ đầu ra

Tài nguyên tệp.

Tệp

Biểu diễn dưới dạng 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
}
Trường
id

string

Mã của tệp đã tìm nạp.
title

string

Tiêu đề của tệp.
parentId

string

Mã (không bắt buộc) của tệp mẹ.

Trường nhóm _mime_type.

_mime_type chỉ có thể là một trong những trường sau:
mimeType

string

Loại MIME của tệp.

Trường nhóm _file_size.

_file_size chỉ có thể là một trong những trường sau:
fileSize

string (int64 format)

Kích thước của tệp tính bằng byte.

Trường nhóm _description.

_description chỉ có thể là một trong những trường sau:
description

string

Nội dung mô tả của tệp.

Trường nhóm _file_extension.

_file_extension chỉ có thể là một trong những trường sau:
fileExtension

string

Tiện ích tệp gốc của tệp. Trường này chỉ được điền sẵn cho các tệp có nội dung được lưu trữ trong Drive.

Trường nhóm _content_snippet.

_content_snippet chỉ có thể là một trong những trường sau:
contentSnippet

string

Đoạn trích được tạo về nội dung của tệp.

Trường nhóm _view_url.

_view_url chỉ có thể là một trong những trường sau:
viewUrl

string

URL để xem tệp.

Trường nhóm _shared_with_me_time.

_shared_with_me_time chỉ có thể là một trong những trường sau:
sharedWithMeTime

string (Timestamp format)

Thời điểm tệp được chia sẻ với người yêu cầu.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

Trường nhóm _created_time.

_created_time chỉ có thể là một trong những trường sau:
createdTime

string (Timestamp format)

Thời điểm tệp được tạo.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

Trường nhóm _modified_time.

_modified_time chỉ có thể là một trong những trường sau:
modifiedTime

string (Timestamp format)

Thời điểm gần đây nhất mà tệp được sửa đổi.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

Trường nhóm _viewed_by_me_time.

_viewed_by_me_time chỉ có thể là một trong những trường sau:
viewedByMeTime

string (Timestamp format)

Thời điểm gần đây nhất mà người yêu cầu xem tệp.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

Trường nhóm _owner.

_owner chỉ có thể là một trong những trường sau:
owner

string

Địa chỉ email của chủ sở hữu tệp.

Trường nhóm _can_add_children.

_can_add_children chỉ có thể là một trong những trường sau:
canAddChildren

boolean

Người yêu cầu có thể thêm tệp con vào thư mục này hay không. Trường này luôn là false đối với các loại không phải thư mục.

Dấu thời gian

Biểu diễn dưới dạng JSON 
{
  "seconds": string,
  "nanos": integer
}
Trường
seconds

string (int64 format)

Biểu thị số giây của thời gian UTC kể từ thời điểm bắt đầu của hệ thống Unix 1970-01-01T00:00:00Z. Phải nằm trong khoảng từ -62135596800 đến 253402300799 (tương ứng với 0001-01-01T00:00:00Z đến 9999-12-31T23:59:59Z).
nanos

integer

Phân số không âm của một giây ở độ phân giải nano giây. Trường này là phần nano giây của khoảng thời gian, không phải là một lựa chọn thay thế cho giây. Các giá trị giây âm có phân số vẫn phải có giá trị nano giây không âm để đếm tiến theo thời gian. Phải nằm trong khoảng từ 0 đến 999.999.999.

Chú thích công cụ

Gợi ý về tính chất phá huỷ: ❌ | Gợi ý về tính chất luỹ đẳng: ❌ | Gợi ý về tính chất chỉ đọc: ❌ | Gợi ý về tính chất thế giới mở: ✅