Google Sheets API 개요

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 값 나 Google Sheets URL에서 시트 ID를 찾을 수 있습니다.

https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId

셀

시트 내 텍스트 또는 데이터의 개별 입력란입니다. 셀은 다음과 같이 정렬됩니다. 셀 범위로 그룹화할 수 있습니다. 가 CellData 리소스는 각 셀을 나타내지만 고유한 ID 값이 없습니다. 대신 row key 열 좌표는 셀을 식별합니다.

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 리소스는 보호된 범위를 나타냅니다.

다음 단계