셀에 포함된 값 데이터 외에도 스프레드시트에는 여러 다른 유형의 다음과 같은 데이터가 포함됩니다.
- 크기
- 셀 서식 및 테두리
- 이름이 지정된 범위
- 보호된 범위
- 조건부 서식
이것들은 모양과 표시의 모양과 스펙트럼을 제어하는
스프레드시트 연산입니다. spreadsheets.batchUpdate
메서드를 사용하면
스프레드시트 세부정보를 업데이트할 수 있습니다. 변경사항은 일괄로 그룹화되므로
한 요청이 실패하면 다른 요청은 실패 (의존적일 수 있음)
변경사항을 기록합니다
이 페이지에서는
spreadsheets.batchUpdate
드림
메서드를 사용하여 축소하도록 요청합니다. 셀 값 데이터를 읽고 써야 하는 경우
spreadsheets.values
드림
자세한 내용은 도움말 및 셀 값 쓰기
작업 카테고리
spreadsheets.batchUpdate
에서 지원하는 특정 작업을 그룹화할 수 있음
다음과 같은 광범위한 카테고리로 분류할 수 있습니다.
카테고리 | 설명 |
---|---|
추가 (및 복제) | 새 객체를 추가합니다 (중복 요청에서처럼 이전 객체를 기준으로 하는 경우도 있음). |
Update (및 Set) | 객체의 특정 속성을 업데이트합니다. 일반적으로 이전 속성은 그대로 둡니다 (반면에 Set 요청은 이전 데이터를 덮어씁니다). |
삭제 | 객체를 삭제합니다. |
이러한 카테고리는 다음 섹션에서 실행할 수 있습니다
일괄 업데이트 작업
spreadsheets.batchUpdate
메서드는 하나 이상의
요청
각 객체는 수행할 단일 종류의 요청을 지정합니다. 현재
다양한 종류의 요청이 있습니다. 다음과 같이 요청 유형,
여러 카테고리로 그룹화할 수 있습니다
또한 사용자 동작을 모방하기 위한 몇 가지 추가 요청도 있습니다. 데이터:
- 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
변수