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'
는 '내 맞춤 시트'에 있는 모든 셀을 나타냅니다.
도움말: 가능한 경우 스프레드시트 내의 객체에 대한 고유한 이름을 사용합니다. 예를 들어 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 앱을 구성하고 실행하는 방법은 빠른 시작 개요를 참고하세요.