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 des présentations attrayantes à partir de données fournies par l'utilisateur et le système. Par exemple, vous pouvez utiliser les coordonnées de clients issues 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 finalisées en un temps beaucoup plus court que si vous les créiez manuellement.
Présentation de l'API
La collection de présentations fournit des méthodes qui vous permettent d'obtenir et de mettre à jour des éléments dans la présentation.
La plupart du temps, vous utiliserez l'API Slides pour créer et mettre à jour des présentations. Pour ce faire, vous utiliserez la méthode batchUpdate ; cette méthode accepte une liste d'objets Request qui vous permettent d'effectuer des opérations telles que les 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 aux éléments
- Modifier l'ordre des diapositives
Pour en savoir plus, consultez Mises à jour groupées. Consultez les guides Premiers pas pour obtenir un exemple simple de bout en bout d'utilisation de l'API.
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 certains caractères spéciaux. L'expression régulière suivante peut être utilisée pour extraire l'ID de présentation d'une URL Google Sheets :
/presentation/d/([a-zA-Z0-9-_]+)
Si vous connaissez l'API Drive, le presentationId
correspond à l'ID de la
ressource
File.
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 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 page qui doivent apparaître sur toutes les diapositives doivent être ajoutés au masque. La plupart des présentations comportent un seul masque, mais certaines peuvent en avoir plusieurs ou aucun. |
| 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 masque. |
| Diapositives | Ces pages contiennent le contenu que vous présentez à votre audience. 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 contenant les commentaires du présentateur de la diapositive. Chaque diapositive possède une page de notes correspondante. Seul le texte 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 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. 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. Elles sont donc les éléments de page les plus courants pour créer des diapositives. |
| Image | Élément graphique importé dans Slides. |
| Vidéo | Vidéo importée dans Slides. |
| Ligne | Ligne, courbe ou connecteur visuel. |
| Tableau | Grille de contenu. |
| WordArt | Élément de texte 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 mettre à jour de nombreux aspects d'une présentation. Les modifications sont regroupées dans un lot. Ainsi, si une requête échoue, aucune des autres modifications (potentiellement dépendantes) n'est écrite.
La méthode batchUpdate fonctionne en prenant un ou plusieurs
Request
objets, chacun spécifiant un seul type de requête à effectuer. Il existe de nombreux types de requêtes différents. Voici une présentation 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 ont normalement des réponses, ce qui vous permet de connaître l'ID de l'objet nouvellement ajouté.
Utiliser des ID d'objet
Dans l'API Slides, une présentation est composée de pages et d'éléments de page. Ces objets incluent une chaîne 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
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 minimise le nombre d'appels à l'API Slides et réduit l'utilisation du quota.
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 des objets sur une période plus longue, ne vous fiez pas à l'ID d'objet, car il peut changer. Pour en savoir plus, consultez la section suivante.
Suivre des objets sans utiliser l'ID d'objet
Lorsque vous effectuez une requête d'API Slides, l'ID d'objet est normalement conservé. (Toute exception est indiquée dans la documentation de référence de la méthode.) La création d'une copie d'une présentation entière avec l'API Drive préserve également les ID d'objet.
Toutefois, vous ne pouvez pas compter sur l'ID d'objet pour rester inchangé après la modification d'une présentation dans l'interface utilisateur Slides. Par exemple, si une personne utilise l'interface utilisateur Slides pour copier-coller un élément de page, puis supprime l'original, 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 le stockage de votre application. Vous devez plutôt rechercher des objets dans la présentation par leur contenu textuel ou leur 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().