Method: spreadsheets.values.append

Ajoute des valeurs à une feuille de calcul. La plage d'entrée permet de rechercher des données existantes et de trouver un "tableau" compris dans cette plage. Les valeurs seront ajoutées à la ligne suivante du tableau, en commençant par la première colonne. Consultez le guide et l'exemple de code pour en savoir plus sur la détection des tables et l'ajout des données.

L'appelant doit spécifier l'ID de la feuille de calcul, la plage de dates et un élément valueInputOption. valueInputOption contrôle uniquement la façon dont les données d'entrée seront ajoutées à la feuille (par colonne ou par ligne). Il n'influence pas la cellule dans laquelle les données commencent à être écrites.

Requête HTTP

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append

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 d'une plage pour rechercher une table de données logique. Les valeurs sont ajoutées après la dernière ligne de la table.

Paramètres de requête

Paramètres
valueInputOption

enum (ValueInputOption)

Manière dont les données d'entrée doivent être interprétées.
insertDataOption

enum (InsertDataOption)

Méthode d'insertion des données d'entrée.
includeValuesInResponse

boolean

Détermine si la réponse de mise à jour doit inclure les valeurs des cellules ajoutées. Par défaut, les réponses n'incluent pas les valeurs mises à jour.
responseValueRenderOption

enum (ValueRenderOption)

Détermine la façon dont les valeurs de la réponse doivent s'afficher. L'option de rendu par défaut est FORMATTED_VALUE.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

Détermine comment les dates, les heures et les durées de la réponse doivent s'afficher. Cette valeur est ignorée si responseValueRenderOption est défini sur FORMATTED_VALUE. L'option de rendu date/heure par défaut est SERIAL_NUMBER.

Corps de la requête

Le corps de la requête contient une instance ValueRange.

Corps de la réponse

Réponse lors de la mise à jour d'une plage de valeurs dans une feuille de calcul.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "spreadsheetId": string,
  "tableRange": string,
  "updates": {
    object (UpdateValuesResponse)
  }
}
Champs
spreadsheetId

string

Feuille de calcul à laquelle les mises à jour ont été appliquées.
tableRange

string

Plage (en notation A1) de la table à laquelle les valeurs sont ajoutées (avant l'ajout des valeurs). Ce champ est vide si aucune table n'a été trouvée.
updates

object (UpdateValuesResponse)

Informations sur les mises à jour appliquées.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

Pour en savoir plus, consultez le guide relatif aux autorisations.

InsertDataOption

Détermine la manière dont les données existantes sont modifiées lorsque de nouvelles données sont saisies.

Enums
OVERWRITE Les nouvelles données écrasent les données existantes dans les zones où elles sont écrites. (Remarque: ajouter des données à la fin de la feuille insère toujours de nouvelles lignes ou colonnes, ce qui permet d'écrire les données.)
INSERT_ROWS Des lignes sont insérées pour les nouvelles données.