Opérations de présentation

L'API Google Slides vous permet de créer des fichiers de présentation et de gérer les fichiers existants. Les exemples de cette page présentent quelques opérations de présentation de page courantes à l'aide de la méthode presentations.batchUpdate.

Ces exemples sont présentés sous forme de requêtes HTTP pour être neutres en termes de langue. Pour savoir comment implémenter une mise à jour par lot 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 presentations.create suivant montre comment créer un fichier de présentation vierge intitulé "My New Presentation" (Ma nouvelle présentation).

Vous pouvez également créer des fichiers de présentation vierges à 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 permettant de récupérer une liste de présentations, mais l'API Drive le fait. La méthode files.list (présentée ci-dessous) utilise des masques de champ pour renvoyer une liste de fichiers de présentation à partir de votre Drive, avec l'ID de fichier, le nom du fichier et un lien permettant de l'ouvrir. La requête spécifie également application/vnd.google-apps.presentation comme type MIME.

Voici le protocole de requête permettant de 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 a 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 le texte dans l'ensemble de la présentation spécifiée par PRESENTATION_ID. Vous pouvez trouver la valeur de l'identifiant 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 d'autres formes, sur les diapositives et dans les maîtres. Dans cet exemple, le remplacement de texte est sensible à la casse en définissant matchCase sur true.

Voici le protocole de requête permettant de 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."
      }
    }
  ]
}