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 de superbes présentations avec diapositives. automatiquement à partir des données fournies par l'utilisateur et le système. Par exemple, vous pouvez utiliser les informations sur les clients issues d'une base de données et les combiner à des modèles et options de configuration sélectionnées pour créer des présentations finalisées en une fraction du temps qu'il faudrait pour les créer manuellement.
Présentation de l'API
La collection presentations fournit qui vous permettent d'obtenir et de mettre à jour des éléments dans la présentation.
La majeure partie de votre travail avec l'API Slides consistera probablement à créer et mettre à jour vos présentations. Pour ce faire, vous utiliserez batchUpdate. cette méthode prend une liste Demander qui vous permettent 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. Consulter les guides de démarrage pour obtenir un exemple simple d'utilisation de l'API de bout en bout.
La structure d’une présentation
Dans l'API Slides, une présentation est composée de pages contenant éléments.
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. L'expression régulière suivante peut être utilisée pour extraire ID de présentation à partir d'une URL Google Sheets:
/presentation/d/([a-zA-Z0-9-_]+)
Si vous connaissez l'API Drive, le presentationId correspond à
ID du fichier
ressource.
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 le style de texte, l'arrière-plan et la page qui apparaissent dans toutes les diapositives utilisant ce masque. Page les éléments qui doivent apparaître sur toutes les diapositives doivent être ajoutés au masque. La plupart présentations ont un maître, mais certaines peuvent en avoir plusieurs ou n'en avoir aucune. |
| Mises en page | Les mises en page servent de modèle pour la façon dont les éléments de la page seront organisés par par défaut sur les diapositives à l'aide d'une mise en page. Chaque mise en page est associée à une maître. |
| Slides | 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 à utiliser pour chaque diapositive lors de sa création. |
| Remarques | Ces pages contiennent le contenu des documents de présentation, y compris un une forme qui contient les notes de l'orateur de la diapositive. Chaque diapositive a un la page de notes correspondante. Seul le texte inclus dans la forme des commentaires du présentateur 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 tous 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 qui sont placés sur les pages. L'API présente 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 peuvent contenir du texte, ce sont donc les éléments de page les plus courants à construire diapositives. |
| Image | Graphique importé dans Slides. |
| Vidéo | Une vidéo importée dans Slides |
| Ligne | Ligne visuelle, courbe ou connecteur. |
| Tableau | 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 qu'aucune des requêtes (potentiellement dépendantes) ne se produise. les modifications sont écrites.
La méthode batchUpdate fonctionne en prenant un ou plusieurs
Demander
chacun spécifiant un type de requête à exécuter. Il y a
de nombreux types de requêtes différents. Voici le détail des types de requêtes,
regroupées en
différentes catégories.
La méthode batchUpdate renvoie un corps de la réponse,
qui contient un
Réponse
pour chaque requête. Chaque réponse occupe le même index que la réponse
requête ; Pour les requêtes sans réponse applicable, la réponse à cet index
est vide. Les différentes requêtes Create comportent normalement des réponses, donc
que vous connaissez l'ID de l'objet que vous venez d'ajouter.
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 un 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 des batchUpdate, vous devez Vous pouvez éventuellement spécifier un ID pour le nouvel objet. Cela vous permet de créer et le modifier dans la même requête batchUpdate, ce qui réduit le nombre d'appels à l'API Slides et à réduire l'utilisation du quota.
Dans la plupart des cas, nous recommandons de générer un ID d'objet aléatoire. Par exemple, si vous
utilisent Java, java.util.UUID.randomUUID().toString() devrait fonctionner correctement.
Lorsque votre application souhaite effectuer le suivi d'objets sur une période plus longue ne vous fiez pas à l'ID de l'objet, car il peut changer. Consultez les ressources suivantes : pour en savoir plus.
Effectuer le suivi des objets sans utiliser leur ID
Lorsque vous envoyez une requête API Slides, l'ID d'objet est normalement conservé. (Tout ces exceptions sont présentées dans la documentation de référence de la méthode.) Créer une la copie de toute une présentation avec l'API Drive conserve également les ID d'objets.
Cependant, vous ne pouvez pas compter sur le fait qu'un ID d'objet reste inchangé après une présentation. est modifié dans l'interface utilisateur de Slides. Par exemple, si quelqu'un utilise Slides UI permettant de copier-coller un élément de page, puis de supprimer l'original, l'élément de page dispose désormais d'un nouvel identifiant unique, ainsi que de l'identifiant que vous avez fourni précédemment via l'API. seront perdues. Par conséquent, nous vous déconseillons de stocker les ID d'objets dans vos l'espace de stockage de l'application. Au lieu de cela, vous devez trouver des objets dans la présentation en son contenu textuel ou son texte alternatif.
Les présentations nouvellement créées utilisent normalement un ensemble cohérent d'ID par défaut diapositives, masques et zones de texte. Ces identifiants sont susceptibles de changer au fil du temps, Nous vous déconseillons donc de vous fier à cette fonctionnalité. Au lieu de cela, trouvez les éléments que vous souhaitez modifier à l'aide de l'objet de présentation renvoyé par les appels à create() ou get().