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
는 Sheet 1의 첫 열의 5행부터 모든 셀을 나타냅니다.A1:B2
는 보이는 첫 시트의 첫 두 행과 열에 있는 모든 셀을 나타냅니다.Sheet1
은 Sheet1의 모든 셀을 나타냅니다.'Jon's_Data'!A1:D5
는 'Jon's_Data'라는 시트의 처음 5개 행과 4개 열에 있는 모든 셀을 나타냅니다.'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 앱을 구성하고 실행하는 방법은 JavaScript 빠른 시작을 참조하세요.