MCP Tools Reference: docsmcp.googleapis.com

도구: update_doc

일괄 업데이트 요청을 사용하여 문서를 업데이트합니다. documents.batchUpdate 요청 (JSON)을 수락합니다.

REST API의 documents.batchUpdate에 해당합니다.

가능한 업데이트 목록은 다음과 같습니다.

  • 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를 사용하여 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

필수 항목입니다. 업데이트할 문서의 ID입니다. 이는 드라이브 도구의 file_id와 동일합니다.
requests[]

object (Struct format)

문서에 적용할 업데이트 목록입니다. 각 요청은 https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/request에 설명된 스키마를 사용하는 유효한 documents.batchUpdate 요청 객체여야 합니다. 요청은 지정된 순서대로 적용됩니다. 유효하지 않은 요청이 있으면 요청이 적용되지 않습니다.

구조체

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

JSON null를 나타냅니다.
numberValue

number

JSON 숫자를 나타냅니다. JSON에서 지원되지 않으므로 NaN, Infinity 또는 -Infinity가 아니어야 합니다. 또한 JSON 형식은 일반적으로 숫자 유형에서 큰 Int64 값을 지원하지 않으므로 이를 표현할 수 없습니다.
stringValue

string

JSON 문자열을 나타냅니다.
boolValue

boolean

JSON 불리언 (JSON의 true 또는 false 리터럴)을 나타냅니다.
structValue

object (Struct format)

JSON 객체를 나타냅니다.
listValue

array (ListValue format)

JSON 배열을 나타냅니다.

ListValue

JSON 표현 
{
  "values": [
    value
  ]
}
필드
values[]

value (Value format)

동적으로 입력된 값의 반복 필드입니다.

NullValue

JSON null를 나타냅니다.

NullValue는 Value 유형 결합의 null 값을 나타내기 위해 값이 하나만 있는 enum을 사용하는 센티널입니다.

0 이외의 값이 있는 NullValue 유형의 필드는 잘못된 것으로 간주됩니다. 대부분의 ProtoJSON 직렬화 프로그램은 정수 값과 관계없이 null_value이 JSON null로 설정된 Value를 내보내므로 0 값으로 왕복합니다.

열거형
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
}
필드
통합 필드 kind. 값의 종류입니다. kind은 다음 중 하나여야 합니다.
nullValue

null

JSON null를 나타냅니다.
numberValue

number

JSON 숫자를 나타냅니다. JSON에서 지원되지 않으므로 NaN, Infinity 또는 -Infinity가 아니어야 합니다. 또한 JSON 형식은 일반적으로 숫자 유형에서 큰 Int64 값을 지원하지 않으므로 이를 표현할 수 없습니다.
stringValue

string

JSON 문자열을 나타냅니다.
boolValue

boolean

JSON 불리언 (JSON의 true 또는 false 리터럴)을 나타냅니다.
structValue

object (Struct format)

JSON 객체를 나타냅니다.
listValue

array (ListValue format)

JSON 배열을 나타냅니다.

ListValue

JSON 표현 
{
  "values": [
    value
  ]
}
필드
values[]

value (Value format)

동적으로 입력된 값의 반복 필드입니다.

NullValue

JSON null를 나타냅니다.

NullValue는 Value 유형 결합의 null 값을 나타내기 위해 값이 하나만 있는 enum을 사용하는 센티널입니다.

0 이외의 값이 있는 NullValue 유형의 필드는 잘못된 것으로 간주됩니다. 대부분의 ProtoJSON 직렬화 프로그램은 정수 값과 관계없이 null_value이 JSON null로 설정된 Value를 내보내므로 0 값으로 왕복합니다.

열거형
NULL_VALUE null 값입니다.

도구 주석

파괴적 힌트: ❌ | 동일한 힌트: ❌ | 읽기 전용 힌트: ❌ | 오픈 월드 힌트: ✅