L'API Google Sheets vous permet de manipuler des données dans des feuilles de calcul dans divers de différentes manières. La plupart des fonctionnalités disponibles pour les utilisateurs travaillant avec Vous pouvez aussi utiliser l'interface utilisateur de Sheets l'API Sheets. Les exemples de cette page illustrent comment certaines opérations courantes dans les feuilles de calcul 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.
Appliquer la validation des données à une plage
Les éléments suivants :
spreadsheets.batchUpdate
exemple de code montre comment utiliser
SetDataValidationRequest
pour appliquer une règle de validation des données, où "valeur > 5", à chaque cellule de la plage A1:D10.
Le protocole de requête est présenté ci-dessous.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{
"requests": [
{
"setDataValidation": {
"range": {
"sheetId": SHEET_ID
,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 4
},
"rule": {
"condition": {
"type": "NUMBER_GREATER",
"values": [
{
"userEnteredValue": "5"
}
]
},
"inputMessage": "Value must be > 5",
"strict": true
}
}
}
]
}
Copier et coller la mise en forme de la cellule
Les éléments suivants :
spreadsheets.batchUpdate
exemple de code montre comment utiliser
CopyPasteRequest
pour copier la mise en forme uniquement dans la plage A1:D10 et la coller dans la plage F1:I10
dans la même feuille. La méthode utilise
Énumération PasteType
avec PASTE_FORMAT
pour ne coller que la mise en forme et la validation des données. La
les valeurs d'origine dans A1:D10 restent inchangées.
Le protocole de requête est présenté ci-dessous.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "copyPaste": { "source": { "sheetId":SHEET_ID
, "startRowIndex": 0, "endRowIndex": 10, "startColumnIndex": 0, "endColumnIndex": 4 }, "destination": { "sheetId":SHEET_ID
, "startRowIndex": 0, "endRowIndex": 10, "startColumnIndex": 5, "endColumnIndex": 9 }, "pasteType": "PASTE_FORMAT", "pasteOrientation": "NORMAL" } } ] }
Couper et coller des cellules
Les éléments suivants :
spreadsheets.batchUpdate
exemple de code montre comment utiliser
CutPasteRequest
Il coupe la plage A1:D10 et utilise le
Énumération PasteType
avec PASTE_NORMAL
pour coller ses valeurs, ses formules, sa mise en forme et ses fusions dans le
F1:I10 dans la même feuille. Le contenu des cellules de la plage source d'origine est
supprimés.
Le protocole de requête est présenté ci-dessous.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "cutPaste": { "source": { "sheetId":SHEET_ID
, "startRowIndex": 0, "endRowIndex": 10, "startColumnIndex": 0, "endColumnIndex": 4 }, "destination": { "sheetId":SHEET_ID
, "rowIndex": 0, "columnIndex": 5 }, "pasteType": "PASTE_NORMAL" } } ] }
Répéter une formule sur une plage
Les éléments suivants :
spreadsheets.batchUpdate
exemple de code montre comment utiliser
RepeatCellRequest
pour copier la formule =FLOOR(A1*PI())
dans la plage B1:D10. La plage de la formule
automatiquement pour chaque ligne et colonne de la plage, en commençant par
cellule en haut à gauche. Par exemple, la cellule B1 contient la formule =FLOOR(A1*PI())
, tandis que
la cellule D6 contient la formule =FLOOR(C6*PI())
.
Le protocole de requête est présenté ci-dessous.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{
"requests": [
{
"repeatCell": {
"range": {
"sheetId": SHEET_ID
,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 1,
"endColumnIndex": 4
},
"cell": {
"userEnteredValue": {
"formulaValue": "=FLOOR(A1*PI())"
}
},
"fields": "userEnteredValue"
}
}
]
}
Trier une plage avec plusieurs spécifications de tri
Les éléments suivants :
spreadsheets.batchUpdate
exemple de code montre comment utiliser
SortRangeRequest
pour trier la plage A1:D10, d'abord par la colonne B dans l'ordre croissant, puis par la colonne C
dans l’ordre décroissant, puis par
la colonne D dans l’ordre décroissant.
Le protocole de requête est présenté ci-dessous.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{
"requests": [
{
"sortRange": {
"range": {
"sheetId": SHEET_ID
,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 4
},
"sortSpecs": [
{
"dimensionIndex": 1,
"sortOrder": "ASCENDING"
},
{
"dimensionIndex": 2,
"sortOrder": "DESCENDING"
},
{
"dimensionIndex": 3,
"sortOrder": "DESCENDING"
}
]
}
}
]
}