L'API Google Sheets vous permet d'ajouter, de supprimer et de manipuler des lignes et des colonnes dans Sheets. Les exemples de cette page montrent comment certaines lignes et colonnes peuvent être réalisées avec l'API Sheets.
Ces exemples sont présentés sous la forme de requêtes HTTP et neutres. Pour découvrir comment implémenter une mise à jour par lot dans différents langages à l'aide de les bibliothèques clientes de l'API Google, consultez la section Mettre à jour feuilles de calcul.
Dans ces exemples, les espaces réservés SPREADSHEET_ID
et SHEET_ID
indique où vous devez fournir ces identifiants. Vous pouvez accéder à la feuille de calcul
ID dans l'URL de la feuille de calcul. Vous pouvez obtenir
l'ID de la feuille de calcul à l'aide de l'élément
spreadsheets.get
. La
sont spécifiées au format A1. Une
exemple de plage est Feuille1!A1:D5.
Ajuster la largeur de colonne ou la hauteur des lignes
Les éléments suivants :
spreadsheets.batchUpdate
exemple de code montre comment utiliser
UpdateDimensionPropertiesRequest
pour mettre à jour la propriété de largeur de la colonne A à 160 pixels. Une deuxième demande est mise à jour
la propriété de hauteur de ligne des trois premières
lignes sur 40 pixels. dimension
détermine si l'opération s'applique aux colonnes ou aux lignes d'une
feuille.
Le protocole de requête est présenté ci-dessous.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "updateDimensionProperties": { "range": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "startIndex": 0, "endIndex": 1 }, "properties": { "pixelSize": 160 }, "fields": "pixelSize" } }, { "updateDimensionProperties": { "range": { "sheetId":SHEET_ID
, "dimension": "ROWS", "startIndex": 0, "endIndex": 3 }, "properties": { "pixelSize": 40 }, "fields": "pixelSize" } } ] }
Ajouter des lignes ou des colonnes vides
Les éléments suivants :
spreadsheets.batchUpdate
exemple de code montre comment utiliser
AppendDimensionRequest
pour ajouter des lignes et des colonnes. La première requête ajoute trois lignes vides au
fin d'une feuille, tandis que la seconde ajoute une seule colonne vide. dimension
détermine si l'opération s'applique aux colonnes ou aux lignes d'une
feuille.
Le protocole de requête est présenté ci-dessous.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "appendDimension": { "sheetId":SHEET_ID
, "dimension": "ROWS", "length": 3 } }, { "appendDimension": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "length": 1 } } ] }
Redimensionner automatiquement une colonne
Les éléments suivants :
spreadsheets.batchUpdate
exemple de code montre comment utiliser
AutoResizeDimensionsRequest
pour redimensionner les colonnes A:C, en fonction de la taille du contenu des colonnes. dimension
indique que l'opération s'applique aux colonnes de la feuille.
Le protocole de requête est présenté ci-dessous.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID
,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}
Redimensionner automatiquement une ligne
Les éléments suivants :
spreadsheets.batchUpdate
exemple de code montre comment utiliser
AutoResizeDimensionsRequest
pour effacer la hauteur des trois premières lignes. La hauteur des lignes
augmente alors
dynamiquement en fonction du contenu des cellules de chaque ligne. dimension
indique que l'opération s'applique aux lignes de la feuille.
Le protocole de requête est présenté ci-dessous.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID
,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}
Supprimer des lignes ou des colonnes
Les éléments suivants :
spreadsheets.batchUpdate
exemple de code montre comment utiliser
DeleteDimensionRequest
supprimer les trois premières
lignes d’une feuille. Une deuxième requête supprime les colonnes B:D.
Le champ dimension
détermine si l'opération s'applique aux colonnes ou
lignes d'une feuille.
Le protocole de requête est présenté ci-dessous.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "deleteDimension": { "range": { "sheetId":SHEET_ID
, "dimension": "ROWS", "startIndex": 0, "endIndex": 3 } } }, { "deleteDimension": { "range": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "startIndex": 1, "endIndex": 4 } } }, ], }
Insérer une ligne ou une colonne vide
Les éléments suivants :
spreadsheets.batchUpdate
exemple de code montre comment utiliser
InsertDimensionRequest
pour insérer des colonnes ou des lignes selon un indice particulier (par exemple, en ajoutant des préfixes de lignes vides)
en haut d'une feuille). La première requête insère deux colonnes vides dans la colonne C.
Une deuxième requête insère trois lignes vides à partir de la ligne 1.
Le champ dimension
détermine si l'opération s'applique aux colonnes ou
lignes d'une feuille.
Si la valeur est "true", le champ inheritFromBefore
indique à l'API Sheets de donner
que les nouvelles colonnes ou lignes aient les mêmes propriétés que celles de la ligne ou de la colonne précédente, et si
"false", pour hériter des dimensions après les nouvelles colonnes ou lignes.
inheritFromBefore
ne peut pas être défini sur "true" si vous insérez une ligne à la ligne 1 ou une colonne à
la colonne A.
Le protocole de requête est présenté ci-dessous.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "insertDimension": { "range": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "startIndex": 2, "endIndex": 4 }, "inheritFromBefore": true } }, { "insertDimension": { "range": { "sheetId":SHEET_ID
, "dimension": "ROWS", "startIndex": 0, "endIndex": 3 }, "inheritFromBefore": false } }, ], }
Déplacer une ligne ou une colonne
Les éléments suivants :
spreadsheets.batchUpdate
exemple de code montre comment utiliser
MoveDimensionRequest
pour déplacer la colonne A
à la position de la colonne D. Une seconde demande déplace les lignes
de 5 à 10 à la position de ligne 20.
Le champ dimension
détermine si l'opération s'applique aux colonnes ou
lignes d'une feuille. Le champ destinationIndex
détermine où déplacer la
à l'aide d'un index de départ basé sur zéro.
Le protocole de requête est présenté ci-dessous.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "moveDimension": { "source": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "startIndex": 0, "endIndex": 1 }, "destinationIndex": 3 } }, { "moveDimension": { "source": { "sheetId":SHEET_ID
, "dimension": "ROWS", "startIndex": 4, "endIndex": 10 }, "destinationIndex": 19 } }, ], }