Introduction

L'API Google Slides vous permet de créer et de modifier des présentations Google Slides.

Les applications peuvent s'intégrer à l'API Google Slides pour créer automatiquement de superbes présentations de diapositives à partir de données fournies par l'utilisateur et le système. Par exemple, vous pouvez utiliser les informations sur les clients d'une base de données et les combiner avec des modèles prédéfinis et des options de configuration sélectionnées pour créer des présentations terminées en une fraction du temps qu'il faudrait pour les créer manuellement.

Présentation de l'API

La collection presentations fournit des méthodes qui vous permettent d'obtenir et de mettre à jour des éléments dans la présentation.

Vous utiliserez probablement l'API Slides pour créer et mettre à jour des présentations. Pour ce faire, utilisez la méthode batchUpdate, qui utilise une liste d'objets Request qui vous permettent, par exemple, d'effectuer les opérations suivantes:

  • Créer des diapositives
  • Ajouter des éléments aux diapositives, comme des formes ou des tableaux
  • Insérer, modifier et supprimer du texte
  • Appliquer des transformations aux éléments
  • Modifier l'ordre des diapositives

Pour en savoir plus, consultez la section Mises à jour groupées. Consultez les guides de démarrage pour obtenir un exemple simple d'utilisation de l'API.

La structure d'une présentation

Dans l'API Slides, une présentation est constituée de pages qui contiennent des éléments de page.

L'ID d'une présentation peut être dérivé de l'URL:

https://docs.google.com/presentation/d/presentationId/edit

L'ID de présentation est une chaîne contenant des lettres, des chiffres et des caractères spéciaux. L'expression régulière suivante peut être utilisée pour extraire l'ID de présentation à partir d'une URL Google Sheets:

/presentation/d/([a-zA-Z0-9-_]+)

Si vous connaissez l'API Drive, presentationId correspond à l'ID de la ressource File.

Les pages et leurs éléments sont identifiés par des ID d'objet.

Pages

Google Slides propose les types de pages suivants:

Diplôme de maîtrise Les masques de diapositives définissent les styles de texte, l'arrière-plan et les éléments de page par défaut qui apparaissent sur toutes les diapositives qui utilisent ce masque. Les éléments de page qui doivent apparaître sur toutes les diapositives doivent être ajoutés au masque. La plupart des présentations disposent d'un maître, mais certaines peuvent en avoir plusieurs ou aucune.
Mises en page Les mises en page servent de modèle pour la disposition par défaut des éléments de page sur les diapositives utilisant une mise en page. Chaque mise en page est associée à un maître.
Slides Ces pages comportent le contenu que vous présentez à votre public. La plupart des diapositives sont basées sur un masque et une mise en page. Vous pouvez spécifier la mise en page à utiliser pour chaque diapositive lors de sa création.
Remarques Ces pages contiennent le contenu des documents de présentation, y compris une forme qui contient les commentaires du présentateur de la diapositive. Chaque diapositive est associée à une page de notes. Seul le texte de la forme des commentaires du présentateur peut être modifié à l'aide de l'API Slides.
Maîtres de notes Les notes maîtres définissent les styles de texte et les éléments de page par défaut pour toutes les pages de notes. Les messages maîtres Notes sont en lecture seule dans l'API Slides.

Éléments de la page

Les éléments de page sont les composants visuels placés sur les pages. L'API expose plusieurs types d'éléments de page:

Groupe Ensemble d'éléments de page traités comme une unité individuelle. Ils peuvent être déplacés, mis à l'échelle et pivotés ensemble.
Forme Objet visuel simple, tel que des rectangles, des ellipses et des zones de texte. Les formes peuvent contenir du texte. Ce sont donc les éléments de page les plus courants pour créer des diapositives.
Image Graphique importé dans Slides.
Vidéo Une vidéo importée dans Slides.
Line Une ligne visuelle, une courbe ou un connecteur.
Table Grille de contenu.
WordArt Élément de texte visuel qui se comporte davantage comme une forme.
SheetsChart Graphique importé dans Slides à partir de Google Sheets.

Mises à jour groupées

La méthode batchUpdate vous permet de mettre à jour de nombreux aspects d'une présentation. Les modifications sont regroupées dans un lot de sorte qu'en cas d'échec d'une requête, aucune des autres modifications (potentiellement dépendantes) ne soit écrite.

La méthode batchUpdate fonctionne en prenant un ou plusieurs objets Request, chacun spécifiant un seul type de requête à effectuer. Il existe de nombreux types de requêtes différents. Voici une répartition des types de requêtes, groupées en différentes catégories.

Utilisation de Slides: CreateSlideRequest
UpdateSlidesPositionRequest
DuplicateObjectRequest
UpdatePagePropertiesRequest
DeleteObjectRequest
Utilisation des éléments de la page: CreateShapeRequest
CreateLineRequest
UpdatePageElementTransformRequest
UpdateShapePropertiesRequest
DuplicateObjectRequest
DeleteObjectRequest
Utiliser des tables: CreateTableRequest
InsertTableRowsRequest
InsertTableColumnsRequest
DeleteTableRowRequest
DeleteTableColumnRequest
UpdateTableRowPropertiesRequest
UpdateTableColumnPropertiesRequest
UpdateTableBorderPropertiesRequest
UpdateTableCellPropertiesRequest
MergeTableCellsRequest
UnmergeTableCellsRequest
DeleteObjectRequest
Utiliser des graphiques: CreateSheetsChartRequest
RefreshSheetsChartRequest
ReplaceAllShapesWithSheetsChartRequest
DeleteObjectRequest
Travailler avec des images et des vidéos: CreateImageRequest
CreateVideoRequest
UpdateImagePropertiesRequest
UpdateVideoPropertiesRequest
ReplaceAllShapesWithImageRequest
DuplicateObjectRequest
DeleteObjectRequest
Utilisation du texte: InsertTextRequest
DeleteTextRequest
ReplaceAllTextRequest
CreateParagraphBulletsRequest
DeleteParagraphBulletsRequest
UpdateTextStyleRequest
UpdateParagraphStyleRequest

La méthode batchUpdate renvoie un corps de la réponse, qui contient une réponse pour chaque requête. Chaque réponse occupe le même index que la requête correspondante. Pour les requêtes sans réponse applicable, la réponse à cet index est vide. Les différentes requêtes Create ont normalement des réponses. Vous pouvez donc connaître l'ID du nouvel objet ajouté.

Utiliser des ID d'objet

Dans l'API Slides, une présentation est constituée de pages et d'éléments de page. Ces objets incluent une chaîne d'ID d'objet unique dans une présentation.

Spécifier des ID d'objet lors de la création

Lorsque vous créez des pages ou des éléments de page à l'aide de la méthode batchUpdate, vous pouvez éventuellement spécifier un ID d'objet pour le nouvel objet. Cela vous permet de créer un objet et de le modifier dans la même requête batchUpdate, ce qui réduit le nombre d'appels à l'API Slides et l'utilisation des quotas.

Dans la plupart des cas, nous vous recommandons de générer un ID d'objet aléatoire. Par exemple, si vous utilisez Java, java.util.UUID.randomUUID().toString() devrait fonctionner correctement.

Lorsque votre application souhaite effectuer le suivi des objets sur une période plus longue, ne vous fiez pas à l'ID de l'objet, car il peut changer. Pour en savoir plus, consultez la section suivante.

Suivre des objets sans utiliser leur ID

Lorsque vous envoyez une requête à l'API Slides, l'ID de l'objet est normalement conservé. (Toutes les exceptions sont indiquées dans la documentation de référence de la méthode.) La copie d'une présentation complète avec l'API Drive permet également de conserver les ID d'objet.

Toutefois, vous ne pouvez pas compter sur le maintien de l'ID d'objet après la modification d'une présentation dans l'interface utilisateur de Slides. Par exemple, si quelqu'un utilise l'interface utilisateur de Slides pour copier et coller un élément de page, puis supprime l'élément d'origine, celui-ci disposera désormais d'un nouvel identifiant unique, et l'identifiant que vous avez précédemment fourni via l'API sera perdu. Par conséquent, nous vous déconseillons de stocker les ID d'objet dans l'espace de stockage de votre application. À la place, vous devez trouver des objets dans la présentation par son contenu textuel ou texte alternatif.

Les présentations nouvellement créées utilisent généralement un ensemble cohérent d'ID pour les diapositives, les masques et les zones de texte par défaut. Comme ces ID peuvent changer au fil du temps, nous vous déconseillons d'utiliser cette fonctionnalité. Recherchez plutôt les éléments que vous souhaitez modifier à l'aide de l'objet de présentation renvoyé par les appels à create() ou get().