Method: spreadsheets.values.update

Définit les valeurs dans une plage d'une feuille de calcul. L'appelant doit spécifier l'ID de la feuille de calcul, la plage de dates et un élément valueInputOption.

Requête HTTP

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

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 des valeurs à mettre à jour.

Paramètres de requête

Paramètres
valueInputOption

enum (ValueInputOption)

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

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. Si la plage à écrire était supérieure à celle réellement écrite, la réponse inclut toutes les valeurs de la plage demandée (à l'exception des lignes et colonnes vides de fin).

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

Si la requête aboutit, le corps de la réponse contient une instance de UpdateValuesResponse.

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.