REST Resource: spreadsheets.values

Ressource: ValueRange

Données situées dans une plage de la feuille de calcul.

Représentation JSON
{
  "range": string,
  "majorDimension": enum (Dimension),
  "values": [
    array
  ]
}
Champs
range

string

Plage que les valeurs couvrent, au format A1. Pour le résultat, cette plage correspond à la totalité 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 dans laquelle rechercher une table, après laquelle des valeurs sont ajoutées.

majorDimension

enum (Dimension)

Dimension principale des valeurs.

Pour le résultat, 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]], alors que la requête range=A1:B2,majorDimension=COLUMNS renvoie [[1,3],[2,4]].

Pour les entrées, avec range=A1:B2,majorDimension=ROWS, [[1,2],[3,4]] définit 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 écrites. 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 finales vides ne seront pas incluses.

En entrée, les types de valeurs acceptés sont bool, string et double. Les valeurs nulles seront ignorées. Pour définir une cellule sur une valeur vide, définissez la valeur de chaîne sur une chaîne vide.

Méthodes

append

Ajoute des valeurs à une feuille de calcul.

batchClear

Efface une ou plusieurs plages de valeurs d'une feuille de calcul.

batchClearByDataFilter

Efface une ou plusieurs plages de valeurs d'une feuille de calcul.

batchGet

Affiche une ou plusieurs plages de valeurs dans une feuille de calcul.

batchGetByDataFilter

Renvoie une ou plusieurs plages de valeurs qui correspondent aux filtres de données spécifiés.

batchUpdate

Définit des valeurs dans une ou plusieurs plages d'une feuille de calcul.

batchUpdateByDataFilter

Définit des valeurs dans une ou plusieurs plages d'une feuille de calcul.

clear

Efface les valeurs d'une feuille de calcul.

get

Affiche une plage de valeurs dans une feuille de calcul.

update

Définit des valeurs dans une plage de feuille de calcul.