Google Sheets API 개요

Google Sheets API는 스프레드시트를 읽고 수정할 수 있는 RESTful 인터페이스입니다. 스프레드시트를 사용합니다. 이 API의 가장 일반적인 용도는 다음과 같습니다. 작업:

  • 스프레드시트 만들기
  • 스프레드시트 셀 값 읽기 및 쓰기
  • 스프레드시트 서식 업데이트
  • 연결된 시트 관리하기

다음은 이 API에서 사용되는 일반적인 용어 목록입니다.

스프레드시트

Google Sheets의 기본 객체로, 각각에 여러 개의 시트를 포함할 수 있습니다. 구조화된 정보를 포함하는 셀입니다. Spreadsheet 모든 리소스는 스프레드시트 고유의 spreadsheetId 값, 문자, 숫자, 하이픈, 밑줄을 포함할 수 없습니다. Google Sheets URL에서 스프레드시트 ID를 확인할 수 있습니다.

https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0

시트

스프레드시트 내의 페이지 또는 탭입니다. Sheet 리소스는 각 리소스의 고유한 제목과 숫자가 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는 시트 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 리소스 보호된 범위를 나타냅니다.