Method: spreadsheets.values.update
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Définit les valeurs d'une plage d'une feuille de calcul. L'appelant doit spécifier l'ID de la feuille de calcul, la plage et un valueInputOption.
Requête HTTP
PUT https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
spreadsheetId |
string
ID de la feuille de calcul à mettre à jour.
|
range |
string
Notation A1 des valeurs à mettre à jour.
|
Paramètres de requête
| Paramètres |
valueInputOption |
enum (ValueInputOption)
Indique comment les données d'entrée doivent être interprétées.
|
includeValuesInResponse |
boolean
Détermine si la réponse de mise à jour doit inclure les valeurs des cellules mises à jour. Par défaut, les réponses n'incluent pas les valeurs mises à jour. Si la plage à écrire était plus grande que la plage réellement écrite, la réponse inclut toutes les valeurs de la plage demandée (à l'exception des lignes et colonnes vides à la fin).
|
responseValueRenderOption |
enum (ValueRenderOption)
Détermine comment les valeurs de la réponse doivent être affichées. L'option de rendu par défaut est FORMATTED_VALUE.
|
responseDateTimeRenderOption |
enum (DateTimeRenderOption)
Détermine la façon dont les dates, les heures et les durées de la réponse doivent être affichées. Cette valeur est ignorée si responseValueRenderOption est FORMATTED_VALUE. L'option de rendu dateTime par défaut est SERIAL_NUMBER.
|
Corps de la requête
Le corps de la requête contient une instance de ValueRange.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de UpdateValuesResponse.
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/spreadsheets
Pour en savoir plus, consultez le guide d'autorisation.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/03/22 (UTC).
[null,null,["Dernière mise à jour le 2025/03/22 (UTC)."],[],[],null,["# Method: spreadsheets.values.update\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nSets values in a range of a spreadsheet. The caller must specify the spreadsheet ID, range, and a [valueInputOption](/workspace/sheets/api/reference/rest/v4/ValueInputOption).\n\n### HTTP request\n\n`PUT https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------|\n| `spreadsheetId` | `string` The ID of the spreadsheet to update. |\n| `range` | `string` The [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell) of the values to update. |\n\n### Query parameters\n\n| Parameters ||\n|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `valueInputOption` | `enum (`[ValueInputOption](/workspace/sheets/api/reference/rest/v4/ValueInputOption)`)` How the input data should be interpreted. |\n| `includeValuesInResponse` | `boolean` Determines if the update response should include the values of the cells that were updated. By default, responses do not include the updated values. If the range to write was larger than the range actually written, the response includes all values in the requested range (excluding trailing empty rows and columns). |\n| `responseValueRenderOption` | `enum (`[ValueRenderOption](/workspace/sheets/api/reference/rest/v4/ValueRenderOption)`)` Determines how values in the response should be rendered. The default render option is [FORMATTED_VALUE](/workspace/sheets/api/reference/rest/v4/ValueRenderOption). |\n| `responseDateTimeRenderOption` | `enum (`[DateTimeRenderOption](/workspace/sheets/api/reference/rest/v4/DateTimeRenderOption)`)` Determines how dates, times, and durations in the response should be rendered. This is ignored if [responseValueRenderOption](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update#body.QUERY_PARAMETERS.response_value_render_option) is [FORMATTED_VALUE](/workspace/sheets/api/reference/rest/v4/ValueRenderOption). The default dateTime render option is [SERIAL_NUMBER](/workspace/sheets/api/reference/rest/v4/DateTimeRenderOption). |\n\n### Request body\n\nThe request body contains an instance of [ValueRange](/workspace/sheets/api/reference/rest/v4/spreadsheets.values#ValueRange).\n\n### Response body\n\nIf successful, the response body contains an instance of [UpdateValuesResponse](/workspace/sheets/api/reference/rest/v4/UpdateValuesResponse).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive`\n- `https://www.googleapis.com/auth/drive.file`\n- `https://www.googleapis.com/auth/spreadsheets`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
