Opérations sur la table

L'API Google Slides vous permet de créer et de modifier des tableaux sur des pages. Les exemples sur cette page présente quelques opérations de table courantes à l'aide du presentations.batchUpdate .

Ces exemples utilisent les variables suivantes:

  • PRESENTATION_ID : indique où vous fournissez le présentation ID. Vous pouvez découvrir la valeur de cet ID à partir de l'URL de la présentation.
  • PAGE_ID : indique où vous fournissez l'objet Page ID. Vous pouvez récupérer la valeur à partir de l'URL ou à l'aide d'une requête de lecture d'API.
  • TABLE_ID : indique où vous fournissez la page ID d'objet d'élément pour un tableau sur lequel vous travaillez. Vous pouvez spécifier cet ID pour les éléments que vous créez (avec des restrictions) ou autoriser l'API Slides à en créer une automatiquement. ID des éléments peuvent être récupérées via une requête de lecture API.

Ces exemples sont présentés comme des requêtes HTTP afin de ne pas tenir compte du langage. Pour apprendre comment implémenter une mise à jour groupée dans différents langages à l'aide de l'API Google ; bibliothèques clientes, consultez la section Ajouter des formes texte.

Créer une table

Les éléments suivants : presentations.batchUpdate exemple de code montre comment utiliser CreateTableRequest pour ajouter un tableau à une diapositive spécifiée par PAGE_ID.

Ce tableau comporte huit lignes et cinq colonnes. Notez que l'API Slides ignore tous les champs size ou transform fournis dans le cadre de elementProperties Au lieu de cela, l'API crée un tableau à peu près centré sur la diapositive redimensionné pour accueillir le nombre spécifié de lignes et de colonnes, si possible.

Voici le protocole de requête permettant de créer une table:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createTable": {
        "objectId": TABLE_ID,
        "elementProperties": {
          "pageObjectId": PAGE_ID,
        },
        "rows": 8,
        "columns": 5
      }
    }
  ]
}

Supprimer des lignes ou des colonnes d'un tableau

Les éléments suivants : presentations.batchUpdate exemple de code montre comment utiliser DeleteTableRowRequest pour supprimer la sixième ligne. Il utilise ensuite DeleteTableColumnRequest pour supprimer la quatrième colonne. Le tableau est spécifié par le paramètre TABLE_ID Les rowIndex et les columnIndex dans les Les cellLocation sont basés sur zéro.

Voici le protocole de requête permettant de supprimer des lignes ou des colonnes d'une table:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "deleteTableRow": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 5
        }
      }
    },
    {
      "deleteTableColumn": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "columnIndex": 3
        }
      }
    }
  ]
}

Modifier les données d'une table

Les éléments suivants : presentations.batchUpdate exemple de code montre comment utiliser DeleteTextRequest pour supprimer tout le texte d'une cellule au sein de textRange Il utilise ensuite InsertTextRequest pour la remplacer par le nouveau texte "Kangaroo".

La table est spécifiée par TABLE_ID. La cellule concernée se trouve la cinquième ligne et la troisième colonne. Les rowIndex et les columnIndex dans les cellLocation sont basés sur zéro.

Voici le protocole de requête permettant de modifier les données d'une table:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "deleteText": {
        "objectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 4,
          "columnIndex": 2
        },
        "textRange": {
          "type": "ALL",
        }
      }
    },
    {
      "insertText": {
        "objectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 4,
          "columnIndex": 2
        },
        "text": "Kangaroo",
        "insertionIndex": 0
      }
    }
  ]
}

Mettre en forme une ligne d'en-tête de tableau

Les éléments suivants : presentations.batchUpdate exemple de code montre comment utiliser UpdateTableCellPropertiesRequest pour mettre en forme la ligne d'en-tête d'un élément de tableau, dans la tableRange spécifié par la TABLE_ID. Il utilise ensuite TableCellProperties pour définir la couleur d'arrière-plan de la ligne d'en-tête sur noir.

Chaque requête suivante utilise le paramètre UpdateTextStyleRequest permettant de définir le format du texte dans une cellule de la ligne d'en-tête en gras, blanc 18 pt Police Cambria dans la textRange Toi puis répéter cette requête pour chaque cellule supplémentaire de l'en-tête.

Les rowIndex et columnIndex dans les location et Les cellLocation sont basés sur zéro.

Voici le protocole de requête permettant de mettre en forme une ligne d'en-tête de tableau:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "updateTableCellProperties": {
        "objectId": TABLE_ID,
        "tableRange": {
          "location": {
            "rowIndex": 0,
            "columnIndex": 0
          },
          "rowSpan": 1,
          "columnSpan": 3
        },
        "tableCellProperties": {
          "tableCellBackgroundFill": {
            "solidFill": {
              "color": {
                "rgbColor": {
                  "red": 0.0,
                  "green": 0.0,
                  "blue": 0.0
                }
              }
            }
          }
        },
        "fields": "tableCellBackgroundFill.solidFill.color"
      }
    },
    {
      "updateTextStyle": {
        "objectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 0,
          "columnIndex": 0
        },
        "style": {
          "foregroundColor": {
            "opaqueColor": {
              "rgbColor": {
                "red": 1.0,
                "green": 1.0,
                "blue": 1.0
              }
            }
          },
          "bold": true,
          "fontFamily": "Cambria",
          "fontSize": {
            "magnitude": 18,
            "unit": "PT"
          }
        },
        "textRange": {
          "type": "ALL"
        },
        "fields": "foregroundColor,bold,fontFamily,fontSize"
      }
    },
    // Repeat the above request for each additional cell in the header row....
  ]
}

Voici à quoi ressemble la ligne d'en-tête mise en forme après ces modifications:

Formate le résultat de la recette pour la ligne d'en-tête.

Insérer des lignes ou des colonnes dans un tableau

Les éléments suivants : presentations.batchUpdate exemple de code montre comment utiliser InsertTableRowsRequest pour ajouter trois lignes sous la sixième ligne. Il utilise ensuite InsertTableColumnsRequest pour ajouter deux colonnes à gauche de la quatrième colonne dans le même tableau.

La table est spécifiée par TABLE_ID. Les rowIndex et les columnIndex dans cellLocation sont basées sur zéro.

Voici le protocole de requête permettant d'insérer des lignes ou des colonnes de table:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "insertTableRows": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 5
        },
        "insertBelow": true,
        "number": 3
      }
    },
    {
      "insertTableColumns": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "columnIndex": 3
        },
        "insertRight": false,
        "number": 2
      }
    }
  ]
}