Google Sheets API 개요

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개, 오른쪽에 1개 열인 셀을 나타냅니다.
이름이 지정된 범위

애플리케이션 전체의 참조를 단순화하기 위해 맞춤 이름이 있는 정의된 셀 또는 셀 범위. FilterView 리소스는 이름이 지정된 범위를 나타냅니다.

보호된 범위

수정할 수 없는 정의된 셀 또는 셀 범위입니다. ProtectedRange 리소스는 보호된 범위를 나타냅니다.

다음 단계

  • 인증 및 승인 처리를 비롯하여 Google Workspace API를 사용한 개발 방법을 알아보려면 Google Workspace에서 개발을 참조하세요.

  • 간단한 Sheets API 앱을 구성하고 실행하는 방법은 빠른 시작 개요를 참조하세요.