REST Resource: spreadsheets.values

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 des 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 sont 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

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

Renvoie une ou plusieurs plages de valeurs à partir d'une feuille de calcul.

batchGetByDataFilter

Renvoie une ou plusieurs plages de valeurs correspondant 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

Renvoie une plage de valeurs à partir d'une feuille de calcul.

update

Définit les valeurs d'une plage d'une feuille de calcul.