- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- InsérerDonnéesOption
- Essayer
Ajoute des valeurs à une feuille de calcul. La plage d'entrée permet de rechercher des données existantes et de rechercher une "table" 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 de données.
L'appelant doit spécifier l'ID de feuille de calcul, la plage et un valueInputOption
. Le valueInputOption
ne contrôle que la façon dont les données d'entrée sont ajoutées à la feuille (au niveau des colonnes ou des lignes). Il n'a aucune incidence sur 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 |
ID de la feuille de calcul à mettre à jour. |
range |
Le format A1 d'une plage pour rechercher une table logique de données. Les valeurs sont ajoutées après la dernière ligne du tableau. |
Paramètres de requête
Paramètres | |
---|---|
valueInputOption |
Mode d'interprétation des données d'entrée. |
insertDataOption |
Mode d'insertion des données d'entrée. |
includeValuesInResponse |
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 |
Détermine comment les valeurs de la réponse doivent être affichées. L'option de rendu par défaut est |
responseDateTimeRenderOption |
Détermine comment les dates, les heures et les durées de la réponse doivent être affichées. Cette valeur est ignorée si |
Corps de la requête
Le corps de la requête contient une instance ValueRange
.
Corps de la réponse
Réponse lorsque vous mettez à jour 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 ( |
Champs | |
---|---|
spreadsheetId |
Feuille de calcul à laquelle les mises à jour ont été appliquées. |
tableRange |
Plage (au format 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 |
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 sur les autorisations.
InsertDataOption
Détermine la manière dont les données existantes sont modifiées lorsque vous saisissez de nouvelles données.
Enums | |
---|---|
OVERWRITE |
Les nouvelles données écrasent les données existantes dans les zones où elles sont écrites. Notez que l'ajout de données à la fin de la feuille insère toujours de nouvelles lignes ou colonnes pour que les données puissent être écrites. |
INSERT_ROWS |
Des lignes sont insérées pour les nouvelles données. |