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'un tableau ?

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 la fonctionnalité et découvrez comment utiliser des 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 un tableau, utilisez la méthode batchUpdate en fournissant une requête addTable. Vous utilisez cette requête pour ajouter un tableau à la feuille de calcul.

L'exemple suivant crée une table nommée "Project Tracker" au range spécifié avec deux colonnes définies. Une colonne de pourcentage dans la première colonne et une colonne de type "menu 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, comme numérique, date, menu déroulant, chip intelligent ou case à cocher. Les types de colonnes "Note" et "Case à cocher" sont remplis avec les valeurs par défaut 0 et FALSE, respectivement.

Le type de colonne "menu déroulant" crée un menu déroulant à puces. Si le type d'une colonne est défini sur "menu déroulant", le 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 une UpdateTableRequest.

Modifier la taille du tableau

Utilisez la méthode UpdateTableRequest pour modifier le range que la table doit ajouter pour les nouvelles 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, le range s'étend d'une ligne. Si vous mettez à jour une table existante avec un pied de page et que vous le supprimez, le range diminue d'une ligne.

Ajouter des valeurs à un tableau

Utilisez AppendCellsRequest avec tableId pour ajouter des lignes à la fin d'un tableau. Cette fonction ajoute les valeurs à la première ligne libre et tient compte des lignes complètes et des pieds de page. S'il n'y a pas de lignes vides, 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 une DeleteTableRequest. Utilisez DeleteTableRequest pour supprimer l'intégralité de la table et son contenu.

Utilisez DeleteBandingRequest pour supprimer la mise en forme du tableau, mais conserver les données.

Utiliser des tableaux avec d'autres fonctionnalités Sheets

D'autres fonctionnalités de l'API qui permettent d'utiliser des tableaux comme données sous-jacentes incluent les filtres, les vues filtrées et les plages protégées.