이 섹션에서는 Google Sheets API를 숙지하는 데 사용할 수 있는 codelab을 소개합니다. 또한 의도한 Google Sheets 작업을 API 요청으로 변환하는 방법을 보여주는 '레시피' 예시도 제공됩니다.
API를 사용하여 주어진 작업을 완료하는 방법은 여러 가지인 경우가 많습니다. 작업에 접근하는 방법을 결정할 때는 다음 사항에 유의하세요.
- 셀 값을 읽거나 써야 하는 경우
spreadsheets컬렉션보다spreadsheets.values컬렉션을 사용하는 것이 좋습니다. 전자의 인터페이스는 간단한 읽기/쓰기 작업에 더 쉽게 사용할 수 있습니다. 가능한 경우 일괄 메서드(
spreadsheet.batchUpdate,spreadsheet.values.batchGet,spreadsheet.values.batchUpdate)를 사용하여 여러 요청을 단일 메서드 호출로 번들링합니다. 이러한 일괄 처리 메서드를 사용하면 다음과 같은 이유로 효율성이 개선됩니다.- 클라이언트 HTTP 오버헤드를 줄입니다.
- 실행되는 쿼리 수를 줄입니다.
- 문서의 버전 수를 줄입니다.
- 배치의 모든 변경사항이 원자성을 갖도록 합니다.
레시피
이 섹션에 나열된 예에서는 Sheets의 일반적인 작업을 Sheets API v4 요청으로 표현하는 방법을 보여줍니다.
이러한 예는 언어에 구애받지 않도록 HTTP 요청의 형태로 제공됩니다. Google API 클라이언트 라이브러리를 사용하여 특정 언어로 Sheets API 요청 프로토콜을 구현하는 방법을 알아보려면 셀 값 읽기 및 쓰기 및 스프레드시트 업데이트 가이드를 참고하세요.
이 섹션의 레시피는 다음 카테고리로 나뉩니다.
- 기본 읽기 - 시트에서 값을 읽는 방법을 보여주는 레시피입니다.
- 기본 쓰기: 시트에 값을 쓰는 방법을 보여주는 레시피입니다.
- 기본 서식 지정 - 시트와 셀의 모양을 변경하는 방법을 보여주는 레시피입니다.
- 차트: 시트에서 차트를 만들고 변경하는 방법을 보여주는 레시피입니다.
- 조건부 서식: 조건에 따라 셀 모양을 변경하는 방법을 보여주는 레시피입니다.
- 데이터 작업: 스프레드시트에서 데이터를 만들고 이동하고 조작하는 방법을 보여주는 레시피입니다.
- 이름이 지정되고 보호된 범위 - 스프레드시트에서 이름이 지정되고 보호된 범위를 만들고, 업데이트하고, 삭제하는 방법을 보여주는 레시피입니다.
- 피벗 테이블: 시트에서 피벗 테이블을 만드는 방법을 보여주는 레시피입니다.
- 행 및 열 작업: 행과 열을 추가, 삭제, 이동하고 속성을 업데이트하는 방법을 보여주는 레시피입니다.
- 시트 작업 - 시트를 만들고, 지우고, 복사하고, 삭제하는 방법과 시트 속성을 제어하는 방법을 보여주는 레시피입니다.