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 à partir de données fournies par l'utilisateur et le système. Par exemple, vous pouvez utiliser les informations client d'une base de données et les combiner à des modèles prédéfinis et à des options de configuration sélectionnées pour créer des présentations finalisées en une fraction du temps qu'il vous 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.
La plupart de votre travail avec l'API Slides consistera probablement à créer et à mettre à jour des présentations. Pour ce faire, utilisez la méthode batchUpdate. Cette méthode prend une liste d'objets Request qui vous permettent 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 par lot. Consultez les guides de démarrage pour obtenir un exemple simple et complet d'utilisation de l'API.
Structure d'une présentation
Une présentation dans l'API Slides se compose de pages, qui contiennent des éléments de page.
L'ID d'une présentation peut être obtenu à partir 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 certains caractères spéciaux. L'expression régulière suivante permet d'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 (Fichier).
Les pages et les éléments de page sont identifiés par des ID d'objet.
Pages
Google Slides propose les types de pages suivants:
| Masters | Les modèles de diapositives définissent les styles de texte, l'arrière-plan et les éléments de page par défaut qui apparaissent dans toutes les diapositives qui utilisent ce modèle. Les éléments de page qui doivent apparaître sur toutes les diapositives doivent être ajoutés au master. La plupart des présentations comportent un maître, mais certaines peuvent en avoir plusieurs ou aucun. |
| Mises en page | Les mises en page servent de modèle pour l'organisation par défaut des éléments de page sur les diapositives à l'aide d'une mise en page. Chaque mise en page est associée à un maître. |
| Slides | Ces pages contiennent le contenu que vous présentez à votre audience. La plupart des diapositives sont basées sur un modèle 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 supports de présentation, y compris une forme contenant les notes 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é avec l'API Slides. |
| Masters de notes | Les maîtres de notes définissent les styles de texte et les éléments de page par défaut pour toutes les pages de notes. Les maîtres de 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. Vous pouvez les déplacer, les redimensionner et les faire pivoter ensemble. |
| Forme | Objet visuel simple, tel que des rectangles, des ellipses et des zones de texte. Les formes peuvent contenir du texte. Elles sont donc les éléments de page les plus courants pour créer des diapositives. |
| Image | Graphique importé dans Slides. |
| Vidéo | Vidéo importée dans Slides. |
| Ligne | Une ligne, une courbe ou un connecteur visuel |
| Tableau | Grille de contenu. |
| WordArt | Élément textuel visuel qui se comporte davantage comme une forme. |
| SheetsChart | Graphique importé dans Slides depuis Google Sheets. |
Mises à jour groupées
La méthode batchUpdate vous permet de modifier de nombreux aspects d'une présentation. Les modifications sont regroupées dans un lot afin que, si une requête échoue, aucune des autres modifications (potentiellement dépendantes) ne soit écrite.
La méthode batchUpdate utilise un ou plusieurs objets Request, chacun spécifiant un seul type de requête à effectuer. Il existe de nombreux types de requêtes. Voici une répartition des types de demandes, regroupées en différentes catégories.
La méthode batchUpdate renvoie un corps de 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 sera vide. Les différentes requêtes Create ont généralement des réponses, ce qui vous permet de connaître l'ID de l'objet nouvellement ajouté.
Utiliser des ID d'objet
Une présentation dans l'API Slides est composée de pages et d'éléments de page. Ces objets incluent une chaîne d'identifiant 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. Vous pouvez ainsi créer un objet et 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 suivre les objets sur une période plus longue, ne vous appuyez pas sur l'ID de l'objet, car il peut changer. Pour en savoir plus, consultez la section suivante.
Suivre les objets sans utiliser l'ID de l'objet
Lorsque vous effectuez une requête d'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.) Créer une copie de l'intégralité d'une présentation avec l'API Drive permet également de conserver les ID d'objet.
Toutefois, vous ne pouvez pas vous attendre à ce qu'un ID d'objet reste inchangé 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-coller un élément de page, puis supprime l'élément d'origine, l'élément de page aura désormais un nouvel ID unique, et l'ID que vous avez précédemment fourni via l'API sera perdu. Par conséquent, nous vous déconseillons de stocker des ID d'objet dans l'espace de stockage de votre application. Recherchez plutôt les objets dans la présentation par leur contenu textuel ou leur texte alternatif.
Les présentations nouvellement créées utilisent généralement un ensemble cohérent d'ID pour les diapositives, les modèles et les zones de texte par défaut. Ces ID sont susceptibles d'évoluer au fil du temps. Nous vous déconseillons donc de vous fier à 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().