Mit der Slides API können Sie vorhandene Präsentationsdateien verwalten und neue erstellen. Die Beispiele auf dieser Seite zeigen einige gängige Präsentationsvorgänge, die mit der API erreicht werden können.
In diesen Beispielen werden die folgenden Variablen verwendet:
- presentationId: Gibt an, wo Sie die Präsentations-ID angeben. Sie können den Wert für diese ID der Präsentations-URL entnehmen.
- pageId gibt an, wo die Seitenobjekt-ID angegeben wird. Sie können den Wert dafür aus der URL abrufen oder eine API-Leseanfrage verwenden.
- pageElementId gibt an, wo die Objekt-ID des Seitenelements angegeben wird. Sie können diese ID für von Ihnen erstellte Elemente angeben (mit einigen Einschränkungen) oder zulassen, dass die API automatisch eine erstellt. Element-IDs können über eine API-Leseanfrage abgerufen werden.
Neue Präsentation erstellen
Mit der folgenden presentations.create-Anfrage wird eine neue, leere Präsentationsdatei mit dem Namen "Meine neue Präsentation" erstellt.
Mit der Google Drive API-Methode Files.create können Sie auch leere Präsentationsdateien erstellen. Dazu geben Sie application/vnd.google-apps.presentation als mimeType an.
Das Anfrageprotokoll ist unten dargestellt. Die Anleitung Präsentationen erstellen und verwalten enthält ein Beispiel für die Implementierung einer Batch-Aktualisierung in verschiedenen Sprachen mithilfe der Google API-Clientbibliotheken.
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. Mit der Drive API ist dies jedoch ganz einfach. Die hier dargestellte Drive API-Anfrage „Files.list“ verwendet Feldmasken, um eine Liste der Präsentationsdateien mit Datei-IDs, Titeln und einem Link in Drive zurückzugeben.
Das Anfrageprotokoll ist unten dargestellt. Im Leitfaden zur Suche nach Dateien der Drive API finden Sie ein Beispiel für die Implementierung einer Dateisuchanfrage in verschiedenen Sprachen mithilfe der Google API-Clientbibliotheken.
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
Mit der folgenden presentations.batchUpdate-Anfrage wird der durch presentationId angegebene Text in der gesamten Präsentation ersetzt. Jede Instanz des Strings "Gizmo Corp." wird durch den Text "Gadget Inc." ersetzt. Dazu gehört Text in Textfeldern und anderen Formen, auf Folien und auf Mastern. In diesem Fall wird bei der Textersetzung die Groß-/Kleinschreibung beachtet.
Das Anfrageprotokoll ist unten dargestellt. Die Anleitung Daten in Präsentationen zusammenführen enthält ein Beispiel für die Implementierung einer Batch-Aktualisierung in verschiedenen Sprachen mithilfe der Google API-Clientbibliotheken.
POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate
{
"requests": [
{
"replaceAllText": {
"containsText": {
"text": "Gizmo Corp.",
"matchCase": true
},
"replaceText": "Gadget Inc."
}
}
]
}