스프레드시트 업데이트 (original) (raw)
다음은 스프레드시트의 모양과 작동을 제어하는 여러 종류의 데이터 중 일부입니다. spreadsheets.batchUpdate 메서드를 사용하면 이러한 스프레드시트 세부정보를 업데이트할 수 있습니다. 변경사항은 일괄적으로 그룹화되므로 한 요청이 실패하면 다른 (잠재적으로 종속된) 변경사항은 모두 작성되지 않습니다.
spreadsheets.batchUpdate에서 지원하는 특정 작업은 다음과 같은 광범위한 카테고리로 그룹화할 수 있습니다.
이러한 카테고리는 다음 섹션에서 특정 작업의 동작을 설명하는 데 사용됩니다.
spreadsheets.batchUpdate 메서드는 하나 이상의 Request 객체를 사용하여 작동하며, 각 객체는 실행할 단일 종류의 요청을 지정합니다. 요청에는 여러 가지 유형이 있습니다. 다음은 요청 유형을 다양한 카테고리로 분류한 것입니다.
데이터 조작을 위한 사용자 작업을 모방하는 추가 요청도 있습니다.
많은 '업데이트' 요청에는 필드 마스크가 필요합니다. 쉼표로 구분된 필드 목록으로, 다른 필드는 변경하지 않고 객체의 특정 필드만 업데이트합니다. 필드 마스크 *는 와일드 카드처럼 처리되며 메시지의 모든 필드를 지정하는 방법입니다. 즉, 요청에서 필드 값을 지정하지 않으면 필드가 기본 상태로 되돌아갈 수 있습니다. 필드 마스크에 대한 자세한 내용은 필드 마스크 사용을 참고하세요.
TITLE을 스프레드시트의 새 제목으로 바꿉니다.
스프레드시트를 업데이트할 때 일부 유형의 요청은 응답을 반환할 수 있습니다. 이러한 응답은 배열로 반환되며 각 응답은 해당 요청과 동일한 색인을 차지합니다. 일부 요청에는 응답이 없으며 이러한 요청의 응답은 비어 있습니다.
다음 코드 샘플은 다음 작업을 실행합니다.