REST Resource: spreadsheets.values
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ressource: ValueRange
Données d'une plage de la feuille de calcul.
Représentation JSON |
{
"range": string,
"majorDimension": enum (Dimension ),
"values": [
array
]
} |
Champs |
range |
string
Plage couverte par les valeurs, en notation A1. Pour la sortie, cette plage indique l'ensemble de la plage demandée, même si les valeurs excluent les lignes et colonnes de fin. Lorsque vous ajoutez des valeurs, ce champ représente la plage à rechercher pour une table, après quoi les valeurs seront ajoutées.
|
majorDimension |
enum (Dimension )
Dimension principale des valeurs. Pour la sortie, si les données de la feuille de calcul sont A1=1,B1=2,A2=3,B2=4 , la requête range=A1:B2,majorDimension=ROWS renvoie [[1,2],[3,4]] , tandis que la requête range=A1:B2,majorDimension=COLUMNS renvoie [[1,3],[2,4]] . Pour l'entrée, avec range=A1:B2,majorDimension=ROWS , [[1,2],[3,4]] définira A1=1,B1=2,A2=3,B2=4 . Avec range=A1:B2,majorDimension=COLUMNS , [[1,2],[3,4]] définira A1=1,B1=3,A2=2,B2=4 . Lors de l'écriture, si ce champ n'est pas défini, la valeur par défaut est ROWS.
|
values[] |
array (ListValue format)
Données lues ou à écrire. Il s'agit d'un tableau de tableaux, le tableau externe représentant toutes les données et chaque tableau interne représentant une dimension majeure. Chaque élément du tableau interne correspond à une cellule. Pour la sortie, les lignes et colonnes vides de fin ne sont pas incluses. Pour les entrées, les types de valeurs acceptés sont: bool, string et double. Les valeurs NULL seront ignorées. Pour définir une cellule sur une valeur vide, définissez la valeur de la chaîne sur une chaîne vide.
|
Méthodes |
|
Ajoute des valeurs à une feuille de calcul. |
|
Efface une ou plusieurs plages de valeurs d'une feuille de calcul. |
|
Efface une ou plusieurs plages de valeurs d'une feuille de calcul. |
|
Renvoie une ou plusieurs plages de valeurs à partir d'une feuille de calcul. |
|
Renvoie une ou plusieurs plages de valeurs correspondant aux filtres de données spécifiés. |
|
Définit les valeurs d'une ou de plusieurs plages d'une feuille de calcul. |
|
Définit les valeurs d'une ou de plusieurs plages d'une feuille de calcul. |
|
Efface les valeurs d'une feuille de calcul. |
|
Renvoie une plage de valeurs à partir d'une feuille de calcul. |
|
Définit les valeurs d'une plage d'une feuille de calcul. |
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,["# REST Resource: spreadsheets.values\n\n- [Resource: ValueRange](#ValueRange)\n - [JSON representation](#ValueRange.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: ValueRange\n--------------------\n\nData within a range of the spreadsheet.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"range\": string, \"majorDimension\": enum (/workspace/sheets/api/reference/rest/v4/Dimension), \"values\": [ array ] } ``` |\n\n| Fields ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `range` | `string` The range the values cover, in [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell). For output, this range indicates the entire requested range, even though the values will exclude trailing rows and columns. When appending values, this field represents the range to search for a table, after which values will be appended. |\n| `majorDimension` | `enum (`[Dimension](/workspace/sheets/api/reference/rest/v4/Dimension)`)` The major dimension of the values. For output, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`, then requesting `range=A1:B2,majorDimension=ROWS` will return `[[1,2],[3,4]]`, whereas requesting `range=A1:B2,majorDimension=COLUMNS` will return `[[1,3],[2,4]]`. For input, with `range=A1:B2,majorDimension=ROWS` then `[[1,2],[3,4]]` will set `A1=1,B1=2,A2=3,B2=4`. With `range=A1:B2,majorDimension=COLUMNS` then `[[1,2],[3,4]]` will set `A1=1,B1=3,A2=2,B2=4`. When writing, if this field is not set, it defaults to ROWS. |\n| `values[]` | `array (`[ListValue](https://protobuf.dev/reference/protobuf/google.protobuf/#list-value)` format)` The data that was read or to be written. This is an array of arrays, the outer array representing all the data and each inner array representing a major dimension. Each item in the inner array corresponds with one cell. For output, empty trailing rows and columns will not be included. For input, supported value types are: bool, string, and double. Null values will be skipped. To set a cell to an empty value, set the string value to an empty string. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------|\n| ### [append](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/append) | Appends values to a spreadsheet. |\n| ### [batchClear](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchClear) | Clears one or more ranges of values from a spreadsheet. |\n| ### [batchClearByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchClearByDataFilter) | Clears one or more ranges of values from a spreadsheet. |\n| ### [batchGet](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchGet) | Returns one or more ranges of values from a spreadsheet. |\n| ### [batchGetByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.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) | Sets values in one or more ranges of a spreadsheet. |\n| ### [batchUpdateByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchUpdateByDataFilter) | Sets values in one or more ranges of a spreadsheet. |\n| ### [clear](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/clear) | Clears values from a spreadsheet. |\n| ### [get](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get) | Returns a range of values from a spreadsheet. |\n| ### [update](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update) | Sets values in a range of a spreadsheet. |"]]