Présentation

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.

Utiliser 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
Travailler avec des graphiques: CreateSheetsChartRequest
RefreshSheetsChartRequest
ReplaceAllShapesWithSheetsChartRequest
DeleteObjectRequest
Utilisation des images et des vidéos: CreateImageRequest
CreateVideoRequest
UpdateImagePropertiesRequest
UpdateVideoPropertiesRequest
ReplaceAllShapesWithImageRequest
DuplicateObjectRequest
DeleteObjectRequest
Travailler avec du texte: InsertTextRequest
DeleteTextRequest
ReplaceAllTextRequest
CreateParagraphBulletsRequest
DeleteParagraphBulletsRequest
UpdateTextStyleRequest
UpdateParagraphStyleRequest

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().