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는 5행부터 Sheet1의 첫 번째 열에 있는 모든 셀을 나타냅니다.A1:B2는 첫 번째 표시되는 시트의 처음 두 행과 열에 있는 모든 셀을 나타냅니다.Sheet1는 Sheet1의 모든 셀을 나타냅니다.'Jon's_Data'!A1:D5는 'Jon's_Data'라는 시트의 처음 5개 행과 4개 열에 있는 모든 셀을 나타냅니다.'My Custom Sheet'!A:A는 '내 맞춤 시트'라는 시트의 첫 번째 열에 있는 모든 셀을 나타냅니다.'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 리소스는 보호된 범위를 나타냅니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["# Google Sheets API Overview\n\nThe Google Sheets API is a RESTful interface that lets you read and modify a\nspreadsheet's data. The Sheets API lets you:\n\n- Create spreadsheets\n- Read and write spreadsheet cell values\n- Update spreadsheet formatting\n- Manage Connected Sheets\n\nThe following is a list of common terms used in the Sheets API:\n\n*Spreadsheet*\n\n: The primary object in Google Sheets. It can contain multiple `Sheets`, each\n with structured information contained in `Cells`. The\n [`spreadsheets`](/workspace/sheets/api/reference/rest/v4/spreadsheets)\n resource represents a spreadsheet. It contains a unique `spreadsheetId`\n value.\n\n *Spreadsheet ID*\n : The unique identifier for a spreadsheet. It's a particular string\n containing letters, numbers, and some special characters that reference a\n spreadsheet and it can be derived from the spreadsheet's URL. Spreadsheet\n IDs are stable, even if the spreadsheet name changes. \n\n https://docs.google.com/spreadsheets/d/\u003cvar translate=\"no\"\u003eSPREADSHEET_ID\u003c/var\u003e/edit?gid=\u003cvar translate=\"no\"\u003eSHEET_ID\u003c/var\u003e#gid=\u003cvar translate=\"no\"\u003eSHEET_ID\u003c/var\u003e\n\n*Sheet*\n\n: A page or tab within a spreadsheet. The\n [`Sheets`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets) resource\n represents a sheet. It contains a unique numeric `sheetId` value and sheet\n `title` as part of the\n [`SheetProperties`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#sheetproperties)\n object.\n\n *Sheet ID*\n : The unique identifier for a specific sheet within a spreadsheet. It's a\n particular integer containing numbers that reference a sheet and it can be\n derived from the spreadsheet's URL. Sheet IDs are stable, even if the sheet\n name changes. For an example, see [Spreadsheet ID](#spreadsheet-id).\n\n*Cell*\n\n: An individual field of text or data within a sheet. Cells are arranged in rows\n and columns, and can be grouped as a range of cells. The\n [`Cells`](/workspace/sheets/api/reference/rest/v4/spreadsheets/cells)\n resource represents each cell, but it doesn't have a unique ID value.\n Instead, row and column coordinates identify the cells.\n\n *A1 notation*\n : A syntax used to define a cell or range of cells with a string that\n contains the sheet name plus the starting and ending cell coordinates using\n column letters and row numbers. This method is the most common and useful\n when referencing an absolute range of cells.\n - `Sheet1!A1:B2` refers to all the cells in the first two rows and columns of Sheet1.\n - `Sheet1!A:A` refers to all the cells in the first column of Sheet1.\n - `Sheet1!1:2` refers to all the cells in the first two rows of Sheet1.\n - `Sheet1!A5:A` refers to all the cells of the first column of Sheet 1, from row 5 onward.\n - `A1:B2` refers to all the cells in the first two rows and columns of the first visible sheet.\n - `Sheet1` refers to all the cells in Sheet1.\n - `'Jon's_Data'!A1:D5` refers to all the cells in the first five rows and four columns of a sheet named \"Jon's_Data.\"\n - `'My Custom Sheet'!A:A` refers to all the cells in the first column of a sheet named \"My Custom Sheet.\"\n - `'My Custom Sheet'` refers to all the cells in \"My Custom Sheet\".\n\n Single quotes are required for sheet names with spaces or special characters.\n\n **Tip** : Where possible, use distinct names for objects in your spreadsheets. For example, A1 (without quotes) refers to cell A1 in the first visible sheet. `'A1'` refers to a sheet with the name A1. Similarly, Sheet1 refers to a sheet with the name Sheet1. However, if there's a named range titled \"Sheet1\", then Sheet1 refers to the named range and `'Sheet1'` refers to the sheet.\n\n *R1C1 notation*\n : A syntax used to define a cell or range of cells with a string that\n contains the sheet name plus the starting and ending cell coordinates using\n row numbers and column numbers. This method is less common than A1 notation,\n but can be useful when referencing a range of cells relative to a given\n cell's position.\n - `Sheet1!R1C1:R2C2` refers to the first two cells in the top two rows of Sheet1.\n - `R1C1:R2C2` refers to the first two cells in the top two rows of the first visible sheet.\n - `Sheet1!R[3]C[1]` refers to the cell that is three rows below and one column to the right of the current cell.\n\n *Named range*\n : A defined cell or range of cells with a custom name to simplify references\n throughout an application. A\n [`FilterView`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#filterview)\n resource represents a named range.\n\n *Protected range*\n : A defined cell or range of cells that cannot be modified. A\n [`ProtectedRange`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#protectedrange)\n resource represents a protected range.\n\nRelated topics\n--------------\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer to [Develop on\n Google Workspace](/workspace/guides/get-started).\n\n- To learn how to configure and run a Sheets API app, try the\n [JavaScript quickstart](/workspace/sheets/api/quickstart/js)."]]
