Google Sheets API 개요

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