Google Sheets API는 스프레드시트의 데이터를 읽고 수정할 수 있는 RESTful 인터페이스입니다. 이 API의 가장 일반적인 용도는 다음과 같습니다.
- 스프레드시트 만들기
- 스프레드시트 셀 값 읽기 및 쓰기
- 스프레드시트 서식 업데이트
- 연결된 시트 관리
다음은 Sheets API에서 사용되는 일반적인 용어 목록입니다.
- 스프레드시트
여러 시트를 포함할 수 있는 Google 스프레드시트의 기본 객체로, 각 시트에는 셀에 구조화된 정보가 포함되어 있습니다. 스프레드시트 리소스는 모든 스프레드시트를 나타내며 문자, 숫자, 하이픈, 밑줄이 포함된 고유한
spreadsheetId값을 갖습니다. Google Sheets URL에서 스프레드시트 ID를 확인할 수 있습니다.https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0- 시트
스프레드시트 내의 페이지 또는 탭입니다. 시트 리소스는 각 시트를 나타내며 고유한 제목과 숫자
sheetId값을 가집니다. Google Sheets URL에서 시트 ID를 찾을 수 있습니다.https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId- 셀
시트 내의 텍스트 또는 데이터 개별 입력란입니다. 셀은 행과 열로 정렬되며 셀 범위로 그룹화할 수 있습니다. CellData 리소스는 각 셀을 나타내지만 고유 ID 값은 없습니다. 대신 행과 열 좌표가 셀을 식별합니다.
- A1 표기법
시트 이름, 열 문자 및 행 번호를 사용하는 시작 및 끝 셀 좌표를 포함하는 문자열로 셀 또는 셀 범위를 정의하는 데 사용되는 구문입니다. 이 방법은 셀의 절대 범위를 참조할 때 가장 일반적이고 유용합니다.
예시 표시
Sheet1!A1:B2은 Sheet1의 상위 두 행에 있는 처음 두 셀을 나타냅니다.Sheet1!A:A은 Sheet1의 첫 번째 열에 있는 모든 셀을 나타냅니다.Sheet1!1:2은 Sheet1의 처음 두 행에 있는 모든 셀을 참조합니다.Sheet1!A5:A은 5행 이후 시트 1의 첫 번째 열에 있는 모든 셀을 나타냅니다.A1:B2은 표시되는 첫 번째 시트의 상위 두 행에 있는 처음 두 셀을 나타냅니다.Sheet1은 Sheet1의 모든 셀을 나타냅니다.'My Custom Sheet'!A:A은 'My Custom Sheet'이라는 시트의 첫 번째 열에 있는 모든 셀을 참조합니다. 공백, 특수문자 또는 영숫자 조합이 포함된 시트 이름에는 작은따옴표가 필요합니다.'My Custom Sheet'은 'My Custom Sheet'(내 맞춤 시트)의 모든 셀을 나타냅니다.
도움말: 가능하면 스프레드시트 내에서 각 객체의 고유한 이름을 사용하세요. 예를 들어 A1은 첫 번째로 표시되는 시트의 A1 셀을 참조하고 'A1'은 시트 A1이라는 이름의 모든 셀을 나타냅니다. 마찬가지로 Sheet1은 Sheet1의 모든 셀을 참조합니다. 하지만 'Sheet1'이라는 이름이 지정된 범위가 있는 경우 Sheet1은 이름이 지정된 범위를 나타내고 'Sheet1'은 시트를 나타냅니다.
- R1C1 표기법
시트 이름과 행 번호 및 열 번호를 사용하는 시작 및 끝 셀 좌표를 포함하는 문자열로 셀 또는 셀 범위를 정의하는 데 사용되는 구문입니다. 이 방법은 A1 표기법보다 일반적이지는 않지만 주어진 셀 위치를 기준으로 셀 범위를 참조할 때 유용합니다.
예시 표시
Sheet1!R1C1:R2C2은 Sheet1의 상위 두 행에 있는 처음 두 셀을 나타냅니다.R1C1:R2C2은 표시되는 첫 번째 시트의 상위 두 행에 있는 처음 두 셀을 나타냅니다.Sheet1!R[3]C[1]은 현재 셀의 아래 3개 행과 오른쪽에 한 열인 셀을 나타냅니다.
- 이름이 지정된 범위
애플리케이션 전체의 참조를 단순화하기 위해 커스텀 이름이 있는 정의된 셀 또는 셀 범위 FilterView 리소스는 이름이 지정된 범위를 나타냅니다.
- 보호된 범위
수정할 수 없는 정의된 셀 또는 셀 범위입니다. ProtectedRange 리소스는 보호된 범위를 나타냅니다.
다음 단계
인증 및 승인 처리를 비롯하여 Google Workspace API를 사용한 개발 방법을 알아보려면 Google Workspace에서 개발을 참조하세요.
간단한 Sheets API 앱을 구성하고 실행하는 방법은 빠른 시작 개요를 참조하세요.