셀에 포함된 값 데이터 외에도 스프레드시트에는 다음과 같은 다른 유형의 데이터가 많이 포함되어 있습니다.
- 측정기준
- 셀 형식 및 테두리
- 이름이 지정된 범위
- 보호된 범위
- 조건부 서식
다음은 스프레드시트의 모양과 작동을 제어하는 여러 종류의 데이터 중 일부입니다. spreadsheets.batchUpdate
메서드를 사용하면 이러한 스프레드시트 세부정보를 업데이트할 수 있습니다. 변경사항은 일괄적으로 그룹화되므로 하나의 요청이 실패하면 다른 (잠재적으로 종속된) 변경사항은 모두 작성되지 않습니다.
이 페이지에서는 spreadsheets.batchUpdate
메서드 사용의 기본사항을 설명합니다. 셀 값 데이터를 읽고 써야 하는 경우 셀 값 읽기 및 쓰기에 설명된 spreadsheets.values
리소스를 사용할 수도 있습니다.
작업 카테고리
spreadsheets.batchUpdate
에서 지원하는 특정 작업은 다음과 같은 광범위한 카테고리로 그룹화할 수 있습니다.
카테고리 | 설명 |
---|---|
추가 (및 복제) | 새 객체를 추가합니다 (중복 요청의 경우 이전 객체를 기반으로 할 수도 있음). |
업데이트 (및 설정) | 일반적으로 이전 속성을 그대로 두고 객체의 특정 속성을 업데이트합니다 (Set 요청은 이전 데이터를 덮어씁니다). |
삭제 | 객체를 삭제합니다. |
이러한 카테고리는 다음 섹션에서 특정 작업의 동작을 설명하는 데 사용됩니다.
일괄 업데이트 작업
spreadsheets.batchUpdate
메서드는 하나 이상의 Request 객체를 사용하여 작동하며, 각 객체는 실행할 단일 종류의 요청을 지정합니다. 요청에는 여러 가지 유형이 있습니다. 다음은 요청 유형을 다양한 카테고리로 분류한 내용입니다.
데이터 조작을 위한 사용자 작업을 모방하는 추가 요청도 있습니다.
- AutoFillRequest
- CutPasteRequest
- CopyPasteRequest
- FindReplaceRequest
- PasteDataRequest
- TextToColumnsRequest
- SortRangeRequest
한도
Google Sheets의 셀 및 행 한도에 관해 자세히 알아보려면 Google Drive에 저장할 수 있는 파일을 참고하세요.
필드 마스크
많은 '업데이트' 요청에는 필드 마스크가 필요합니다. 쉼표로 구분된 필드 목록으로, 다른 필드는 변경하지 않고 객체의 특정 필드만 업데이트합니다. 필드 마스크 *
는 와일드 카드처럼 처리되며 메시지의 모든 필드를 지정하는 방법의 약어입니다. 즉, 요청에서 필드 값을 지정하지 않으면 필드가 기본 상태로 되돌아갈 수 있습니다.
필드 마스크에 대한 자세한 내용은 필드 마스크 사용을 참고하세요.
다음 샘플에서는 UpdateSpreadsheetPropertiesRequest
를 사용하여 스프레드시트의 제목만 업데이트합니다.
요청:
POST .../v4/spreadsheets/spreadsheetId:batchUpdate
요청 본문:
{
"requests": [{
"updateSpreadsheetProperties": {
"properties": {"title": "TITLE"},
"fields": "title"
}
}]
}
TITLE을 스프레드시트의 새 제목으로 바꿉니다.
대답
스프레드시트를 업데이트할 때 일부 유형의 요청은 응답을 반환할 수 있습니다. 이러한 응답은 배열로 반환되며 각 응답은 해당 요청과 동일한 색인을 차지합니다. 일부 요청에는 응답이 없으며 이러한 요청의 응답은 비어 있습니다.
일반적으로 '추가' 요청에는 추가된 객체의 ID와 같은 정보를 반환하는 응답이 있습니다. 지원되는 응답 목록은 응답을 참고하세요.
예
다음 코드 샘플은 다음 작업을 실행합니다.
title
변수를 사용하여 스프레드시트의 제목을 업데이트합니다.find
및replacement
변수를 사용하여 스프레드시트에서 셀 값을 찾아 바꿉니다.