Präsentationsvorgänge

Mit der Google Slides API können Sie Präsentationsdateien erstellen und vorhandene verwalten. Die Beispiele auf dieser Seite zeigen einige gängige Vorgänge zur Seitenpräsentation mit der Methode presentations.batchUpdate.

Diese Beispiele werden als HTTP-Anfragen dargestellt, um sprachenunabhängig zu sein. Informationen zum Implementieren eines Batch-Updates in verschiedenen Sprachen mit den Clientbibliotheken der Google API finden Sie in den folgenden Anleitungen:

Präsentation erstellen

Im folgenden presentations.create-Codebeispiel wird gezeigt, wie eine leere Präsentationsdatei mit dem Titel „Meine neue Präsentation“ erstellt wird.

Sie können auch leere Präsentationsdateien mit der Google Drive API-Methode files.create erstellen, indem Sie application/vnd.google-apps.presentation als MIME-Typ angeben.

Im Folgenden finden Sie das Anfrageprotokoll zum Erstellen einer Präsentation:

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

Vorhandene Präsentationsdateien auflisten

Die Slides API bietet im Gegensatz zur Drive API eine Methode zum Abrufen einer Liste von Präsentationen. Bei der Methode files.list (siehe unten) werden Feldmasken verwendet, um eine Liste von Präsentationsdateien aus Ihrer Ablage zurückzugeben, die die Datei-ID, den Dateinamen und einen Link zum Öffnen der Datei enthalten. In der Anfrage wird auch application/vnd.google-apps.presentation als MIME-Typ angegeben.

Im Folgenden ist das Anfrageprotokoll zum Auflisten vorhandener Präsentationsdateien aufgeführt:

GET https://www.googleapis.com/drive/v3/files?q="mimeType=application/vnd.google-apps.presentation"&fields=files(id,name,webViewLink)

Die Antwort auf diese Anfrage hat die folgende Struktur:

{
 "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"
    },
    ...
  ]
}

Text in einer Präsentation ersetzen

Im folgenden Codebeispiel für presentations.batchUpdate wird gezeigt, wie mit der Methode ReplaceAllTextRequest Text in der gesamten Präsentation durch den mit PRESENTATION_ID angegebenen Text ersetzt wird. Sie finden den Wert für die Präsentations-ID in der URL der Präsentation.

Jede Instanz des Strings „Gizmo Corp.“ wird durch den Text „Gadget Inc.“ ersetzt. Dazu gehören Text in Textfeldern und anderen Formen, auf Folien und in Masterfolien. In diesem Fall wird bei der Textersetzung zwischen Groß- und Kleinschreibung unterschieden. Dazu setzen Sie matchCase auf true.

Das folgende Anfrageprotokoll zum Ersetzen von Text in einer Präsentation:

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