Google Sheets API를 사용하면 스프레드시트 내에서 행과 열을 추가, 삭제 및 조작할 수 할 수 있습니다. 이 페이지의 예는 몇 가지 일반적인 행과 열이 어떻게 Sheets API를 사용하여 수행할 수 있습니다.
이 예는 언어적 표현인 HTTP 요청의 형식으로 중립적입니다. 다음을 사용하여 다양한 언어로 일괄 업데이트를 구현하는 방법을 알아봅니다. 자세한 내용은 업데이트 스프레드시트를 사용합니다.
이 예에서 SPREADSHEET_ID 및 SHEET_ID 자리표시자는
는 해당 ID를 제공할 위치를 나타냅니다. 스프레드시트
ID를 입력합니다. 얻을 수 있는 혜택
시트 ID를
spreadsheets.get 메서드를 사용하여 지도 가장자리에
패딩을 추가할 수 있습니다. 이
A1 표기법을 사용하여 범위를 지정합니다.
예시 범위는 Sheet1!A1:D5입니다.
열 너비 또는 행 높이 조정
다음
spreadsheets.batchUpdate
코드 샘플을 사용하여
UpdateDimensionPropertiesRequest
를 눌러 A열의 너비 속성을 160픽셀로 업데이트합니다. 두 번째 요청은
처음 세 행의 행 높이 속성을 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
}
},
],
}