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 Seitenpräsentationsvorgänge mit der Methode presentations.batchUpdate.

Diese Beispiele werden als HTTP-Anfragen dargestellt, damit sie sprachneutral sind. Informationen zum Implementieren einer Batch-Aktualisierung in verschiedenen Sprachen mithilfe der Google API-Clientbibliotheken finden Sie in den folgenden Anleitungen:

Präsentation erstellen

Im folgenden Codebeispiel für presentations.create sehen Sie, wie eine leere Präsentationsdatei mit dem Namen „My New Presentation“ erstellt wird.

Mit der Methode files.create der Google Drive API können Sie auch leere Präsentationsdateien erstellen. Dazu geben Sie application/vnd.google-apps.presentation als MIME-Typ an.

Das folgende Anfrageprotokoll wird zum Erstellen einer Präsentation verwendet:

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 außerdem application/vnd.google-apps.presentation als MIME-Typ angegeben.

Das folgende Anfrageprotokoll dient zum Auflisten vorhandener Präsentationsdateien:

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 für presentations.batchUpdate zeigt, wie Sie mit der Methode ReplaceAllTextRequest Text in der durch PRESENTATION_ID angegebenen Präsentation ersetzen können. Den Wert für die Präsentations-ID können Sie der Präsentations-URL entnehmen.

Der String "Gizmo Corp." wird durch den Text "Gadget Inc." ersetzt. Dazu gehört auch Text in Textfeldern und anderen Formen, auf Folien und in Mastern. 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."
      }
    }
  ]
}