L'API Slides vous permet de gérer les fichiers de présentation existants et d'en créer d'autres. Les exemples de cette page présentent des opérations de présentation courantes pouvant être effectuées avec l'API.
Ces exemples utilisent les variables suivantes:
- presentationId : indique l'endroit où vous fournissez l'ID de présentation. Vous pouvez découvrir la valeur de cet ID à partir de l'URL de la présentation.
- pageId : indique où vous fournissez l'ID d'objet de page. Vous pouvez récupérer la valeur à partir de l'URL ou d'une requête de lecture de l'API.
- pageElementId : indique l'endroit où vous fournissez l'ID d'objet de l'élément de page. Vous pouvez spécifier cet ID pour les éléments que vous créez (avec certaines restrictions) ou autoriser l'API à en créer un automatiquement. Les ID d'élément peuvent être récupérés via une requête de lecture de l'API.
Créer une présentation
La requête presentations.create suivante crée un fichier de présentation vide intitulé "My New Presentation" (Ma nouvelle présentation).
Il est également possible de créer des fichiers de présentation vides à l'aide de la méthode Files.create de l'API Google Drive, en spécifiant application/vnd.google-apps.presentation comme mimeType.
Le protocole de requête est présenté ci-dessous. Le guide Créer et gérer des présentations présente un exemple mettant en œuvre une mise à jour par lot dans différents langages à l'aide des bibliothèques clientes de l'API Google.
POST https://slides.googleapis.com/v1/presentations
{
"title": "My New Presentation"
}
Répertorier les fichiers de présentation existants
L'API Slides ne fournit pas de méthode pour récupérer la liste des présentations, mais cela peut être réalisé facilement avec l'API Drive. La requête Files.list de l'API Drive présentée ici utilise des masques de champ pour renvoyer une liste de fichiers de présentation dans votre Drive, avec les ID et les titres des fichiers, ainsi qu'un lien.
Le protocole de requête est présenté ci-dessous. Le guide Rechercher des fichiers de l'API Drive montre un exemple qui implémente une requête de recherche de fichiers dans différents langages à l'aide des bibliothèques clientes de l'API Google.
GET https://www.googleapis.com/drive/v3/files?q="mimeType=application/vnd.google-apps.presentation"&fields=files(id,name,webViewLink)
La réponse à cette requête présente la structure suivante:
{
"files": [
{
"id": "abcdefghijklmnopqrstuvwxyz0123456789",
"name": "Project Vision",
"webViewLink": "https://docs.google.com/a/google.com/presentation/d/abcdefghijklmnopqrstuvwxyz0123456789/edit?usp=drivesdk"
},
{
"id": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789",
"name": "Untitled Presentation",
"webViewLink": "https://docs.google.com/a/google.com/presentation/d/ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/edit?usp=drivesdk"
},
...
]
}
Remplacer le texte d'une présentation
La requête presentations.batchUpdate suivante remplace du texte dans toute la présentation spécifiée par presentationId. Chaque instance de la chaîne "Gizmo Corp." est remplacée par le texte "Gadget Inc." Cela inclut le texte dans les zones de texte et autres formes, sur les diapositives et sur les masques. Dans ce cas, le texte de remplacement est sensible à la casse.
Le protocole de requête est présenté ci-dessous. Le guide Fusionner les données dans Slides montre un exemple qui implémente une mise à jour par lot dans différents langages à l'aide des bibliothèques clientes de l'API Google.
POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate
{
"requests": [
{
"replaceAllText": {
"containsText": {
"text": "Gizmo Corp.",
"matchCase": true
},
"replaceText": "Gadget Inc."
}
}
]
}