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 Sheets בתוך השורה במיקום שצוין.
  • ‫mergeTableCells: ממזג תאים בטבלה.
  • ‫unmergeTableCells: ביטול המיזוג של תאים בטבלה.
  • ‫refreshSheetsChart: רענון של תרשים ב-Google Sheets.
  • ‫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 כדי להפעיל את כלי ה-MCP‏ update_doc.

בקשת 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 מכלי Drive.
requests[]

object (Struct format)

רשימה של עדכונים להחלה על המסמך. כל בקשה צריכה להיות אובייקט בקשה תקין של documents.batchUpdate, באמצעות הסכימה שמתועדת בכתובת: https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/request הבקשות יחולו לפי הסדר שבו הן מצוינות. אם בקשה כלשהי לא תהיה תקפה, אף בקשה לא תתבצע.

Struct

ייצוג 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
}
שדות
שדה איחוד kind. סוג הערך. הערך kind יכול להיות רק אחד מהבאים:
nullValue

null

מייצג null JSON.
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

מייצג null JSON.

‫NullValue הוא ערך שמירה, שמשתמש בערך מספרי עם ערך אחד בלבד כדי לייצג את ערך ה-null עבור איחוד הסוגים Value.

שדה מסוג NullValue עם ערך כלשהו שאינו 0 נחשב לא תקין. רוב כלי הסריאליזציה של ProtoJSON יפלטו Value עם null_value שמוגדר כ-null JSON בלי קשר לערך המספרי, ולכן יבצעו המרה הלוך ושוב לערך 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

Struct

ייצוג 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
}
שדות
שדה איחוד kind. סוג הערך. הערך kind יכול להיות רק אחד מהבאים:
nullValue

null

מייצג null JSON.
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

מייצג null JSON.

‫NullValue הוא ערך שמירה, שמשתמש בערך מספרי עם ערך אחד בלבד כדי לייצג את ערך ה-null עבור איחוד הסוגים Value.

שדה מסוג NullValue עם ערך כלשהו שאינו 0 נחשב לא תקין. רוב כלי הסריאליזציה של ProtoJSON יפלטו Value עם null_value שמוגדר כ-null JSON בלי קשר לערך המספרי, ולכן יבצעו המרה הלוך ושוב לערך 0.

טיפוסים בני מנייה (enum)
NULL_VALUE ערך null.

הערות על כלים

רמז הרסני: ❌ | רמז אידמפוטנטי: ❌ | רמז לקריאה בלבד: ❌ | רמז לעולם פתוח: ✅