MCP Tools Reference: docsmcp.googleapis.com

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

อัปเดตเอกสารโดยใช้คำขออัปเดตแบบเป็นกลุ่ม โดยจะยอมรับคำขอ documents.batchUpdate (ในรูปแบบ JSON)

สอดคล้องกับ documents.batchUpdate ใน REST API

รายการการอัปเดตที่เป็นไปได้มีดังนี้

  • replaceAllText: แทนที่ข้อความที่ระบุทั้งหมด
  • insertText: แทรกข้อความในตำแหน่งที่ระบุ
  • updateTextStyle: อัปเดตรูปแบบข้อความในช่วงที่ระบุ
  • createParagraphBullets: สร้างหัวข้อย่อยสำหรับย่อหน้า
  • deleteParagraphBullets: ลบสัญลักษณ์แสดงหัวข้อย่อยออกจากย่อหน้า
  • createNamedRange: สร้างช่วงที่ตั้งชื่อแล้ว
  • deleteNamedRange: ลบช่วงที่ตั้งชื่อแล้ว
  • updateParagraphStyle: อัปเดตรูปแบบย่อหน้าในช่วงที่ระบุ
  • deleteContentRange: ลบเนื้อหาออกจากเอกสาร
  • insertInlineImage: แทรกรูปภาพในบรรทัดที่ตำแหน่งที่ระบุ
  • insertTable: แทรกตารางในตำแหน่งที่ระบุ
  • insertTableRow: แทรกแถวว่างลงในตาราง
  • insertTableColumn: แทรกคอลัมน์ว่างลงในตาราง
  • deleteTableRow: ลบแถวออกจากตาราง
  • deleteTableColumn: ลบคอลัมน์ออกจากตาราง
  • insertPageBreak: แทรกตัวแบ่งหน้าในตำแหน่งที่ระบุ
  • deletePositionedObject: ลบออบเจ็กต์ที่จัดตำแหน่งออกจากเอกสาร
  • updateTableColumnProperties: อัปเดตพร็อพเพอร์ตี้ของคอลัมน์ในตาราง
  • updateTableCellStyle: อัปเดตสไตล์ของตาราง
  • updateTableRowStyle: อัปเดตสไตล์แถวในตาราง
  • replaceImage: แทนที่รูปภาพในเอกสาร
  • updateDocumentStyle: อัปเดตสไตล์ของเอกสาร
  • insertInlineSheetsChart: แทรกแผนภูมิ Google ชีตในบรรทัดที่ตำแหน่งที่ระบุ
  • mergeTableCells: ผสานเซลล์ในตาราง
  • unmergeTableCells: ยกเลิกการผสานเซลล์ในตาราง
  • refreshSheetsChart: รีเฟรชแผนภูมิ Google ชีต
  • createHeader: สร้างส่วนหัว
  • createFooter: สร้างส่วนท้าย
  • createFootnote: สร้างเชิงอรรถ
  • replaceNamedRangeContent: แทนที่เนื้อหาในช่วงที่ตั้งชื่อ
  • updateEmbeddedObject: อัปเดตพร็อพเพอร์ตี้ของออบเจ็กต์ที่ฝัง
  • updateSectionStyle: อัปเดตรูปแบบส่วนของช่วงที่ระบุ
  • insertSectionBreak: แทรกตัวแบ่งส่วนที่ตำแหน่งที่ระบุ
  • deleteHeader: ลบส่วนหัวออกจากเอกสาร
  • deleteFooter: ลบส่วนท้ายออกจากเอกสาร
  • pinTableHeaderRows: อัปเดตจำนวนแถวส่วนหัวที่ปักหมุดในตาราง
  • addDocumentTab: เพิ่มแท็บเอกสาร
  • deleteTab: ลบแท็บเอกสาร
  • updateDocumentTabProperties: อัปเดตพร็อพเพอร์ตี้ของแท็บเอกสาร
  • insertPerson: แท็กบุคคล
  • updateNamedStyle: อัปเดตสไตล์ที่มีชื่อ
  • insertRichLink: แทรกลิงก์ริชมีเดีย
  • insertDate: แทรกวันที่
  • insertComment: แทรก CommentThread ลงในเอกสาร
  • addCommentReply: เพิ่มคำตอบใน CommentThread หรือ SuggestionThread
  • updateCommentPost: อัปเดตโพสต์ที่มีอยู่ (โพสต์หลักหรือการตอบกลับ) ของ CommentThread หรือ SuggestionThread
  • deleteComment: ลบ CommentThread
  • deleteCommentReply: ลบโพสต์การตอบกลับจาก CommentThread หรือ SuggestionThread
  • acceptSuggestion: ยอมรับคำแนะนำ
  • rejectSuggestion: ปฏิเสธคำแนะนำ
  • deleteSuggestion: ลบคำแนะนำ

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

คำขอ Curl 
curl --location 'https://docsmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "update_doc",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

สคีมาอินพุต

UpdateDocRequest

การแสดง JSON 
{
  "documentId": string,
  "requests": [
    {
      object
    }
  ]
}
ช่อง
documentId

string

ต้องระบุ รหัสของเอกสารที่จะอัปเดต ซึ่งจะเหมือนกับ file_id จากเครื่องมือของไดรฟ์
requests[]

object (Struct format)

รายการการอัปเดตที่จะใช้กับเอกสาร คำขอแต่ละรายการควรเป็นออบเจ็กต์คำขอ documents.batchUpdate ที่ถูกต้อง โดยใช้สคีมาที่ระบุไว้ใน https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/request ระบบจะใช้คำขอตามลำดับที่ระบุ หากคำขอใดไม่ถูกต้อง ระบบจะไม่นำคำขอใดๆ ไปใช้

โครงสร้าง

การแสดง JSON 
{
  "fields": {
    string: value,
    ...
  }
}
ช่อง
fields

map (key: string, value: value (Value format))

แมปค่าที่พิมพ์แบบไดนามิกที่ไม่มีการเรียงลำดับ

ออบเจ็กต์ที่มีรายการคู่ "key": value เช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }

FieldsEntry

การแสดง JSON 
{
  "key": string,
  "value": value
}
ช่อง
key

string
value

value (Value format)

ค่า

การแสดง JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
ช่อง
ฟิลด์ Union kind ประเภทของค่า kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
nullValue

null

แสดง JSON null
numberValue

number

แสดงตัวเลข JSON ต้องไม่ใช่ NaN, Infinity หรือ -Infinity เนื่องจาก JSON ไม่รองรับ นอกจากนี้ยังไม่สามารถแสดงค่า Int64 ขนาดใหญ่ได้ เนื่องจากโดยทั่วไปแล้วรูปแบบ JSON ไม่รองรับค่าดังกล่าวในประเภทตัวเลข
stringValue

string

แสดงสตริง JSON
boolValue

boolean

แสดงบูลีน JSON (true หรือ false สัญพจน์ใน JSON)
structValue

object (Struct format)

แสดงออบเจ็กต์ JSON
listValue

array (ListValue format)

แสดงอาร์เรย์ JSON

ListValue

การแสดง JSON 
{
  "values": [
    value
  ]
}
ช่อง
values[]

value (Value format)

ฟิลด์ที่ซ้ำของค่าที่พิมพ์แบบไดนามิก

NullValue

แสดง JSON null

NullValue เป็นตัวคั่น โดยใช้ enum ที่มีค่าเพียงค่าเดียวเพื่อแสดงค่า Null สำหรับการรวมประเภท Value

ฟิลด์ประเภท NullValue ที่มีค่าอื่นที่ไม่ใช่ 0 จะถือว่าไม่ถูกต้อง โปรแกรมซีเรียลไลซ์ ProtoJSON ส่วนใหญ่จะส่ง Value ที่มี null_value ตั้งค่าเป็น JSON null โดยไม่คำนึงถึงค่าจำนวนเต็ม และจะส่งกลับค่า 0

Enum
NULL_VALUE ค่า Null

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

UpdateDocResponse

การแสดง JSON 
{
  "replies": [
    {
      object
    }
  ]
}
ช่อง
replies[]

object (Struct format)

การตอบกลับจากการดำเนินการคำขออัปเดตแบบกลุ่ม รวมข้อผิดพลาด คำเตือน และการตอบกลับ API ดิบเพื่อช่วยให้โมเดลทำการปรับเปลี่ยน การตอบกลับ API แบบดิบใช้สคีมาที่ระบุไว้ใน https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/response

โครงสร้าง

การแสดง JSON 
{
  "fields": {
    string: value,
    ...
  }
}
ช่อง
fields

map (key: string, value: value (Value format))

แมปค่าที่พิมพ์แบบไดนามิกที่ไม่มีการเรียงลำดับ

ออบเจ็กต์ที่มีรายการคู่ "key": value เช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }

FieldsEntry

การแสดง JSON 
{
  "key": string,
  "value": value
}
ช่อง
key

string
value

value (Value format)

ค่า

การแสดง JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
ช่อง
ฟิลด์ Union kind ประเภทของค่า kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
nullValue

null

แสดง JSON null
numberValue

number

แสดงตัวเลข JSON ต้องไม่ใช่ NaN, Infinity หรือ -Infinity เนื่องจาก JSON ไม่รองรับ นอกจากนี้ยังไม่สามารถแสดงค่า Int64 ขนาดใหญ่ได้ เนื่องจากโดยทั่วไปแล้วรูปแบบ JSON ไม่รองรับค่าดังกล่าวในประเภทตัวเลข
stringValue

string

แสดงสตริง JSON
boolValue

boolean

แสดงบูลีน JSON (true หรือ false สัญพจน์ใน JSON)
structValue

object (Struct format)

แสดงออบเจ็กต์ JSON
listValue

array (ListValue format)

แสดงอาร์เรย์ JSON

ListValue

การแสดง JSON 
{
  "values": [
    value
  ]
}
ช่อง
values[]

value (Value format)

ฟิลด์ที่ซ้ำของค่าที่พิมพ์แบบไดนามิก

NullValue

แสดง JSON null

NullValue เป็นตัวคั่น โดยใช้ enum ที่มีค่าเพียงค่าเดียวเพื่อแสดงค่า Null สำหรับการรวมประเภท Value

ฟิลด์ประเภท NullValue ที่มีค่าอื่นที่ไม่ใช่ 0 จะถือว่าไม่ถูกต้อง โปรแกรมซีเรียลไลซ์ ProtoJSON ส่วนใหญ่จะส่ง Value ที่มี null_value ตั้งค่าเป็น JSON null โดยไม่คำนึงถึงค่าจำนวนเต็ม และจะส่งกลับค่า 0

Enum
NULL_VALUE ค่า Null

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

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