Method: spreadsheets.values.batchUpdate

Définit des valeurs dans une ou plusieurs plages d'une feuille de calcul. L'appelant doit spécifier l'ID de la feuille de calcul, un valueInputOption, ainsi qu'un ou plusieurs ValueRanges.

Requête HTTP :

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

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.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "valueInputOption": enum (ValueInputOption),
  "data": [
    {
      object (ValueRange)
    }
  ],
  "includeValuesInResponse": boolean,
  "responseValueRenderOption": enum (ValueRenderOption),
  "responseDateTimeRenderOption": enum (DateTimeRenderOption)
}
Champs
valueInputOption

enum (ValueInputOption)

Mode d'interprétation des données d'entrée.
data[]

object (ValueRange)

Nouvelles valeurs à appliquer à la feuille de calcul.
includeValuesInResponse

boolean

Détermine si la réponse de mise à jour doit inclure les valeurs des cellules mises à jour. Par défaut, les réponses n'incluent pas les valeurs mises à jour. Le champ updatedData de chaque BatchUpdateValuesResponse.responses contient les valeurs mises à jour. Si la plage à écrire était supérieure à la plage réelle, la réponse inclut toutes les valeurs de la plage demandée (à l'exclusion des lignes et des colonnes vides finales).
responseValueRenderOption

enum (ValueRenderOption)

Détermine comment les valeurs de la réponse doivent être affichées. 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 être affichées. 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 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,
  "totalUpdatedRows": integer,
  "totalUpdatedColumns": integer,
  "totalUpdatedCells": integer,
  "totalUpdatedSheets": integer,
  "responses": [
    {
      object (UpdateValuesResponse)
    }
  ]
}
Champs
spreadsheetId

string

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

integer

Nombre total de lignes dans lesquelles au moins une cellule a été mise à jour.
totalUpdatedColumns

integer

Nombre total de colonnes dans lesquelles au moins une cellule a été mise à jour.
totalUpdatedCells

integer

Nombre total de cellules mises à jour.
totalUpdatedSheets

integer

Nombre total de feuilles dans lesquelles au moins une cellule a été mise à jour.
responses[]

object (UpdateValuesResponse)

Une UpdateValuesResponse par plage demandée, dans le même ordre que les requêtes affiché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.