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