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 peuvent simplifier la création de données et 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 de l'inventaire.

Ajouter un tableau

Pour ajouter un tableau, utilisez la batchUpdate et fournissez une requête addTable. Cette requête permet d'ajouter un tableau à la feuille de calcul.

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

Le type de colonne de menu déroulant crée un menu déroulant de chip. Si un type de colonne est défini sur "menu déroulant", la dataValidationRule de la colonne doit être définie avec une condition ONE_OF_LIST. Les autres types de colonnes ne doivent pas définir le champ `dataValidationRule`.

Mettre à jour un tableau

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

Modifier la taille du tableau

Utilisez la méthode UpdateTableRequest pour modifier la range que le tableau doit ajouter de 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 un tableau existant sans pied de page pour en ajouter un, la range s'étend sur une ligne. Si vous mettez à jour un tableau existant avec un pied de page et que vous le supprimez, la range est réduite d'une ligne.

Ajouter des valeurs à un tableau

Utilisez AppendCellsRequest avec tableId pour ajouter des lignes à la fin d'un tableau. Cette opération 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, cette opération insère des lignes à la fin du tableau et avant tout pied de page, le cas échéant.

Supprimer un tableau

Utilisez la spreadsheets.batchUpdate méthode et fournissez une DeleteTableRequest. Utilisez DeleteTableRequest pour supprimer l'intégralité du tableau 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

Les filtres,les vues filtrées etles plages protégées sont d'autres fonctionnalités de l'API qui prennent en charge les tableaux comme données de sauvegarde.