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 sur le client provenant 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 un temps très court pour les créer manuellement.
Présentation de l'API
La collection presentations fournit des méthodes vous permettant d'obtenir et de mettre à jour des éléments de la présentation.
La majeure partie 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. Celle-ci utilise une liste d'objets Request qui vous permet d'effectuer les opérations suivantes:
- Créer des diapositives
- Ajouter des éléments aux diapositives, tels que des formes ou des tableaux
- Insérer, modifier et supprimer du texte
- Appliquer des transformations à des é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 de bout en bout sur l'utilisation de l'API.
La structure d’une présentation
Dans l'API Slides, une présentation est composé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 (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:
| Diplôme de maîtrise | Les masques de diapositive 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 utilisant ce masque. Les éléments de la page qui doivent apparaître sur toutes les diapositives doivent être ajoutés au masque. La plupart des présentations ont un masque, mais certaines peuvent en avoir plusieurs, voire aucune. |
| Mises en page | Les mises en page servent de modèle pour définir la façon dont les éléments de la page seront disposés par défaut sur les diapositives à l'aide d'une mise en page. Chaque mise en page est associée à un maître. |
| Diapositives | Ces pages incluent le contenu que vous présentez à votre public. La plupart des diapositives sont basées sur un maître 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 a une page de notes correspondante. Seul le texte dans la forme des commentaires du présentateur peut être modifié avec l'API Slides. |
| Masques de notes | Les masques de notes définissent les styles de texte et les éléments de page par défaut pour toutes les pages de notes. Les masques 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 seule unité. 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 pouvant contenir du texte, ce sont 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 |
| Ligne | Ligne visuelle, courbe ou connecteur. |
| Table | Une grille de contenu. |
| WordArt | Élément textuel 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 que si une requête échoue, aucune des autres modifications (potentiellement dépendantes) n'est écrite.
La méthode batchUpdate utilise un ou plusieurs objets Request, chacun spécifiant un seul type de requête à exécuter. Il existe de nombreux types de requêtes différents. Voici une répartition des types de requêtes,
regroupés 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 comportent normalement des réponses, ce qui vous permet de connaître l'ID du nouvel objet ajouté.
Utiliser des ID d'objets
Dans l'API Slides, une présentation est composé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'objets 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 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.
Effectuer le suivi des objets sans utiliser leur ID
Lorsque vous envoyez une requête API Slides, l'ID d'objet est normalement conservé. (Toutes les exceptions sont mentionnées dans la documentation de référence de la méthode.) En outre, les ID d'objets sont conservés lorsque vous copiez l'intégralité d'une présentation à l'aide de l'API Drive.
Toutefois, vous ne pouvez pas compter sur le fait qu'un ID d'objet reste inchangé après qu'une présentation a été modifiée 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 disposera désormais d'un nouvel ID unique et l'ID que vous avez fourni précédemment via l'API sera perdu. Par conséquent, nous vous déconseillons de stocker les ID d'objets dans l'espace de stockage de votre application. À la place, vous devez trouver des objets dans la présentation par son contenu textuel ou son texte alternatif.
Les présentations nouvellement créées utilisent normalement un ensemble cohérent d'ID pour les diapositives, les masques et les zones de texte par défaut. Ces ID sont susceptibles de changer 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().