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 sprachneutral zu sein. In den folgenden Anleitungen erfahren Sie, wie Sie mithilfe der Google API-Clientbibliotheken eine Batch-Aktualisierung in verschiedenen Sprachen implementieren:

Präsentation erstellen

Das folgende Codebeispiel presentations.create zeigt, wie Sie eine leere Präsentationsdatei mit dem Namen „My New Presentation“ (Meine neue Präsentation) erstellen.

Es ist auch möglich, mit der files.create-Methode der Google Drive API leere Präsentationsdateien zu erstellen. Dazu geben Sie application/vnd.google-apps.presentation als MIME-Typ an.

Hier ist das Anfrageprotokoll für die Erstellung einer Präsentation:

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

Vorhandene Präsentationsdateien auflisten

Die Slides API bietet keine Methode zum Abrufen einer Liste von Präsentationen, die Drive API jedoch schon. Bei der unten dargestellten Methode files.list werden Feldmasken verwendet, um eine Liste der Präsentationsdateien aus Google Drive mit der Datei-ID, dem Dateinamen und einem Link zum Öffnen der Datei zurückzugeben. In der Anfrage wird außerdem application/vnd.google-apps.presentation als MIME-Typ angegeben.

Mit dem folgenden Anfrageprotokoll werden vorhandene Präsentationsdateien aufgelistet:

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

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

Jede Instanz der Zeichenfolge "Gizmo Corp." wird durch den Text "Gadget Inc." ersetzt. Dies gilt auch für Text in Textfeldern und anderen Formen, auf Folien und in Mastern. In diesem Fall wird bei der Textersetzung zwischen Groß- und Kleinschreibung unterschieden. Dazu wird matchCase auf true gesetzt.

Im Folgenden finden Sie das Anfrageprotokoll, mit dem Text in einer Präsentation ersetzt werden soll:

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