MCP Tools Reference: drivemcp.googleapis.com

Công cụ: create_file

Gọi công cụ này để tạo hoặc tải một tệp lên Google Drive.

Nếu tải nội dung lên, hãy ưu tiên "text_content" cho nội dung dạng văn bản. Đối với nội dung không phải UTF8, hãy sử dụng trường "base64_content" và mã hoá base64 dữ liệu để đặt trên trường đó.

Trả về một đối tượng Tệp duy nhất khi tạo thành công.

Bạn có thể tạo các loại MIME sau đây của bên thứ nhất trên Google Drive mà không cần cung cấp nội dung:

  • application/vnd.google-apps.document
  • application/vnd.google-apps.spreadsheet
  • application/vnd.google-apps.presentation

Theo mặc định, các lượt chuyển đổi sau đây sẽ được thực hiện cho các loại MIME sau đây:

  • text/plain đến application/vnd.google-apps.document
  • text/csv đến application/vnd.google-apps.spreadsheet

Để tắt lượt chuyển đổi cho các loại mime của bên thứ nhất, hãy đặt disable_conversion_to_google_type thành true.

Bạn có thể tạo thư mục bằng cách đặt loại MIME thành application/vnd.google-apps.folder.

Khi tải nội dung lên, bạn phải điền vào trường content_mime_type và trường này phải khớp với loại nội dung bạn đang tải lên.

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ create_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": "create_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 tải tệp lên.

CreateFileRequest

Biểu diễn dưới dạng JSON 
{
  "title": string,
  "mimeType": string,
  "contentMimeType": string,
  "content": string,
  "base64Content": string,
  "textContent": string,
  "parentId": string,
  "disableConversionToGoogleType": boolean
}
Trường
title

string

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

string

KHÔNG CÒN DÙNG NỮA. KHÔNG SỬ DỤNG!! Thay vào đó, hãy đặt content_mime_type.
contentMimeType

string

Loại mime của nội dung đang được tải lên. Bắt buộc khi bạn cung cấp bất kỳ loại nội dung nào.
content

string

Nội dung của tệp được mã hoá dưới dạng base64. Trường nội dung phải luôn được mã hoá base64, bất kể loại MIME của tệp là gì. KHÔNG CÒN DÙNG NỮA. Thay vào đó, hãy sử dụng base64_content hoặc text_content.
base64Content

string

Không bắt buộc. Nội dung được mã hoá base64 để tải lên. Bạn không được đặt cả hai tham số này và text_content.
textContent

string

Không bắt buộc. Nội dung văn bản (UTF-8) cần tải lên. Đã xảy ra lỗi khi đặt tham số này và base64_content.
parentId

string

Mã nhận dạng chính của tệp.
disableConversionToGoogleType

boolean

Đặt thành true để giữ lại loại mime nội dung được truyền vào và không chuyển đổi thành loại của Google. Ví dụ: nếu không có tham số này, loại mime nội dung text/plain sẽ được chuyển đổi thành application/vnd.google-apps.document. Không ảnh hưởng đến những loại không có loại tương đương trên Google.

Giản đồ đầu ra

Một 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 đã được tìm nạp.
title

string

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

string

Mã nhận dạng (không bắt buộc) của thư mục mẹ của tệp.

Trường nhóm _mime_type.

_mime_type chỉ có thể là một trong những trạng thái 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 thái 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 thái sau:
description

string

Nội dung mô tả tệp.

Trường nhóm _file_extension.

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

string

Phần mở rộng tệp gốc của tệp, chỉ được điền sẵn cho những 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 thái 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 thái 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 thái 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 thái sau:
createdTime

string (Timestamp format)

Thời gian tạo 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 _modified_time.

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

string (Timestamp format)

Thời gian 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 thái sau:
viewedByMeTime

string (Timestamp format)

Thời gian 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 thái 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 thái sau:
canAddChildren

boolean

Liệu người yêu cầu có thể thêm trẻ em vào thư mục này hay không. Giá trị 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 gian 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, chứ không phải là một lựa chọn thay thế cho giây. Giá trị giây âm có phân số vẫn phải có giá trị nano giây không âm để đếm thời gian. Phải nằm trong khoảng từ 0 đến 999.999.999.

Chú giải công cụ

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