Google Sheets API

Reads and writes Google Sheets.

Service: sheets.googleapis.com

To call this service, we recommend that you use the Google-providedclient libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.

Discovery document

ADiscovery Document 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:

Service endpoint

Aservice 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:

  • https://sheets.googleapis.com

REST Resource:v4.spreadsheets

Methods
batchUpdatePOST /v4/spreadsheets/{spreadsheetId}:batchUpdate
Applies one or more updates to the spreadsheet.
createPOST /v4/spreadsheets
Creates a spreadsheet, returning the newly created spreadsheet.
getGET /v4/spreadsheets/{spreadsheetId}
Returns the spreadsheet at the given ID.
getByDataFilterPOST /v4/spreadsheets/{spreadsheetId}:getByDataFilter
Returns the spreadsheet at the given ID.

REST Resource:v4.spreadsheets.developerMetadata

Methods
getGET /v4/spreadsheets/{spreadsheetId}/developerMetadata/{metadataId}
Returns the developer metadata with the specified ID.
searchPOST /v4/spreadsheets/{spreadsheetId}/developerMetadata:search
Returns all developer metadata matching the specifiedDataFilter.

REST Resource:v4.spreadsheets.sheets

Methods
copyToPOST /v4/spreadsheets/{spreadsheetId}/sheets/{sheetId}:copyTo
Copies a single sheet from a spreadsheet to another spreadsheet.

REST Resource:v4.spreadsheets.values

Methods
appendPOST /v4/spreadsheets/{spreadsheetId}/values/{range}:append
Appends values to a spreadsheet.
batchClearPOST /v4/spreadsheets/{spreadsheetId}/values:batchClear
Clears one or more ranges of values from a spreadsheet.
batchClearByDataFilterPOST /v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter
Clears one or more ranges of values from a spreadsheet.
batchGetGET /v4/spreadsheets/{spreadsheetId}/values:batchGet
Returns one or more ranges of values from a spreadsheet.
batchGetByDataFilterPOST /v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter
Returns one or more ranges of values that match the specified data filters.
batchUpdatePOST /v4/spreadsheets/{spreadsheetId}/values:batchUpdate
Sets values in one or more ranges of a spreadsheet.
batchUpdateByDataFilterPOST /v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter
Sets values in one or more ranges of a spreadsheet.
clearPOST /v4/spreadsheets/{spreadsheetId}/values/{range}:clear
Clears values from a spreadsheet.
getGET /v4/spreadsheets/{spreadsheetId}/values/{range}
Returns a range of values from a spreadsheet.
updatePUT /v4/spreadsheets/{spreadsheetId}/values/{range}
Sets values in a range of a spreadsheet.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-03-21 UTC.