Google Sheets API를 사용하여 셀 및 범위의 서식을 업데이트할 수 있습니다. 할 수 있습니다. 이 페이지의 예는 몇 가지 일반적인 서식 지정 작업은 Sheets API를 사용하여 수행할 수 있습니다. 다음을 수행할 수 있습니다. 더 많은 조건부 서식의 예는 조건부 서식 지정 레시피 페이지를 참조하세요.
스프레드시트를 업데이트할 때 일부 요청 유형은 응답을 반환할 수 있습니다.
배열로 반환되며 각 응답은
확인할 수 있습니다. 일부 요청에는 응답이 없고
비어 있습니다. 이러한 예에 대한 응답 구조는
spreadsheets.batchUpdate
이 예는 언어적 표현인 HTTP 요청의 형식으로 중립적입니다. 다음을 사용하여 다양한 언어로 일괄 업데이트를 구현하는 방법을 알아봅니다. 자세한 내용은 업데이트 스프레드시트를 사용합니다.
이 예에서 SPREADSHEET_ID 및 SHEET_ID 자리표시자는
는 해당 ID를 제공할 위치를 나타냅니다. 스프레드시트
ID를 입력합니다. 얻을 수 있는 혜택
시트 ID를
spreadsheets.get
메서드를 사용하여 지도 가장자리에
패딩을 추가할 수 있습니다. 이
A1 표기법을 사용하여 범위를 지정합니다.
예시 범위는 Sheet1!A1:D5입니다.
위의 비디오에서는 다양한 방법으로 스프레드시트 셀 서식을 지정하는 방법을 배웁니다. 여기에는 고정된 행 만들기, 셀을 굵게 표시, 통화 구현 등이 포함됩니다. 서식 지정, 셀 유효성 검사 수행, 셀 값 제한 등입니다.
셀 테두리 수정
다음
spreadsheets.batchUpdate
드림
코드 샘플을 사용하여
UpdateBordersRequest
를 사용하여 A1:F10 범위의 각 셀에 파란 점선의 위쪽과 아래쪽 테두리를 지정합니다. 이
innerHorizontal
필드는 범위 내부에 가로 테두리를 만듭니다.
필드를 생략하면 테두리가 상단에만 추가되고
전체 범위의 맨 아래에 있습니다.
요청 프로토콜은 아래와 같습니다.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{ "requests": [ { "updateBorders": { "range": { "sheetId": SHEET_ID, "startRowIndex": 0, "endRowIndex": 10, "startColumnIndex": 0, "endColumnIndex": 6 }, "top": { "style": "DASHED", "width": 1, "color": { "blue": 1.0 }, }, "bottom": { "style": "DASHED", "width": 1, "color": { "blue": 1.0 }, }, "innerHorizontal": { "style": "DASHED", "width": 1, "color": { "blue": 1.0 }, }, } } ] }
헤더 행 서식 지정
다음
spreadsheets.batchUpdate
드림
코드 샘플을 사용하여
RepeatCellRequest
시트의 헤더 행의 서식을 지정합니다. 첫 번째 요청은 텍스트 색상을 업데이트하고,
배경 색상, 텍스트 글꼴 크기, 텍스트 정렬을 조정하여
텍스트를 굵게 표시합니다. range
필드에서 열 색인을 생략하면
행을 포맷합니다. 두 번째 요청은
헤더 행이 고정되었습니다.
요청 프로토콜은 아래와 같습니다.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{ "requests": [ { "repeatCell": { "range": { "sheetId": SHEET_ID, "startRowIndex": 0, "endRowIndex": 1 }, "cell": { "userEnteredFormat": { "backgroundColor": { "red": 0.0, "green": 0.0, "blue": 0.0 }, "horizontalAlignment" : "CENTER", "textFormat": { "foregroundColor": { "red": 1.0, "green": 1.0, "blue": 1.0 }, "fontSize": 12, "bold": true } } }, "fields": "userEnteredFormat(backgroundColor,textFormat,horizontalAlignment)" } }, { "updateSheetProperties": { "properties": { "sheetId": SHEET_ID, "gridProperties": { "frozenRowCount": 1 } }, "fields": "gridProperties.frozenRowCount" } } ] }
셀 병합
다음
spreadsheets.batchUpdate
드림
코드 샘플을 사용하여
MergeCellsRequest
셀을 병합하세요. 첫 번째 요청은 A1:B2 범위를 단일 셀로 병합합니다. 이
두 번째 요청은 A3:B6의 열을 병합하고 행은 그대로 둡니다.
요청 프로토콜은 아래와 같습니다.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{ "requests": [ { "mergeCells": { "range": { "sheetId": SHEET_ID, "startRowIndex": 0, "endRowIndex": 2, "startColumnIndex": 0, "endColumnIndex": 2 }, "mergeType": "MERGE_ALL" } }, { "mergeCells": { "range": { "sheetId": SHEET_ID, "startRowIndex": 2, "endRowIndex": 6, "startColumnIndex": 0, "endColumnIndex": 2 }, "mergeType": "MERGE_COLUMNS" } }, ] }
범위의 맞춤 날짜/시간 또는 십진수 형식 설정
다음
spreadsheets.batchUpdate
드림
코드 샘플을 사용하여
RepeatCellRequest
맞춤 날짜/시간 및 숫자 서식을 갖도록 셀을 업데이트합니다. 첫 번째 요청은
이 경우 A1:A10 범위의 셀에 맞춤 날짜/시간 형식 hh:mm:ss am/pm,
ddd mmm dd yyyy
을 제공합니다. 이 형식의 날짜/시간 예는 '02:05:07 PM, Sun Apr
03 2016".
두 번째 요청은 B1:B10의 셀에 맞춤 숫자 형식을 지정합니다.
#,##0.0000
- 숫자를 쉼표로 그룹화해야 함을 나타냅니다.
구분자(예: 소수점 아래 4자리)가 있어야 하고
선행 0 1개를 삭제해야 합니다. 예를 들어 숫자 '3.14' 렌더링됩니다.
'3.1400', '12345.12345'로 표시됩니다. '12,345.1235'로 렌더링됩니다.
요청 프로토콜은 아래와 같습니다.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{ "requests": [ { "repeatCell": { "range": { "sheetId": SHEET_ID, "startRowIndex": 0, "endRowIndex": 10, "startColumnIndex": 0, "endColumnIndex": 1 }, "cell": { "userEnteredFormat": { "numberFormat": { "type": "DATE", "pattern": "hh:mm:ss am/pm, ddd mmm dd yyyy" } } }, "fields": "userEnteredFormat.numberFormat" } }, { "repeatCell": { "range": { "sheetId": SHEET_ID, "startRowIndex": 0, "endRowIndex": 10, "startColumnIndex": 1, "endColumnIndex": 2 }, "cell": { "userEnteredFormat": { "numberFormat": { "type": "NUMBER", "pattern": "#,##0.0000" } } }, "fields": "userEnteredFormat.numberFormat" } } ] }