Google Sheets API는 스프레드시트의 데이터를 읽고 수정할 수 있는 RESTful 인터페이스입니다. Sheets API를 사용하면 다음 작업을 할 수 있습니다.
- 스프레드시트 만들기
- 스프레드시트 셀 값 읽기 및 쓰기
- 스프레드시트 서식 업데이트
- 연결된 시트 관리
다음은 Sheets API에서 사용되는 일반적인 용어 목록입니다.
- 스프레드시트
Google Sheets의 기본 객체입니다. 여기에는 여러
Sheets가 포함될 수 있으며 각Sheets에는Cells에 포함된 구조화된 정보가 있습니다.spreadsheets리소스는 스프레드시트를 나타냅니다. 고유한spreadsheetId값을 포함합니다.- 스프레드시트 ID
- 스프레드시트의 고유 식별자입니다. 스프레드시트를 참조하는 문자, 숫자, 일부 특수문자가 포함된 특정 문자열이며 스프레드시트의 URL에서 파생될 수 있습니다. 스프레드시트 이름이 변경되더라도 스프레드시트 ID는 안정적입니다.
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID- 시트
스프레드시트 내의 페이지 또는 탭입니다.
Sheets리소스는 시트를 나타냅니다.SheetProperties객체의 일부로 고유한 숫자sheetId값과 시트title이 포함됩니다.- 시트 ID
- 스프레드시트 내 특정 시트의 고유 식별자입니다. 시트를 참조하는 숫자가 포함된 특정 정수이며 스프레드시트의 URL에서 파생될 수 있습니다. 시트 이름이 변경되더라도 시트 ID는 안정적입니다. 예를 보려면 스프레드시트 ID를 참고하세요.
- Cell
시트 내의 텍스트 또는 데이터의 개별 필드입니다. 셀은 행과 열로 정렬되며 셀 범위로 그룹화할 수 있습니다.
Cells리소스는 각 셀을 나타내지만 고유한 ID 값이 없습니다. 대신 행 및 열 좌표가 셀을 식별합니다.- A1 표기법
- 시트 이름과 열 문자 및 행 번호를 사용하여 시작 및 종료 셀 좌표가 포함된 문자열로 셀 또는 셀 범위를 정의하는 데 사용되는 문법입니다. 이 방법은 절대 셀 범위를 참조할 때 가장 일반적이고 유용합니다.
Sheet1!A1:B2는 Sheet1의 처음 두 행과 열에 있는 모든 셀을 나타냅니다.Sheet1!A:A는 Sheet1의 첫 번째 열에 있는 모든 셀을 참조합니다.Sheet1!1:2은 Sheet1의 처음 두 행에 있는 모든 셀을 참조합니다.Sheet1!A5:A는 5행부터 Sheet1의 첫 번째 열에 있는 모든 셀을 나타냅니다.A1:B2는 첫 번째 표시되는 시트의 처음 두 행과 열에 있는 모든 셀을 나타냅니다.Sheet1는 Sheet1의 모든 셀을 나타냅니다.'Jon's_Data'!A1:D5는 'Jon's_Data'라는 시트의 처음 5개 행과 4개 열에 있는 모든 셀을 나타냅니다.'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 앱을 구성하고 실행하는 방법을 알아보려면 JavaScript 빠른 시작을 참고하세요.