Opérations de présentation

L'API Google Slides vous permet de créer des fichiers de présentation et de gérer ceux qui existent déjà. Les exemples de cette page montrent quelques opérations courantes de présentation de pages à l'aide de la presentations.batchUpdate méthode.

Ces exemples sont présentés sous forme de requêtes HTTP pour être indépendants du langage. Pour découvrir comment implémenter une mise à jour groupée dans différents langages à l'aide des bibliothèques clientes des API Google, consultez les guides suivants :

Créer une présentation

L'exemple de code suivant presentations.create montre comment créer un fichier de présentation vide intitulé "Ma nouvelle présentation".

Vous pouvez également 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 type MIME.

Voici le protocole de requête pour créer une présentation :

POST https://slides.googleapis.com/v1/presentations
 
{
  "title": "My New Presentation"
}

Lister les fichiers de présentation existants

L'API Slides ne fournit pas de méthode pour récupérer une liste de présentations, mais l' API Drive en propose une. La méthode files.list (présentée ci-dessous) utilise des masques de champ pour renvoyer une liste de fichiers de présentation de votre Drive, avec l' ID de fichier, le nom de fichier et un lien permettant d'ouvrir le fichier. La requête spécifie également application/vnd.google-apps.presentation comme le type MIME.

Voici le protocole de requête pour lister les fichiers de présentation existants :

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 du texte dans une présentation

L'exemple de code presentations.batchUpdate suivant montre comment utiliser la méthode ReplaceAllTextRequest pour remplacer du texte dans la présentation spécifiée par le PRESENTATION_ID. Vous pouvez trouver la valeur de l' ID de présentation dans l'URL de la présentation.

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 dans les masques. Dans ce cas, le remplacement de texte est sensible à la casse, car matchCase est défini sur true.

Voici le protocole de requête pour remplacer du texte dans une présentation :

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
 
{
  "requests": [
    {
      "replaceAllText": {
          "containsText": {
            "text": "Gizmo Corp.",
            "matchCase": true
          },
          "replaceText": "Gadget Inc."
      }
    }
  ]
}