Mit der Google Slides API können Sie Präsentationen in Google Präsentationen erstellen und ändern.
Apps können in die Google Präsentationen API eingebunden werden, um automatisch ansprechende Präsentationen aus Nutzer- und Systemdaten zu erstellen. Sie könnten beispielsweise Kundendetails aus einer Datenbank verwenden und mit vordefinierten Vorlagen und ausgewählten Konfigurationsoptionen kombinieren, um in einem Bruchteil der Zeit, die für die manuelle Erstellung erforderlich wäre, fertige Präsentationen zu erstellen.
Übersicht über die API
Die Sammlung presentations bietet Methoden, mit denen Sie Elemente in der Präsentation abrufen und aktualisieren können.
Die meiste Arbeit mit der Google Slides API besteht wahrscheinlich darin, Präsentationen zu erstellen und zu aktualisieren. Dazu verwenden Sie die Methode batchUpdate. Diese Methode akzeptiert eine Liste von Request-Objekten, mit denen Sie unter anderem folgende Aktionen ausführen können:
- Folien erstellen
- Folien Elemente wie Formen oder Tabellen hinzufügen
- Text einfügen, ändern und entfernen
- Transformationen auf Elemente anwenden
- Reihenfolge von Folien ändern
Weitere Informationen finden Sie unter Batch-Aktualisierungen. In den Anleitungen für die ersten Schritte finden Sie ein einfaches End-to-End-Beispiel für die Verwendung der API.
Aufbau einer Präsentation
Eine Präsentation in der Google Slides API besteht aus Seiten, die Seitenelemente enthalten.
Die ID einer Präsentation kann aus der URL abgeleitet werden:
https://docs.google.com/presentation/d/presentationId/edit
Die Präsentations-ID ist ein String mit Buchstaben, Zahlen und einigen Sonderzeichen. Mit dem folgenden regulären Ausdruck lässt sich die Präsentations-ID aus einer Google-Tabellen-URL extrahieren:
/presentation/d/([a-zA-Z0-9-_]+)
Wenn Sie mit der Drive API vertraut sind, entspricht presentationId der ID der File-Ressource.
Seiten und Seitenelemente werden durch Objekt-IDs identifiziert.
iWork Pages
Google-Präsentationen haben die folgenden Arten von Seiten:
| Master | Auf Folienmastern werden die Standardtextstile, der Hintergrund und die Seitenelemente definiert, die auf allen Folien angezeigt werden, auf denen dieser Master verwendet wird. Seitenelemente, die auf allen Folien angezeigt werden müssen, sollten dem Master hinzugefügt werden. Die meisten Präsentationen haben ein Master, einige jedoch mehrere oder keines. |
| Layouts | Layouts dienen als Vorlage für die standardmäßige Anordnung von Seitenelementen auf Folien, die ein Layout verwenden. Jedes Layout ist einem Master zugeordnet. |
| Präsentationen | Diese Seiten enthalten die Inhalte, die Sie Ihrem Publikum präsentieren. Die meisten Folien basieren auf einem Master und einem Layout. Sie können für jede Folie, die erstellt wird, das zu verwendende Layout angeben. |
| Hinweise | Diese Seiten enthalten die Inhalte für Präsentations-Handouts, einschließlich einer Form, die die Vortragsnotizen der Folie enthält. Jeder Folie ist eine entsprechende Notizenseite zugeordnet. Nur der Text im Feld für Vortragsnotizen kann mit der Slides API geändert werden. |
| Hinweis-Master | Im Notizenmaster werden die Standardtextstile und Seitenelemente für alle Notizenseiten definiert. Notizenmaster sind in der Slides API schreibgeschützt. |
Seitenelemente
Seitenelemente sind die visuellen Komponenten, die auf Seiten platziert werden. Die API stellt verschiedene Arten von Seitenelementen zur Verfügung:
| Gruppe | Eine Gruppe von Seitenelementen, die als einzelne Einheit behandelt werden. Sie können gemeinsam verschoben, skaliert und gedreht werden. |
| Form | Ein einfaches visuelles Objekt wie Rechtecke, Ellipsen und Textfelder. Formen können Text enthalten und sind daher die gängigsten Seitenelemente zum Erstellen von Folien. |
| Bild | Eine in Google-Präsentationen importierte Grafik. |
| Video | Ein in Google Präsentationen importiertes Video |
| Linie | Eine visuelle Linie, Kurve oder Verbindung. |
| Tabelle | Ein Raster mit Inhalten. |
| WordArt | Ein visuelles Textelement, das sich eher wie eine Form verhält. |
| SheetsChart | Ein Diagramm, das aus Google Sheets in Google-Präsentationen importiert wurde. |
Batch-Updates
Mit der Methode batchUpdate können Sie viele Aspekte einer Präsentation aktualisieren. Änderungen werden in einem Batch gruppiert. Wenn eine Anfrage fehlschlägt, werden keine der anderen (möglicherweise abhängigen) Änderungen geschrieben.
Die Methode batchUpdate funktioniert, indem sie ein oder mehrere Request-Objekte entgegennimmt, die jeweils eine einzelne Art von auszuführender Anfrage angeben. Es gibt viele verschiedene Arten von Anfragen. Im Folgenden finden Sie eine Aufschlüsselung der Anfragetypen, gruppiert nach verschiedenen Kategorien.
Die Methode batchUpdate gibt einen Antworttext zurück, der eine Response für jede Anfrage enthält. Jede Antwort belegt denselben Index wie die entsprechende Anfrage. Bei Anfragen ohne anwendbare Antwort ist die Antwort an diesem Index leer. Die verschiedenen Create-Anfragen haben normalerweise Antworten, sodass Sie die ID des neu hinzugefügten Objekts kennen.
Mit Objekt-IDs arbeiten
Eine Präsentation in der Google Slides API besteht aus Seiten und Seitenelementen. Diese Objekte enthalten einen Objekt-ID-String, der innerhalb einer Präsentation eindeutig ist.
Objekt-IDs bei der Erstellung angeben
Wenn Sie Seiten oder Seitenelemente mit der Methode batchUpdate erstellen, können Sie optional eine Objekt-ID für das neue Objekt angeben. So können Sie ein Objekt erstellen und in derselben batchUpdate-Anfrage ändern. Dadurch wird die Anzahl der Aufrufe der Slides API minimiert und die Kontingentnutzung
reduziert.
In den meisten Fällen empfehlen wir, eine zufällige Objekt-ID zu generieren. Wenn Sie beispielsweise Java verwenden, sollte java.util.UUID.randomUUID().toString() gut funktionieren.
Wenn Ihre Anwendung Objekte über einen längeren Zeitraum verfolgen soll, sollten Sie sich nicht auf die Objekt-ID verlassen, da sie sich ändern kann. Weitere Informationen finden Sie im nächsten Abschnitt.
Objekte ohne Objekt-ID im Blick behalten
Wenn Sie eine Slides API-Anfrage stellen, bleibt die Objekt-ID normalerweise erhalten. Ausnahmen werden in der Referenzdokumentation der Methode angegeben. Wenn Sie eine Kopie einer gesamten Präsentation mit der Drive API erstellen, bleiben die Objekt-IDs ebenfalls erhalten.
Sie können jedoch nicht davon ausgehen, dass eine Objekt-ID unverändert bleibt, nachdem eine Präsentation in der Google-Präsentationen-Benutzeroberfläche geändert wurde. Wenn beispielsweise ein Nutzer ein Seitenelement über die Benutzeroberfläche von Google Präsentationen kopiert und einfügt und dann das Original löscht, erhält das Seitenelement eine neue eindeutige ID. Die ID, die Sie zuvor über die API angegeben haben, geht verloren. Daher empfehlen wir, Objekt-IDs nicht im Speicher Ihrer Anwendung zu speichern. Stattdessen sollten Sie Objekte in der Präsentation anhand ihres Textinhalts oder Alternativtexts suchen.
In neu erstellten Präsentationen wird normalerweise eine einheitliche Gruppe von IDs für Standardfolien, Master und Textfelder verwendet. Diese IDs können sich im Laufe der Zeit ändern. Wir empfehlen daher, sich nicht auf diese Funktion zu verlassen. Suchen Sie stattdessen die Elemente, die Sie ändern möchten, mit dem Präsentationsobjekt, das von Aufrufen von create() oder get() zurückgegeben wird.