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:
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 } } ] }