MCP Tools Reference: sheetsmcp.googleapis.com

도구: update_spreadsheet

스프레드시트에 하나 이상의 업데이트를 적용합니다.

REST API의 spreadsheets.batchUpdate에 해당합니다. https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate

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

  • updateSpreadsheetProperties: 스프레드시트의 속성을 업데이트합니다. 스키마:
  • properties (객체, 필수): 업데이트할 스프레드시트 속성 ({"title": string, "locale": string, "timeZone": string})입니다.
  • fields (문자열, 필수): 업데이트할 속성의 필드 마스크입니다 (예: "title" 또는 "*").
  • updateSheetProperties: 시트의 속성을 업데이트합니다. 스키마:
  • properties (객체, 필수): 시트 속성 ({"sheetId": int, "title": string, "index": int, "gridProperties": {"rowCount": int, "columnCount": int, "frozenRowCount": int, "frozenColumnCount": int, "hideGridlines": bool}, "hidden": bool, "tabColorStyle": {"rgbColor": {"red": float, "green": float, "blue": float}}})입니다.
  • fields (문자열, 필수): 업데이트할 속성의 필드 마스크입니다 (예: "title", "gridProperties.frozenRowCount").
  • updateDimensionProperties: 측정기준의 속성 (예: 행 높이 또는 열 너비)을 업데이트합니다. 스키마:
  • range (객체, 필수): 측정기준 범위 ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int})입니다.
  • properties (객체, 필수): 측정기준 속성 ({"pixelSize": int, "hiddenByUser": bool})입니다.
  • fields (문자열, 필수): 업데이트할 속성의 필드 마스크입니다 (예: "pixelSize").
  • updateNamedRange: 이름이 지정된 범위를 업데이트합니다. 스키마:
  • namedRange (객체, 필수): 이름이 지정된 범위 정의 ({"namedRangeId": string, "name": string, "range": {"sheetId": int, "startRowIndex": int, "endRowIndex": int, "startColumnIndex": int, "endColumnIndex": int}})입니다.
  • fields (문자열, 필수): 업데이트할 필드의 필드 마스크입니다 (예: "name,range" 또는 "*").
  • repeatCell: 범위 전체에서 단일 셀을 반복합니다. 스키마:
  • range (객체, 필수): 셀 데이터/형식을 적용할 그리드 범위 ({"sheetId": int, "startRowIndex": int, "endRowIndex": int, "startColumnIndex": int, "endColumnIndex": int})입니다.
  • cell (객체, 필수): 셀 데이터 ({"userEnteredValue": {"stringValue": str, "numberValue": float, "formulaValue": str}, "userEnteredFormat": {"textFormat": {"bold": bool, "italic": bool, "fontSize": int}, "backgroundColorStyle": {"rgbColor": {"red": float, "green": float, "blue": float}}, "horizontalAlignment": "LEFT"|"CENTER"|"RIGHT", "wrapStrategy": "WRAP"|"CLIP"|"OVERFLOW_CELL"}})입니다.
  • fields (문자열, 필수): 업데이트할 셀 필드의 필드 마스크입니다 (예: "userEnteredFormat.textFormat.bold" 또는 "userEnteredValue").
  • addNamedRange: 이름이 지정된 범위를 추가합니다. 스키마:
  • namedRange (객체, 필수): 추가할 이름이 지정된 범위 ({"namedRangeId": string (optional), "name": string, "range": {"sheetId": int, "startRowIndex": int, "endRowIndex": int, "startColumnIndex": int, "endColumnIndex": int}})입니다.
  • deleteNamedRange: ID로 이름이 지정된 범위를 삭제합니다. 스키마:
  • namedRangeId (문자열, 필수): 삭제할 이름이 지정된 범위의 ID입니다.
  • addSheet: 시트를 추가합니다. 스키마:
  • properties (객체, 선택사항): 시트 속성 ({"title": string, "sheetId": int (optional), "index": int (optional), "gridProperties": {"rowCount": int, "columnCount": int}})입니다.
  • deleteSheet: 시트를 삭제합니다. 스키마:
  • sheetId (정수, 필수): 삭제할 시트의 ID입니다.
  • autoFill: 기존 데이터를 기반으로 더 많은 데이터를 자동으로 채웁니다. 스키마:
  • range (객체, 선택사항): 검사하고 채울 범위 ({"sheetId": int, "startRowIndex": int, "endRowIndex": int, "startColumnIndex": int, "endColumnIndex": int})입니다.
  • sourceAndDestination (객체, 선택사항): 명시적 소스 및 채우기 길이 ({"source": GridRange, "dimension": "ROWS"|"COLUMNS", "fillLength": int})입니다.
  • useAlternateSeries (불리언, 선택사항): 대체 시리즈를 사용할지 여부입니다.
  • cutPaste: 한 영역에서 데이터를 잘라내어 다른 영역에 붙여넣습니다. 스키마:
  • source (객체, 필수): 소스 그리드 범위입니다.
  • destination (객체, 필수): 왼쪽 상단 도착지 좌표 ({"sheetId": int, "rowIndex": int, "columnIndex": int})입니다.
  • pasteType (문자열, 선택사항): "PASTE_NORMAL", "PASTE_VALUES", "PASTE_FORMAT", "PASTE_NO_BORDERS", "PASTE_FORMULA".
  • copyPaste: 한 영역에서 데이터를 복사하여 다른 영역에 붙여넣습니다. 스키마:
  • source (객체, 필수): 소스 그리드 범위입니다.
  • destination (객체, 필수): 대상 그리드 범위입니다.
  • pasteType (문자열, 선택사항): "PASTE_NORMAL", "PASTE_VALUES", "PASTE_FORMAT", "PASTE_NO_BORDERS", "PASTE_FORMULA".
  • pasteOrientation (문자열, 선택사항): "NORMAL" 또는 "TRANSPOSE".
  • mergeCells: 셀을 병합합니다. 스키마:
  • range (객체, 필수): 병합할 그리드 범위입니다.
  • mergeType (문자열, 필수): "MERGE_ALL", "MERGE_COLUMNS" 또는 "MERGE_ROWS"
  • unmergeCells: 병합된 셀을 병합 취소합니다. 스키마:
  • range (객체, 필수): 모든 셀의 병합을 취소할 그리드 범위입니다.
  • updateBorders: 셀 범위의 테두리를 업데이트합니다. 스키마:
  • range (객체, 필수): 테두리를 업데이트할 그리드 범위입니다.
  • top / bottom / left / right / innerHorizontal / innerVertical (객체, 선택사항): 테두리 스타일 ({"style": "SOLID"|"DASHED"|"DOTTED"|"DOUBLE"|"NONE", "width": int, "colorStyle": {"rgbColor": {"red": float, "green": float, "blue": float}}})입니다.
  • updateCells: 한 번에 여러 셀을 업데이트합니다. 스키마:
  • 영역 (정확히 하나 필요):
    • start (객체): 왼쪽 상단 좌표 ({"sheetId": int, "rowIndex": int, "columnIndex": int})입니다.
    • range (객체): 그리드 범위입니다.
  • rows (RowData 배열, 필수): 셀 행 ([{"values": [{"userEnteredValue": {"stringValue": str, "numberValue": float, "formulaValue": str}}]}])입니다.
  • fields (문자열, 필수): 업데이트할 셀 필드의 필드 마스크입니다 (예: "userEnteredValue" 또는 "userEnteredFormat").
  • addFilterView: 필터 보기를 추가합니다. 스키마:
  • filter (객체, 필수): 필터 보기 정의 ({"title": string, "range": GridRange, "criteria": map, "sortSpecs": list})입니다.
  • appendCells: 시트에서 데이터가 있는 마지막 행 뒤에 셀을 추가합니다. 스키마:
  • sheetId (정수, 필수): 데이터를 추가할 시트 ID입니다.
  • rows (RowData 배열, 필수): 추가할 데이터 행입니다.
  • fields (문자열, 필수): 필드 마스크 (예: "userEnteredValue")
  • clearBasicFilter: 시트의 기본 필터를 지웁니다. 스키마:
  • sheetId (정수, 필수): 기본 필터를 삭제할 시트 ID입니다.
  • deleteDimension: 시트의 행 또는 열을 삭제합니다. 스키마:
  • range (객체, 필수): 삭제할 측정기준 범위 ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int})입니다.
  • deleteEmbeddedObject: 시트에서 삽입된 객체 (예: 차트, 이미지)를 삭제합니다. 스키마:
  • objectId (정수, 필수): 삭제할 삽입된 객체의 ID입니다.
  • deleteFilterView: 시트에서 필터 보기를 삭제합니다. 스키마:
  • filterId (정수, 필수): 삭제할 필터 보기의 ID입니다.
  • duplicateFilterView: 필터 보기를 복제합니다. 스키마:
  • filterId (정수, 필수): 복제할 필터 보기의 ID입니다.
  • duplicateSheet: 시트를 복제합니다. 스키마:
  • sourceSheetId (정수, 필수): 복제할 시트 ID입니다.
  • insertSheetIndex (정수, 선택사항): 새 시트를 삽입할 위치의 0부터 시작하는 색인입니다.
  • newSheetId (정수, 선택사항): 새 시트의 ID입니다.
  • newSheetName (문자열, 선택사항): 새 시트의 이름입니다.
  • findReplace: 일부 텍스트를 찾아 다른 텍스트로 바꿉니다. 스키마:
  • find (문자열, 필수): 검색할 값입니다.
  • replacement (문자열, 필수): 대체 값입니다.
  • 범위 (정확히 하나 필요):
    • range (객체): 그리드 범위입니다.
    • sheetId (정수): 시트 ID입니다.
    • allSheets (불리언): 모든 시트를 검색하려면 true입니다.
  • matchCase / matchEntireCell / searchByRegex / includeFormulas (불리언, 선택사항).
  • insertDimension: 시트에 새 행 또는 열을 삽입합니다. 스키마:
  • range (객체, 필수): 삽입할 측정기준 범위 ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int})입니다.
  • inheritFromBefore (불리언, 선택사항): 이전 행/열에서 서식을 상속하려면 true입니다.
  • insertRange: 시트에 새 셀을 삽입하고 기존 셀을 이동합니다. 스키마:
  • range (객체, 필수): 셀을 삽입할 그리드 범위입니다.
  • shiftDimension (문자열, 필수): "ROWS" 또는 "COLUMNS".
  • moveDimension: 행 또는 열을 시트의 다른 위치로 이동합니다. 스키마:
  • source (객체, 필수): 소스 측정기준 범위 ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int})입니다.
  • destinationIndex (정수, 필수): 0부터 시작하는 목적지 색인입니다.
  • updateEmbeddedObjectPosition: 삽입된 객체 (예: 차트, 이미지)의 위치를 업데이트합니다. 스키마:
  • objectId (정수, 필수): 삽입된 객체의 ID입니다.
  • newPosition (객체, 필수): 새 위치 ({"overlayPosition": {"anchorCell": {"sheetId": int, "rowIndex": int, "columnIndex": int}, "widthPixels": int, "heightPixels": int}})입니다.
  • fields (문자열, 필수): 필드 마스크 (예: "overlayPosition.anchorCell")
  • pasteData: 시트에 데이터 (HTML 또는 구분 기호로 분리된 데이터)를 붙여넣습니다. 스키마:
  • coordinate (객체, 필수): 왼쪽 상단 좌표 ({"sheetId": int, "rowIndex": int, "columnIndex": int})입니다.
  • data (문자열, 필수): 구분된 텍스트 또는 HTML 데이터입니다.
  • delimiter (문자열, 선택사항) 또는 html (불리언, 선택사항)
  • type (문자열, 선택사항): "PASTE_NORMAL", "PASTE_VALUES" 등
  • textToColumns: 텍스트 열을 여러 텍스트 열로 변환합니다. 스키마:
  • source (객체, 필수): 단일 열 그리드 범위입니다.
  • delimiterType (문자열, 필수): "COMMA", "SEMICOLON", "PERIOD", "SPACE", "CUSTOM", "AUTODETECT".
  • delimiter (문자열, 선택사항): delimiterType이 "CUSTOM"인 경우 구분 기호 문자입니다.
  • updateFilterView: 필터 보기의 속성을 업데이트합니다. 스키마:
  • filter (객체, 필수): filterViewId를 포함하는 필터 보기 정의입니다.
  • fields (문자열, 필수): 필드 마스크 (예: "title,criteria" 또는 "*")
  • deleteRange: 시트에서 셀 범위를 삭제하고 나머지 셀을 이동합니다. 스키마:
  • range (객체, 필수): 삭제할 그리드 범위입니다.
  • shiftDimension (문자열, 필수): "ROWS" 또는 "COLUMNS".
  • appendDimension: 시트 끝에 측정기준을 추가합니다. 스키마:
  • sheetId (정수, 필수): 시트 ID입니다.
  • dimension (문자열, 필수): "ROWS" 또는 "COLUMNS".
  • length (정수, 필수): 추가할 행 또는 열의 수입니다.
  • addConditionalFormatRule: 새 조건부 서식 규칙을 추가합니다. 스키마:
  • rule (객체, 필수): 조건부 서식 규칙 ({"ranges": [GridRange], "booleanRule": {"condition": {"type": "NUMBER_GREATER_THAN_EQ"|"TEXT_CONTAINS"|..., "values": [{"userEnteredValue": string}]}, "format": CellFormat}, "gradientRule": {...}})입니다.
  • index (정수, 선택사항): 규칙을 삽입해야 하는 0부터 시작하는 색인입니다.
  • updateConditionalFormatRule: 기존 조건부 서식 규칙을 업데이트합니다. 스키마:
  • rule (객체, 필수): 새 조건부 서식 규칙입니다.
  • 색인/규칙 ID (필수 항목 1개):
    • index (정수): 0부터 시작하는 규칙 색인입니다.
    • sheetId (정수): 시트 색인으로 업데이트하는 경우 시트 ID입니다.
  • newIndex (정수, 선택사항): 규칙을 이동하기 위한 새 색인입니다.
  • deleteConditionalFormatRule: 기존 조건부 서식 규칙을 삭제합니다. 스키마:
  • index (정수, 필수): 삭제할 규칙의 0부터 시작하는 색인입니다.
  • sheetId (정수, 필수): 규칙의 시트 ID입니다.
  • sortRange: 범위의 데이터를 정렬합니다. 스키마:
  • range (객체, 필수): 정렬할 그리드 범위입니다.
  • sortSpecs (SortSpec 배열, 필수): 정렬 사양 ([{"dimensionIndex": int, "sortOrder": "ASCENDING"|"DESCENDING"}])입니다.
  • setDataValidation: 하나 이상의 셀에 데이터 검증을 설정합니다. 스키마:
  • range (객체, 필수): 그리드 범위입니다.
  • rule (객체, 선택사항): 유효성 검사 규칙 ({"condition": {"type": "ONE_OF_LIST"|"NUMBER_BETWEEN"|..., "values": [{"userEnteredValue": string}]}, "strict": bool, "showCustomUi": bool})입니다. 생략하면 유효성 검사가 삭제됩니다.
  • setBasicFilter: 시트에 기본 필터를 설정합니다. 스키마:
  • filter (객체, 필수): 기본 필터 정의 ({"range": GridRange, "criteria": map, "sortSpecs": list})입니다.
  • addProtectedRange: 보호된 범위를 추가합니다. 스키마:
  • protectedRange (객체, 필수): 보호된 범위 정의 ({"range": GridRange, "description": string, "warningOnly": bool, "editors": {"users": [string]}})입니다.
  • updateProtectedRange: 보호된 범위를 업데이트합니다. 스키마:
  • protectedRange (객체, 필수): protectedRangeId가 있는 보호된 범위 정의입니다.
  • fields (문자열, 필수): 필드 마스크 (예: "description,warningOnly" 또는 "*")
  • deleteProtectedRange: 보호된 범위를 삭제합니다. 스키마:
  • protectedRangeId (정수, 필수): 삭제할 보호된 범위의 ID입니다.
  • autoResizeDimensions: 셀 콘텐츠를 기반으로 하나 이상의 측정기준 크기를 자동으로 조절합니다. 스키마:
  • dimensions (객체, 필수): 측정기준 범위 ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int})입니다.
  • addChart: 차트를 추가합니다. 스키마:
  • chart (객체, 필수): 차트 정의 ({"spec": {"title": string, "basicChart": {"chartType": "COLUMN"|"BAR"|"LINE"|"PIE"|"COMBO"|"SCATTER", "legendPosition": string, "axis": list, "domains": list, "series": list}}, "position": {"overlayPosition": {"anchorCell": {"sheetId": int, "rowIndex": int, "columnIndex": int}}}})입니다.
  • updateChartSpec: 차트의 사양을 업데이트합니다. 스키마:
  • chartId (정수, 필수): 차트의 ID입니다.
  • spec (객체, 필수): 새 차트 사양입니다.
  • updateBanding: 줄무늬 범위를 업데이트합니다. 스키마:
  • bandedRange (객체, 필수): bandedRangeId가 있는 밴드 범위 정의입니다.
  • fields (문자열, 필수): 필드 마스크입니다.
  • addBanding: 새 줄무늬 범위를 추가합니다. 스키마:
  • bandedRange (객체, 필수): 밴드 범위 정의 ({"range": GridRange, "rowProperties": {"headerColorStyle": ColorStyle, "firstBandColorStyle": ColorStyle, "secondBandColorStyle": ColorStyle}})입니다.
  • deleteBanding: 줄무늬 범위를 삭제합니다. 스키마:
  • bandedRangeId (정수, 필수): 삭제할 밴드 범위의 ID입니다.
  • createDeveloperMetadata: 새 개발자 메타데이터를 만듭니다. 스키마:
  • developerMetadata (객체, 필수): 메타데이터 정의 ({"metadataKey": string, "metadataValue": string, "location": {"locationType": "ROW"|"COLUMN"|"SHEET"|"SPREADSHEET", "sheetId": int}, "visibility": "DOCUMENT"|"PROJECT"})입니다.
  • updateDeveloperMetadata: 기존 개발자 메타데이터 항목을 업데이트합니다. 스키마:
  • dataFilters (DataFilter 배열, 필수): 메타데이터를 선택하는 필터입니다.
  • developerMetadata (객체, 필수): 업데이트된 메타데이터 값입니다.
  • fields (문자열, 필수): 필드 마스크입니다.
  • deleteDeveloperMetadata: 개발자 메타데이터를 삭제합니다. 스키마:
  • dataFilter (객체, 필수): 삭제할 메타데이터의 기준을 설명하는 필터입니다.
  • randomizeRange: 범위에 있는 행의 순서를 무작위로 지정합니다. 스키마:
  • range (객체, 필수): 무작위로 지정할 그리드 범위입니다.
  • addDimensionGroup: 지정된 범위에 그룹을 만듭니다. 스키마:
  • range (객체, 필수): 그룹화할 측정기준 범위 ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int})입니다.
  • deleteDimensionGroup: 지정된 범위의 그룹을 삭제합니다. 스키마:
  • range (객체, 필수): 삭제할 그룹의 측정기준 범위입니다.
  • updateDimensionGroup: 지정된 그룹의 상태를 업데이트합니다. 스키마:
  • dimensionGroup (객체, 필수): 그룹 정의 ({"range": DimensionRange, "depth": int, "collapsed": bool})입니다.
  • fields (문자열, 필수): 필드 마스크 (예: "collapsed")
  • trimWhitespace: 셀에서 공백 (예: 공백, 탭, 새 줄)을 자릅니다. 스키마:
  • range (객체, 필수): 셀을 자를 그리드 범위입니다.
  • deleteDuplicates: 셀 범위의 지정된 열에 중복 값이 포함된 행을 삭제합니다. 스키마:
  • range (객체, 필수): 중복 항목을 삭제할 그리드 범위입니다.
  • comparisonColumns (DimensionRange 배열, 선택사항): 분석할 특정 열입니다.
  • updateEmbeddedObjectBorder: 삽입된 객체의 테두리를 업데이트합니다. 스키마:
  • objectId (정수, 필수): 삽입된 객체의 ID입니다.
  • border (객체, 필수): 테두리 정의 ({"colorStyle": ColorStyle, "section": "ALL"})입니다.
  • fields (문자열, 필수): 필드 마스크입니다.
  • addSlicer: 슬라이서를 추가합니다. 스키마:
  • slicer (객체, 필수): 슬라이서 정의 ({"spec": {"dataRange": GridRange, "columnIndex": int, "title": string}, "position": {"overlayPosition": {"anchorCell": {"sheetId": int, "rowIndex": int, "columnIndex": int}}}})입니다.
  • updateSlicerSpec: 슬라이서의 사양을 업데이트합니다. 스키마:
  • slicerId (정수, 필수): 슬라이서의 ID입니다.
  • spec (객체, 필수): 새 슬라이서 사양입니다.
  • fields (문자열, 필수): 필드 마스크입니다.
  • addDataSource: 데이터 소스를 추가합니다. 스키마:
  • dataSource (객체, 필수): 데이터 소스 정의 ({"spec": {"bigQuery": {"projectId": string, "query": string}}})입니다.
  • updateDataSource: 데이터 소스를 업데이트합니다. 스키마:
  • dataSource (객체, 필수): dataSourceId가 있는 데이터 소스 정의입니다.
  • fields (문자열, 필수): 필드 마스크입니다.
  • deleteDataSource: 데이터 소스를 삭제합니다. 스키마:
  • dataSourceId (문자열, 필수): 삭제할 데이터 소스의 ID입니다.
  • refreshDataSource: 하나 이상의 데이터 소스 및 연결된 dbobject를 새로고침합니다. 스키마:
  • dataSourceId (문자열, 선택사항) 또는 isAll (불리언, 선택사항) 또는 references (객체, 선택사항)
  • force (불리언, 선택사항): 강제 새로고침 여부입니다.
  • cancelDataSourceRefresh: 하나 이상의 데이터 소스 및 연결된 dbobject의 새로고침을 취소합니다. 스키마:
  • dataSourceId (문자열, 선택사항) 또는 isAll (불리언, 선택사항) 또는 references (객체, 선택사항)
  • addTable: 표를 추가합니다. 스키마:
  • table (객체, 필수): 테이블 정의 ({"range": GridRange, "name": string, "hasHeaderRow": bool, "hasTotalsRow": bool})입니다.
  • updateTable: 테이블을 업데이트합니다. 스키마:
  • table (객체, 필수): tableId가 있는 테이블 정의입니다.
  • fields (문자열, 필수): 필드 마스크입니다.
  • deleteTable: 테이블 삭제 요청입니다. 스키마:
  • tableId (문자열, 필수): 삭제할 테이블의 ID입니다.
  • insertComment: 스프레드시트에 댓글을 삽입합니다. 스키마:
  • content (문자열, 필수): 일반 텍스트 댓글 콘텐츠입니다.
  • coordinate (객체, 필수): 댓글을 고정할 시트의 그리드 좌표입니다.
    • sheetId (정수, 필수): 시트 ID입니다.
    • rowIndex (정수, 필수): 0부터 시작하는 행 색인입니다.
    • columnIndex (정수, 필수): 0부터 시작하는 열 색인입니다.
  • assigneeEmailAddress (문자열, 선택사항): 댓글 담당자의 이메일 주소입니다.
  • addCommentReply: 기존 댓글 대화목록에 답글을 추가합니다. 대화목록을 해결하거나 다시 여는 데도 사용됩니다. 스키마:
  • commentId (문자열, 필수): 댓글 대화목록의 ID입니다.
  • post (객체, 필수):
    • content (문자열, commentAction이 RESOLVE 또는 REOPEN이 아닌 경우 필수): 답글 게시물의 일반 텍스트 콘텐츠입니다.
    • commentAction (문자열, 선택사항): 이 답글에 취한 조치 ("RESOLVE" 또는 "REOPEN")입니다.
    • assigneeEmail (문자열, 선택사항): 대화를 새로 할당할 이메일 주소입니다.
  • updateCommentPost: 댓글 대화목록에서 댓글 게시물의 콘텐츠를 업데이트합니다. 스키마:
  • commentId (문자열, 필수): 댓글 대화목록의 ID입니다.
  • postId (문자열, 필수): 업데이트할 댓글 게시물의 ID입니다.
  • content (문자열, 필수): 댓글 게시물의 업데이트된 콘텐츠입니다.
  • deleteComment: 댓글 대화목록을 삭제합니다. 스키마:
  • commentId (문자열, 필수): 삭제할 댓글 대화목록의 ID입니다.
  • deleteCommentReply: 답글 게시물을 삭제합니다. 스키마:
  • commentId (문자열, 필수): 댓글 대화목록의 ID입니다.
  • postId (문자열, 필수): 삭제할 답글 게시물의 ID입니다.

다음 코드 샘플은 curl를 사용하여 update_spreadsheet MCP 도구를 호출하는 방법을 보여줍니다.

curl 요청 
curl --location 'https://sheetsmcp.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": "update_spreadsheet",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

UpdateContentRequest

JSON 표현 
{
  "spreadsheetId": string,
  "requests": [
    {
      object
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
필드
spreadsheetId

string

필수 항목입니다. 업데이트할 스프레드시트의 ID입니다.
requests[]

object (Struct format)

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

object (WriteControl)

선택사항입니다. 쓰기 요청이 실행되는 방식을 제어합니다.

구조체

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)

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

WriteControl

JSON 표현 
{

  "requiredRevisionId": string
}
필드
통합 필드 control. 쓸 스프레드시트의 버전을 결정하고 해당 버전이 스프레드시트의 현재 버전이 아닌 경우 요청이 어떻게 작동해야 하는지 결정합니다. control은 다음 중 하나여야 합니다.
requiredRevisionId

string

쓰기 요청이 적용될 스프레드시트의 버전 ID입니다. 문서의 최신 버전이 아닌 경우 요청이 처리되지 않고 400 잘못된 요청 오류가 반환됩니다.

필수 버전 ID가 응답에 반환되면 요청이 적용된 후 스프레드시트의 버전 ID를 나타냅니다.

NullValue

JSON null을 나타냅니다.

NullValue는 센티널로, 값이 하나만 있는 enum을 사용하여 Value 유형 공용체의 null 값을 나타냅니다.

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

열거형
NULL_VALUE null 값입니다.

출력 스키마

UpdateContentResponse

JSON 표현 
{
  "content": {
    object
  }
}
필드
content

object (Struct format)

Sheets API의 JSON 형식으로 된 spreadsheets.batchUpdate 응답과 status 필드입니다.

구조체

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는 센티널로, 값이 하나만 있는 enum을 사용하여 Value 유형 공용체의 null 값을 나타냅니다.

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

열거형
NULL_VALUE null 값입니다.

도구 주석

도구 주석은 MCP 클라이언트에 전송되어 특정 도구의 기본 위험을 설명합니다. 대부분의 클라이언트는 이러한 힌트를 신뢰할 수 없는 것으로 취급하지만, 확인 메시지가 사용자에게 전송될 수 있는 시점을 결정하는 데 사용할 수 있습니다.

제목 문자열과 함께 다음 불리언 힌트가 정의됩니다.

  • readOnlyHint: true인 경우 도구가 환경을 수정하지 않습니다. 기본값: false.
  • destructiveHint: true인 경우 도구에서 파괴적인 작업을 수행할 수 있습니다. false이면 도구는 추가 작업만 수행할 수 있습니다. 기본값은 true입니다.
  • idempotentHint: true인 경우 동일한 인수로 도구를 반복적으로 호출해도 환경에 추가적인 영향을 미치지 않습니다. 기본값: false.
  • openWorldHint: true인 경우 도구는 외부 항목의 '오픈 월드'와 상호작용할 수 있습니다. false이면 도구는 내부 항목과만 상호작용할 수 있습니다. 예를 들어 웹 검색 도구는 오픈 월드이지만 메모리 도구는 오픈 월드가 아닙니다.

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ✅

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets