MCP Tools Reference: drivemcp.googleapis.com

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

เรียกใช้เครื่องมือนี้เพื่อดึงข้อมูลการแสดงไฟล์ในไดรฟ์ด้วยภาษาธรรมชาติ และความคิดเห็นของไฟล์ (ไม่บังคับ)

เนื้อหาของไฟล์อาจไม่สมบูรณ์สำหรับไฟล์ที่มีขนาดใหญ่มาก การแสดงข้อความจะเปลี่ยนแปลงไปเรื่อยๆ ดังนั้นอย่าคาดเดารูปแบบเฉพาะของข้อความที่เครื่องมือนี้แสดง หากรองรับ ระบบจะรวมแท็กความคิดเห็นไว้ในเนื้อหา

ประเภท MIME ที่รองรับ

  • application/vnd.google-apps.document
  • application/vnd.google-apps.presentation
  • application/vnd.google-apps.spreadsheet
  • application/pdf
  • application/msword
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.oasis.opendocument.spreadsheet
  • application/vnd.oasis.opendocument.presentation
  • application/x-vnd.oasis.opendocument.text
  • image/png
  • image/jpeg
  • image/jpg

หากไม่พบไฟล์ ให้ลองใช้เครื่องมืออื่นๆ เช่น search_files เพื่อค้นหาไฟล์ที่ผู้ใช้ขอโดยใช้คีย์เวิร์ด

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

คำขอ 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": "read_file_content",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

สคีมาอินพุต

คำขออ่านเนื้อหาไฟล์พร้อมรองรับการดึงความคิดเห็น

ReadFileContentRequest

การแสดง JSON 
{
  "fileId": string,
  "includeComments": boolean
}
ช่อง
fileId

string

ต้องระบุ รหัสของไฟล์ที่จะดึงข้อมูล
includeComments

boolean

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

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

การตอบกลับเพื่ออ่านเนื้อหาไฟล์

ReadFileContentResponse

การแสดง JSON 
{
  "contentAnchoredComments": [
    {
      object (CommentThread)
    }
  ],
  "unanchoredComments": [
    {
      object (CommentThread)
    }
  ],

  "fileContent": string

  "textFormattingNotSupported": boolean
  // End of list of possible types for union field
  // _text_formatting_not_supported.

  "commentsNotSupported": boolean
}
ช่อง
contentAnchoredComments[]

object (CommentThread)

ชุดข้อความความคิดเห็นที่อ้างอิงใน file_content ที่ส่งคืน
unanchoredComments[]

object (CommentThread)

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

ฟิลด์ Union _file_content

_file_content ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
fileContent

string

เนื้อหาไฟล์ในไดรฟ์ที่แสดงผลในรูปแบบข้อความ อาจว่างเปล่าหากระบบไม่รองรับไฟล์สำหรับการจัดรูปแบบข้อความ สามารถรวมการอ้างอิงความคิดเห็นได้หาก include_comments เป็นจริงในคำขอ

ฟิลด์ Union _text_formatting_not_supported

_text_formatting_not_supported ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
textFormattingNotSupported

boolean

ระบุว่าไฟล์นี้รองรับการจัดรูปแบบข้อความหรือไม่ หากเป็นจริง file_content จะว่างเปล่า

ฟิลด์ Union _comments_not_supported

_comments_not_supported ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
commentsNotSupported

boolean

ไม่ว่าจะรองรับการแสดงความคิดเห็นสำหรับไฟล์นี้หรือไม่ จะแสดงก็ต่อเมื่อ include_comments เป็นจริงในคำขอและระบบไม่รองรับความคิดเห็น

CommentThread

การแสดง JSON 
{
  "replies": [
    {
      object (Post)
    }
  ],

  "commentId": string

  "status": enum (Status)

  "headPost": {
    object (Post)
  }
}
ช่อง
replies[]

object (Post)

การตอบกลับโพสต์แรกในชุดข้อความความคิดเห็น

ฟิลด์ Union _comment_id

_comment_id ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
commentId

string

รหัสของชุดข้อความของความคิดเห็น ซึ่งเป็นรหัสเดียวกับความคิดเห็นแรก

ฟิลด์ Union _status

_status ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
status

enum (Status)

สถานะของชุดข้อความของความคิดเห็น

ฟิลด์ Union _head_post

_head_post ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
headPost

object (Post)

โพสต์แรกในชุดข้อความความคิดเห็น

โพสต์

การแสดง JSON 
{

  "postId": string

  "content": string

  "authorName": string

  "modifiedTime": string
}
ช่อง

ฟิลด์ Union _post_id

_post_id ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
postId

string

รหัสของโพสต์

ฟิลด์ Union _content

_content ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
content

string

เนื้อหาของโพสต์

ฟิลด์ Union _author_name

_author_name ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
authorName

string

ชื่อผู้เขียนโพสต์

ฟิลด์ 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"

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

การแสดง 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 เท่านั้น

สถานะ

กำหนดสถานะของชุดข้อความของความคิดเห็น

Enum
STATUS_UNSPECIFIED
OPEN
RESOLVED

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

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly