Google Sheets API는 스프레드시트의 데이터를 읽고 수정할 수 있는 RESTful 인터페이스입니다. 이 API의 가장 일반적인 용도는 다음과 같습니다.
- 스프레드시트 만들기
- 스프레드시트 셀 값 읽기 및 쓰기
- 스프레드시트 서식 업데이트
- 연결된 시트 관리하기
다음은 Sheets API에서 사용되는 일반적인 용어 목록입니다.
- 스프레드시트
Google Sheets의 기본 객체로, 셀에 구조화된 정보가 포함된 여러 시트를 포함할 수 있습니다. 스프레드시트 리소스는 모든 스프레드시트를 나타내며 문자, 숫자, 하이픈, 밑줄을 포함하는 고유한
spreadsheetId
값을 갖습니다. Google Sheets URL에서 스프레드시트 ID를 확인할 수 있습니다.https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0
- 시트
스프레드시트 내의 페이지 또는 탭입니다. 시트 리소스는 각 시트를 나타내며 고유한 제목과 숫자
sheetId
값을 갖습니다. 시트 ID는 Google Sheets URL에서 찾을 수 있습니다.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
는 시트 1의 첫 번째 열(5행 이후)의 모든 셀을 나타냅니다.A1:B2
는 표시되는 첫 번째 시트의 상위 두 행에 있는 처음 두 셀을 나타냅니다.Sheet1
는 Sheet1의 모든 셀을 나타냅니다.'My Custom Sheet'!A:A
는 '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개 아래, 현재 셀의 오른쪽에 1개 열에 있는 셀을 나타냅니다.
- 이름이 지정된 범위
애플리케이션 전체의 참조를 단순화하기 위해 커스텀 이름이 있는 정의된 셀 또는 셀 범위입니다. FilterView 리소스는 이름이 지정된 범위를 나타냅니다.
- 보호된 범위
정의된 셀 또는 수정할 수 없는 셀 범위입니다. ProtectedRange 리소스는 보호된 범위를 나타냅니다.
다음 단계
인증 및 승인 처리를 포함하여 Google Workspace API를 사용한 개발에 관한 자세한 내용은 Google Workspace에서 개발을 참조하세요.
간단한 Sheets API 앱을 구성하고 실행하는 방법은 빠른 시작 개요를 참조하세요.