Google Sheets API
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Google Sheets를 읽고 씁니다.
서비스: sheets.googleapis.com
이 서비스를 호출하려면 Google에서 제공하는 클라이언트 라이브러리를 사용하는 것이 좋습니다. 애플리케이션에서 자체 라이브러리를 사용하여 이 서비스를 호출해야 한다면 API 요청을 실행할 때 다음 정보를 사용해야 합니다.
검색 문서
검색 문서는 머신에서 읽을 수 있는 사양이며 REST API를 설명하고 사용하는 데 참조할 수 있습니다. 또한 클라이언트 라이브러리, IDE 플러그인, 기타 Google API와 상호작용하는 도구를 빌드하는 데 사용됩니다. 하나의 서비스는 여러 개의 검색 문서를 제공할 수 있습니다. 이 서비스는 다음 검색 문서를 제공합니다.
서비스 엔드포인트
서비스 엔드포인트는 API 서비스의 네트워크 주소를 지정하는 기준 URL입니다. 하나의 서비스는 여러 서비스 엔드포인트를 포함할 수 있습니다. 이 서비스에는 다음 서비스 엔드포인트가 포함되고, 그 아래의 모든 URI가 이 서비스 엔드포인트와 관련됩니다.
https://sheets.googleapis.com
| 메서드 |
batchUpdate |
POST /v4/spreadsheets/{spreadsheetId}:batchUpdate
스프레드시트에 하나 이상의 업데이트를 적용합니다. |
create |
POST /v4/spreadsheets
스프레드시트를 만들어 새로 생성된 스프레드시트를 반환합니다. |
get |
GET /v4/spreadsheets/{spreadsheetId}
지정된 ID의 스프레드시트를 반환합니다. |
getByDataFilter |
POST /v4/spreadsheets/{spreadsheetId}:getByDataFilter
지정된 ID의 스프레드시트를 반환합니다. |
| 메서드 |
copyTo |
POST /v4/spreadsheets/{spreadsheetId}/sheets/{sheetId}:copyTo
스프레드시트에서 다른 스프레드시트로 단일 시트를 복사합니다. |
| 메서드 |
append |
POST /v4/spreadsheets/{spreadsheetId}/values/{range}:append
스프레드시트에 값을 추가합니다. |
batchClear |
POST /v4/spreadsheets/{spreadsheetId}/values:batchClear
스프레드시트에서 하나 이상의 값 범위를 지웁니다. |
batchClearByDataFilter |
POST /v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter
스프레드시트에서 하나 이상의 값 범위를 지웁니다. |
batchGet |
GET /v4/spreadsheets/{spreadsheetId}/values:batchGet
스프레드시트에서 값 범위를 하나 이상 반환합니다. |
batchGetByDataFilter |
POST /v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter
지정된 데이터 필터와 일치하는 하나 이상의 값 범위를 반환합니다. |
batchUpdate |
POST /v4/spreadsheets/{spreadsheetId}/values:batchUpdate
스프레드시트의 하나 이상의 범위에 값을 설정합니다. |
batchUpdateByDataFilter |
POST /v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter
스프레드시트의 하나 이상의 범위에 값을 설정합니다. |
clear |
POST /v4/spreadsheets/{spreadsheetId}/values/{range}:clear
스프레드시트에서 값을 삭제합니다. |
get |
GET /v4/spreadsheets/{spreadsheetId}/values/{range}
스프레드시트의 값 범위를 반환합니다. |
update |
PUT /v4/spreadsheets/{spreadsheetId}/values/{range}
스프레드시트의 범위에 값을 설정합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[],[],null,["# Google Sheets API\n\nReads and writes Google Sheets.\n\n- [REST Resource: v4.spreadsheets](#v4.spreadsheets)\n- [REST Resource: v4.spreadsheets.developerMetadata](#v4.spreadsheets.developerMetadata)\n- [REST Resource: v4.spreadsheets.sheets](#v4.spreadsheets.sheets)\n- [REST Resource: v4.spreadsheets.values](#v4.spreadsheets.values)\n\nService: sheets.googleapis.com\n------------------------------\n\nTo call this service, we recommend that you use the Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to use your own libraries to call this service, use the following information when you make the API requests.\n\n### Discovery document\n\nA [Discovery Document](https://developers.google.com/discovery/v1/reference/apis) is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:\n\n- \u003chttps://sheets.googleapis.com/$discovery/rest?version=v4\u003e\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:\n\n- `https://sheets.googleapis.com`\n\nREST Resource: [v4.spreadsheets](/workspace/sheets/api/reference/rest/v4/spreadsheets)\n--------------------------------------------------------------------------------------\n\n| Methods ||\n|-----------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------|\n| [batchUpdate](/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate) | `POST /v4/spreadsheets/{spreadsheetId}:batchUpdate` Applies one or more updates to the spreadsheet. |\n| [create](/workspace/sheets/api/reference/rest/v4/spreadsheets/create) | `POST /v4/spreadsheets` Creates a spreadsheet, returning the newly created spreadsheet. |\n| [get](/workspace/sheets/api/reference/rest/v4/spreadsheets/get) | `GET /v4/spreadsheets/{spreadsheetId}` Returns the spreadsheet at the given ID. |\n| [getByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets/getByDataFilter) | `POST /v4/spreadsheets/{spreadsheetId}:getByDataFilter` Returns the spreadsheet at the given ID. |\n\nREST Resource: [v4.spreadsheets.developerMetadata](/workspace/sheets/api/reference/rest/v4/spreadsheets.developerMetadata)\n--------------------------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|-----------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [get](/workspace/sheets/api/reference/rest/v4/spreadsheets.developerMetadata/get) | `GET /v4/spreadsheets/{spreadsheetId}/developerMetadata/{metadataId}` Returns the developer metadata with the specified ID. |\n| [search](/workspace/sheets/api/reference/rest/v4/spreadsheets.developerMetadata/search) | `POST /v4/spreadsheets/{spreadsheetId}/developerMetadata:search` Returns all developer metadata matching the specified [DataFilter](/workspace/sheets/api/reference/rest/v4/DataFilter). |\n\nREST Resource: [v4.spreadsheets.sheets](/workspace/sheets/api/reference/rest/v4/spreadsheets.sheets)\n----------------------------------------------------------------------------------------------------\n\n| Methods ||\n|------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------|\n| [copyTo](/workspace/sheets/api/reference/rest/v4/spreadsheets.sheets/copyTo) | `POST /v4/spreadsheets/{spreadsheetId}/sheets/{sheetId}:copyTo` Copies a single sheet from a spreadsheet to another spreadsheet. |\n\nREST Resource: [v4.spreadsheets.values](/workspace/sheets/api/reference/rest/v4/spreadsheets.values)\n----------------------------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------|\n| [append](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/append) | `POST /v4/spreadsheets/{spreadsheetId}/values/{range}:append` Appends values to a spreadsheet. |\n| [batchClear](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchClear) | `POST /v4/spreadsheets/{spreadsheetId}/values:batchClear` Clears one or more ranges of values from a spreadsheet. |\n| [batchClearByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchClearByDataFilter) | `POST /v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter` Clears one or more ranges of values from a spreadsheet. |\n| [batchGet](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchGet) | `GET /v4/spreadsheets/{spreadsheetId}/values:batchGet` Returns one or more ranges of values from a spreadsheet. |\n| [batchGetByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchGetByDataFilter) | `POST /v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter` Returns one or more ranges of values that match the specified data filters. |\n| [batchUpdate](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchUpdate) | `POST /v4/spreadsheets/{spreadsheetId}/values:batchUpdate` Sets values in one or more ranges of a spreadsheet. |\n| [batchUpdateByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchUpdateByDataFilter) | `POST /v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter` Sets values in one or more ranges of a spreadsheet. |\n| [clear](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/clear) | `POST /v4/spreadsheets/{spreadsheetId}/values/{range}:clear` Clears values from a spreadsheet. |\n| [get](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get) | `GET /v4/spreadsheets/{spreadsheetId}/values/{range}` Returns a range of values from a spreadsheet. |\n| [update](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update) | `PUT /v4/spreadsheets/{spreadsheetId}/values/{range}` Sets values in a range of a spreadsheet. |"]]
