L'API Google Sheets vous permet de créer, modifier et supprimer des feuilles nommées ou protégées plages. Les exemples de cette page montrent comment obtenir des Opérations Sheets 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.
De plus, les espaces réservés NAMED_RANGE_ID
et PROTECTED_RANGE_ID
fournir les ID des plages nommées et protégées. Les namedRangeId
et
Les protectedRangeId
sont utilisés lorsque vous effectuez des requêtes pour mettre à jour ou supprimer le
plages associées. L'ID est renvoyé dans la réponse à une API Sheets.
qui crée une plage nommée ou protégée. Vous pouvez obtenir les identifiants
plages avec le paramètre
spreadsheets.get
, dans
la
Spreadsheet
corps de la réponse.
Ajouter des plages nommées ou protégées
Les éléments suivants :
spreadsheets.batchUpdate
exemple de code montre comment utiliser deux objets de requête. La première utilise
AddNamedRangeRequest
pour attribuer à la plage A1:E3 le nom « Nombres ». La seconde utilise
AddProtectedRangeRequest
pour associer une protection de niveau d'avertissement
à la plage A4:E4. Ce niveau de protection
autorise toujours la modification des cellules de la plage, mais un avertissement s'affiche avant
d'effectuer le changement.
Ces requêtes renvoient un
AddNamedRangeResponse
et un
AddProtectedRangeResponse
contenant les identifiants et les propriétés de la plage.
Le protocole de requête est présenté ci-dessous.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "addNamedRange": { "namedRange": { "name": "Counts", "range": { "sheetId":SHEET_ID
, "startRowIndex": 0, "endRowIndex": 3, "startColumnIndex": 0, "endColumnIndex": 5, }, } } }, { "addProtectedRange": { "protectedRange": { "range": { "sheetId":SHEET_ID
, "startRowIndex": 3, "endRowIndex": 4, "startColumnIndex": 0, "endColumnIndex": 5, }, "description": "Protecting total row", "warningOnly": true } } } ] }
Supprimer des plages nommées ou protégées
Les éléments suivants :
spreadsheets.batchUpdate
exemple de code montre comment utiliser deux objets de requête. La première utilise
DeleteNamedRangeRequest
pour supprimer une plage nommée existante, en utilisant le paramètre NAMED_RANGE_ID
d'une
l'appel d'API précédent. La seconde utilise
DeleteProtectedRangeRequest
pour supprimer une protection de plage existante, à l'aide du PROTECTED_RANGE_ID
à partir d'un appel d'API précédent.
Le protocole de requête est présenté ci-dessous.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "deleteNamedRange": { "namedRangeId": "NAMED_RANGE_ID
", } }, { "deleteProtectedRange": { "protectedRangeId":PROTECTED_RANGE_ID
, } } ] }
Mettre à jour des plages nommées ou protégées
Les éléments suivants :
spreadsheets.batchUpdate
exemple de code montre comment utiliser deux objets de requête. La première utilise
UpdateNamedRangeRequest
pour remplacer le nom d'une plage nommée existante par "InitialCounts", à l'aide de la propriété NAMED_RANGE_ID
à partir d'un appel d'API précédent. La seconde utilise
UpdateProtectedRangeRequest
pour mettre à jour une plage protégée existante afin qu'elle protège désormais
la plage d'adresses IP. La
Méthode Editors
n'autorise que les utilisateurs répertoriés
à modifier ces cellules. Cette requête utilise le NAMED_RANGE_ID
et PROTECTED_RANGE_ID
des appels d'API précédents.
Le protocole de requête est présenté ci-dessous.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "updateNamedRange": { "namedRange": { "namedRangeId":NAMED_RANGE_ID
, "name": "InitialCounts", }, "fields": "name", } }, { "updateProtectedRange": { "protectedRange": { "protectedRangeId":PROTECTED_RANGE_ID
, "namedRangeId":NAMED_RANGE_ID
, "warningOnly": false, "editors": { "users": [ "charlie@example.com", "sasha@example.com" ] } }, "fields": "namedRangeId,warningOnly,editors" } } ] }