Google Sheets API를 사용하면 스프레드시트 내에서 행과 열을 추가, 삭제 및 조작할 수 할 수 있습니다. 이 페이지의 예는 몇 가지 일반적인 행과 열이 어떻게 Sheets API를 사용하여 수행할 수 있습니다.
이 예는 언어적 표현인 HTTP 요청의 형식으로 중립적입니다. 다음을 사용하여 다양한 언어로 일괄 업데이트를 구현하는 방법을 알아봅니다. 자세한 내용은 업데이트 스프레드시트를 사용합니다.
이 예에서 SPREADSHEET_ID
및 SHEET_ID
자리표시자는
는 해당 ID를 제공할 위치를 나타냅니다. 스프레드시트
ID를 입력합니다. 얻을 수 있는 혜택
시트 ID를
spreadsheets.get
메서드를 사용하여 지도 가장자리에
패딩을 추가할 수 있습니다. 이
A1 표기법을 사용하여 범위를 지정합니다.
예시 범위는 Sheet1!A1:D5입니다.
열 너비 또는 행 높이 조정
다음
spreadsheets.batchUpdate
드림
코드 샘플을 사용하여
UpdateDimensionPropertiesRequest
를 눌러 A열의 너비 속성을 160픽셀로 업데이트합니다. 두 번째 요청은
첫 3행의 행 높이 속성을 40픽셀로 설정합니다. dimension
필드는 연산이 표의 열 또는 행에 적용되는지 여부를 결정합니다.
시트입니다.
요청 프로토콜은 아래와 같습니다.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "updateDimensionProperties": { "range": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "startIndex": 0, "endIndex": 1 }, "properties": { "pixelSize": 160 }, "fields": "pixelSize" } }, { "updateDimensionProperties": { "range": { "sheetId":SHEET_ID
, "dimension": "ROWS", "startIndex": 0, "endIndex": 3 }, "properties": { "pixelSize": 40 }, "fields": "pixelSize" } } ] }
빈 행 또는 열 추가
다음
spreadsheets.batchUpdate
드림
코드 샘플을 사용하여
AppendDimensionRequest
행과 열을 추가합니다. 첫 번째 요청은 세 개의 빈 행을
두 번째는 빈 열 하나를 추가합니다. dimension
필드는 연산이 표의 열 또는 행에 적용되는지 여부를 결정합니다.
시트입니다.
요청 프로토콜은 아래와 같습니다.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "appendDimension": { "sheetId":SHEET_ID
, "dimension": "ROWS", "length": 3 } }, { "appendDimension": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "length": 1 } } ] }
자동으로 열 크기 조정
다음
spreadsheets.batchUpdate
드림
코드 샘플을 사용하여
AutoResizeDimensionsRequest
열 콘텐츠의 크기에 따라 열 A:C의 크기를 조절합니다. dimension
필드는 작업이 시트의 열에 적용된다는 것을 나타냅니다.
요청 프로토콜은 아래와 같습니다.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID
,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}
자동으로 행 크기 조정
다음
spreadsheets.batchUpdate
드림
코드 샘플을 사용하여
AutoResizeDimensionsRequest
처음 세 행의 행 높이를 지웁니다. 그러면 행 높이가
각 행의 셀 내용에 따라 동적으로 생성됩니다. dimension
필드는 작업이 시트의 행에 적용된다는 것을 나타냅니다.
요청 프로토콜은 아래와 같습니다.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID
,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}
행 또는 열 삭제
다음
spreadsheets.batchUpdate
드림
코드 샘플을 사용하여
DeleteDimensionRequest
시트의 처음 세 행을 삭제합니다. 두 번째 요청은 B:D 열을 삭제합니다.
dimension
필드는 작업을 열에 적용할지 아니면 다음 열에 적용할지를 결정합니다.
행입니다.
요청 프로토콜은 아래와 같습니다.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "deleteDimension": { "range": { "sheetId":SHEET_ID
, "dimension": "ROWS", "startIndex": 0, "endIndex": 3 } } }, { "deleteDimension": { "range": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "startIndex": 1, "endIndex": 4 } } }, ], }
빈 행 또는 열 삽입
다음
spreadsheets.batchUpdate
드림
코드 샘플을 사용하여
InsertDimensionRequest
특정 색인에 열이나 행을 삽입 (예: 빈 행 앞에 추가)
를 클릭합니다. 첫 번째 요청은 C열에 빈 열 두 개를 삽입합니다.
두 번째 요청은 1행부터 시작하여 세 개의 빈 행을 삽입합니다.
dimension
필드는 작업을 열에 적용할지 아니면 다음 열에 적용할지를 결정합니다.
행입니다.
true인 경우 inheritFromBefore
필드는 Sheets API에 다음을 제공하도록 지시합니다.
새 열이나 행에 이전 행 또는 열과 동일한 속성이 있으며
false로 설정하여 새 열 또는 행 다음의 측정기준에서 상속합니다.
inheritFromBefore
은 1행에 행을 삽입하거나
A열을 참조하세요.
요청 프로토콜은 아래와 같습니다.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "insertDimension": { "range": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "startIndex": 2, "endIndex": 4 }, "inheritFromBefore": true } }, { "insertDimension": { "range": { "sheetId":SHEET_ID
, "dimension": "ROWS", "startIndex": 0, "endIndex": 3 }, "inheritFromBefore": false } }, ], }
행 또는 열 이동
다음
spreadsheets.batchUpdate
드림
코드 샘플을 사용하여
MoveDimensionRequest
A열을 D열 위치로 이동합니다. 두 번째 요청은 행을 이동함
행 20 위치까지 5~10개
dimension
필드는 작업을 열에 적용할지 아니면 다음 열에 적용할지를 결정합니다.
행입니다. destinationIndex
필드는
소스 데이터를 생성할 수 있습니다.
요청 프로토콜은 아래와 같습니다.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "moveDimension": { "source": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "startIndex": 0, "endIndex": 1 }, "destinationIndex": 3 } }, { "moveDimension": { "source": { "sheetId":SHEET_ID
, "dimension": "ROWS", "startIndex": 4, "endIndex": 10 }, "destinationIndex": 19 } }, ], }