MCP Tools Reference: sheetsmcp.googleapis.com

도구: insert_dimension

특정 색인에서 시트에 행 또는 열을 삽입합니다. spreadsheets.batchUpdate REST API의 InsertDimensionRequest에 해당합니다. https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request

다음 샘플에서는 curl을 사용하여 insert_dimension MCP 도구를 호출하는 방법을 보여줍니다.

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

입력 스키마

InsertDimensionRequest

JSON 표현 
{
  "spreadsheetId": string,
  "sheetId": integer,
  "dimension": enum (Dimension),
  "startIndex": integer,
  "endIndex": integer,
  "inheritFromBefore": boolean
}
필드
spreadsheetId

string

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

integer

필수 항목입니다. 삽입할 시트의 ID입니다.
dimension

enum (Dimension)

필수 항목입니다. 삽입할 측정기준입니다.
startIndex

integer

필수 항목입니다. 삽입의 0부터 시작하는 시작 색인입니다 (포함).
endIndex

integer

필수 항목입니다. 삽입의 0부터 시작하는 종료 색인입니다 (제외).
inheritFromBefore

boolean

측정기준 속성을 새로 삽입된 측정기준 전후의 측정기준에서 확장해야 하는지 여부입니다. 이전 측정기준에서 상속하려면 true (이 경우 시작 색인이 0보다 커야 함), 이후 측정기준에서 상속하려면 false입니다.

Dimension

작업을 적용해야 하는 측정기준을 나타냅니다.

열거형
DIMENSION_UNSPECIFIED 기본값이며 사용할 수 없습니다.
COLUMNS 시트의 열에서 작동합니다.
ROWS 시트의 행에서 작동합니다.

출력 스키마

JSON 객체를 나타냅니다.

JSON 객체의 의미를 완벽하게 캡처하기 위한 순서가 지정되지 않은 키-값 맵입니다. 이를 통해 임의의 JSON 페이로드를 ProtoJSON 형식의 메시지 필드로 파싱할 수 있습니다.

이는 상호 운용 가능한 JSON에 관한 RFC 8259 가이드라인을 따릅니다. 특히 JSON 형식은 일반적으로 숫자 유형에서 이러한 값을 지원하지 않으므로 이 유형은 큰 Int64 값 또는 NaN/Infinity 숫자를 나타낼 수 없습니다.

임의의 JSON을 메시지로 파싱하지 않으려면 이 유형을 사용하는 대신 맞춤 유형 메시지를 사용하는 것이 좋습니다.

구조체

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 불리언(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은 Value 유형 통합의 null 값을 나타내기 위해 값이 하나만 있는 열거형을 사용하는 센티널입니다.

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

열거형
NULL_VALUE Null 값입니다.

도구 주석

파괴적 힌트: ❌ | 멱등성 힌트: ❌ | 읽기 전용 힌트: ❌ | 열린 세상 힌트: ✅