MCP Tools Reference: drivemcp.googleapis.com

เครื่องมือ: create_file

เรียกใช้เครื่องมือนี้เพื่อสร้างหรืออัปโหลดไฟล์ไปยัง Google ไดรฟ์

หากอัปโหลดเนื้อหา ให้ใช้ "text_content" สำหรับเนื้อหาข้อความ สำหรับเนื้อหาที่ไม่ใช่ UTF8 ให้ใช้ช่อง "base64_content" และเข้ารหัสข้อมูลแบบ base64 เพื่อตั้งค่าในช่องดังกล่าว

แสดงผลออบเจ็กต์ไฟล์รายการเดียวเมื่อสร้างไฟล์สำเร็จ

คุณสร้าง MIME Type ของบุคคลที่หนึ่งใน Google ไดรฟ์ต่อไปนี้ได้โดยไม่ต้องระบุเนื้อหา

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

ระบบจะทำการแปลงต่อไปนี้สำหรับ MIME Type ต่อไปนี้โดยค่าเริ่มต้น

  • text/plain เป็น application/vnd.google-apps.document
  • text/csv เป็น application/vnd.google-apps.spreadsheet

หากต้องการปิดใช้การแปลงสำหรับ MIME Type ของบุคคลที่หนึ่ง ให้ตั้งค่า disable_conversion_to_google_type เป็น "จริง"

คุณสร้างโฟลเดอร์ได้โดยตั้งค่า MIME Type เป็น application/vnd.google-apps.folder

เมื่ออัปโหลดเนื้อหา คุณต้องระบุช่อง content_mime_type และค่าในช่องนี้ควรตรงกับประเภทของเนื้อหาที่อัปโหลด

ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ create_file MCP

Curl Request 
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
}'

สคีมาอินพุต

คำขออัปโหลดไฟล์

CreateFileRequest

การแสดง JSON 
{
  "title": string,
  "mimeType": string,
  "contentMimeType": string,
  "content": string,
  "base64Content": string,
  "textContent": string,
  "parentId": string,
  "disableConversionToGoogleType": boolean
}
ช่อง
title

string

ชื่อไฟล์
mimeType

string

เลิกใช้งานแล้ว ห้ามใช้!! ให้ตั้งค่า content_mime_type แทน
contentMimeType

string

MIME Type ของเนื้อหาที่อัปโหลด ต้องระบุเมื่อมีการระบุเนื้อหาประเภทใดก็ตาม
content

string

เนื้อหาของไฟล์ที่เข้ารหัสเป็น base64 ช่องเนื้อหาควรเข้ารหัสแบบ base64 เสมอ ไม่ว่า MIME Type ของไฟล์จะเป็นอะไรก็ตาม เลิกใช้งานแล้ว ให้ใช้ base64_content หรือ text_content แทน
base64Content

string

ไม่บังคับ เนื้อหาที่เข้ารหัส base64 ที่จะอัปโหลด การตั้งค่าทั้งช่องนี้และ text_content จะทำให้เกิดข้อผิดพลาด
textContent

string

ไม่บังคับ เนื้อหาข้อความ (UTF-8) ที่จะอัปโหลด การตั้งค่าทั้งช่องนี้และ base64_content จะทำให้เกิดข้อผิดพลาด
parentId

string

รหัสระดับบนสุดของไฟล์
disableConversionToGoogleType

boolean

ตั้งค่าเป็น "จริง" เพื่อเก็บ MIME Type ของเนื้อหาที่ส่งเข้ามาไว้และไม่แปลงเป็นประเภท Google เช่น หากไม่มีการตั้งค่านี้ ระบบจะแปลง MIME Type ของเนื้อหา text/plain เป็น application/vnd.google-apps.document ไม่มีผลกับประเภทที่ไม่มีประเภทที่เทียบเท่าใน Google

สคีมาเอาต์พุต

ทรัพยากรไฟล์

ไฟล์

การแสดง 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

รหัส (ไม่บังคับ) ของระดับบนสุดของไฟล์

ฟิลด์ Union _mime_type

_mime_type สามารถเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
mimeType

string

MIME Type ของไฟล์

ฟิลด์ Union _file_size

_file_size สามารถเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
fileSize

string (int64 format)

ขนาดของไฟล์ในหน่วยไบต์

ฟิลด์ Union _description

_description สามารถเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
description

string

คำอธิบายของไฟล์

ฟิลด์ Union _file_extension

_file_extension สามารถเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
fileExtension

string

นามสกุลไฟล์เดิมของไฟล์ ซึ่งจะแสดงเฉพาะสำหรับไฟล์ที่มีเนื้อหาจัดเก็บไว้ในไดรฟ์

ฟิลด์ Union _content_snippet

_content_snippet สามารถเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
contentSnippet

string

ข้อมูลสรุปที่สร้างขึ้นเกี่ยวกับเนื้อหาของไฟล์

ฟิลด์ Union _view_url

_view_url สามารถเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
viewUrl

string

URL สำหรับดูไฟล์

ฟิลด์ Union _shared_with_me_time

_shared_with_me_time สามารถเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
sharedWithMeTime

string (Timestamp format)

เวลาที่แชร์ไฟล์กับผู้ส่งคำขอ

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

ฟิลด์ Union _created_time

_created_time สามารถเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
createdTime

string (Timestamp format)

เวลาที่สร้างไฟล์

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

ฟิลด์ Union _modified_time

_modified_time สามารถเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
modifiedTime

string (Timestamp format)

เวลาล่าสุดที่แก้ไขไฟล์

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

ฟิลด์ Union _viewed_by_me_time

_viewed_by_me_time สามารถเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
viewedByMeTime

string (Timestamp format)

เวลาล่าสุดที่ผู้ส่งคำขอได้ดูไฟล์

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

ฟิลด์ Union _owner

_owner สามารถเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
owner

string

อีเมลของเจ้าของไฟล์

ฟิลด์ Union _can_add_children

_can_add_children สามารถเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
canAddChildren

boolean

ระบุว่าผู้ส่งคำขอเพิ่มรายการย่อยลงในโฟลเดอร์นี้ได้หรือไม่ ค่าจะเป็น "เท็จ" เสมอสำหรับประเภทที่ไม่ใช่โฟลเดอร์

การประทับเวลา

การแสดง JSON 
{
  "seconds": string,
  "nanos": integer
}
ช่อง
seconds

string (int64 format)

แสดงถึงวินาทีของเวลา UTC ตั้งแต่ Epoch ของ Unix 1970-01-01T00:00:00Z ต้องอยู่ระหว่าง -62135596800 ถึง 253402300799 (รวม) ซึ่งสอดคล้องกับ 0001-01-01T00:00:00Z ถึง 9999-12-31T23:59:59Z
nanos

integer

เศษส่วนที่ไม่ใช่ค่าลบของวินาทีที่ความละเอียดระดับนาโนวินาที ช่องนี้เป็นส่วนนาโนวินาทีของระยะเวลา ไม่ใช่ทางเลือกแทนวินาที ค่าวินาทีที่เป็นค่าลบซึ่งมีเศษส่วนจะต้องมีค่านาโนที่ไม่ใช่ค่าลบซึ่งนับไปข้างหน้าในเวลา ต้องอยู่ระหว่าง 0 ถึง 999,999,999 (รวม)

คำอธิบายประกอบของเครื่องมือ

คำแนะนำที่อาจทำให้เกิดการเปลี่ยนแปลง: ❌ | คำแนะนำที่อาจทำให้เกิดการเปลี่ยนแปลงซ้ำได้: ❌ | คำแนะนำแบบอ่านอย่างเดียว: ❌ | คำแนะนำแบบโอเพนเวิลด์: ✅