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äsentationen erstellen und verwalten
- Nach Dateien und Ordnern suchen
- Daten in einer Präsentation zusammenführen
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." } } ] }