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. Les exemples de cette page illustrent des opérations de présentation de page courantes à l'aide de la presentations.batchUpdate .

Ces exemples sont présentés comme des requêtes HTTP afin de ne pas tenir compte du langage. Pour apprendre comment implémenter une mise à jour groupée dans différents langages à l'aide de l'API Google ; bibliothèques clientes, consultez les guides suivants:

Créer une présentation

Les éléments suivants : presentations.create exemple de code montre comment créer un fichier de présentation vierge intitulé "My New Présentation".

Il est également possible de créer des fichiers de présentation vierges à l'aide de l'API Google Drive. files.create en spécifiant application/vnd.google-apps.presentation en tant que MIME type.

Voici le protocole de requête permettant de 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 , contrairement à l'API Drive. La méthode files.list (présentée ci-dessous) utilise des masques de champ pour renvoyer une liste de de présentation de votre Drive, par l'ID, le nom du fichier, et un lien pour ouvrir le fichier. La requête spécifie également application/vnd.google-apps.presentation en tant que MIME type.

Voici le protocole de requête permettant de répertorier 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 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

Les éléments suivants : presentations.batchUpdate exemple de code montre comment utiliser ReplaceAllTextRequest pour remplacer du texte dans l'ensemble de la présentation spécifié par les PRESENTATION_ID Vous pouvez découvrir la valeur ID de présentation à partir de l'URL de la présentation.

Chaque instance de la chaîne "Gizmo Corp." est remplacé par le texte "Gadget Inc." Cela inclut le texte dans les zones de texte et autres formes, sur les diapositives et dans aux maîtres. Dans ce cas, le remplacement de texte est sensible à la casse en définissant matchCase à 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."
      }
    }
  ]
}