Tables

Ce guide explique comment et pourquoi utiliser l'API Google Sheets pour créer des tableaux dans vos feuilles de calcul.

Qu'est-ce qu'une table ?

Les tableaux vous permettent de simplifier la création de données et de réduire le besoin de mettre en forme, saisir et mettre à jour des données de manière répétée. Pour cela, ils appliquent automatiquement une mise en forme et une structure aux plages de données.

Les tableaux comportent de nombreuses fonctionnalités, telles que des en-têtes, des pieds de page, des types de colonnes, des filtres, des vues, des références de tableaux et des noms de tableaux. Pour en savoir plus, consultez l'annonce de cette fonctionnalité et découvrez comment utiliser les tableaux dans Sheets.

Vous pouvez utiliser des tableaux pour des tâches telles que le suivi de projets, la planification d'événements et la gestion des stocks.

Ajouter un tableau

Pour ajouter une table, utilisez la méthode batchUpdate en fournissant une requête addTable. Vous utiliserez cette requête pour ajouter un tableau à la feuille de calcul.

L'exemple suivant crée une table nommée "Project Tracker" à l'emplacement range spécifié avec deux colonnes définies. Une colonne de pourcentage dans la première colonne et un type de colonne déroulant dans la deuxième colonne.

{
  "addTable": {
    "table": {
      "name": "Project Tracker",
      "tableId": "123",
      "range": {
        "sheetId": 0,
        "startColumnIndex": 0,
        "endColumnIndex": 5,
        "startRowIndex": 0,
        "endRowIndex": 5,
      },
      "columnProperties": [
        {
          "columnIndex": 0,
          "columnName": "Column 1",
          "columnType": "PERCENT"
        },
        {
          "columnIndex": 1,
          "columnName": "Column 2",
          "columnType": "DROPDOWN",
          "dataValidationRule": {
            "condition": {
              "type": "ONE_OF_LIST",
              "values": [
                {
                  "userEnteredValue": "Not Started"
                },
                {
                  "userEnteredValue": "In Progress"
                },
                {
                  "userEnteredValue": "Complete"
                }
              ]
            }
          }
        }
      ],
    }
  }
}

Types de colonnes

Les tableaux comportent des types de colonnes tels que numérique, date, menu déroulant, chip intelligent et case à cocher. Les types de colonnes "Note" et "Case à cocher" sont renseignés avec les valeurs par défaut 0 et FALSE, respectivement.

Le type de colonne déroulante crée un menu déroulant de chips. Si un type de colonne est défini comme une liste déroulante, l'dataValidationRule de la colonne doit être défini avec une condition ONE_OF_LIST. Les autres types de colonnes ne doivent pas définir le champ "dataValidationRule".

Mettre à jour une table

Utilisez la méthode spreadsheets.batchUpdate et fournissez un UpdateTableRequest.

Modifier la taille du tableau

Utilisez la méthode UpdateTableRequest pour modifier le range de la table afin d'ajouter des lignes/colonnes.

Si vous devez ajouter une ligne ou une colonne dans le tableau, utilisez InsertRangeRequest ou InsertDimensionRequest.

Si vous devez supprimer une ligne de tableau, vous pouvez utiliser DeleteRangeRequest. Sinon, vous pouvez utiliser DeleteDimensionRequest pour supprimer une ligne entière de la feuille de calcul.

Si vous mettez à jour une table existante sans pied de page pour en ajouter un, range se développe d'une ligne. Si vous mettez à jour une table existante avec un pied de page et que vous le supprimez, range diminue d'une ligne.

Ajouter des valeurs à un tableau

Utilisez AppendCellsRequest avec tableId pour ajouter des lignes à la fin d'une table. Les valeurs sont ajoutées à la première ligne libre et sont prises en compte pour les lignes et les pieds de page complets. Si aucune ligne n'est vide, des lignes sont insérées à la fin du tableau et avant tout pied de page, le cas échéant.

Supprimer une table

Utilisez la méthode spreadsheets.batchUpdate et fournissez un DeleteTableRequest. Utilisez DeleteTableRequest pour supprimer l'intégralité de la table et son contenu.

Utilisez DeleteBandingRequest pour supprimer le formatage du tableau, mais conserver les données.

Utiliser des tableaux avec d'autres fonctionnalités Sheets

Les autres fonctionnalités de l'API qui acceptent les tableaux comme données de base incluent les filtres, les vues de filtre et les plages protégées.