Mit der Google Slides API können Sie Google-Präsentationen erstellen und bearbeiten.
Anwendungen können in die Google Slides API integriert werden, um automatisch ansprechende Präsentationsfolien aus von Nutzern und System bereitgestellten Daten zu erstellen. Sie können beispielsweise Kundendetails aus einer Datenbank verwenden und mit vorgefertigten Vorlagen und ausgewählten Konfigurationsoptionen kombinieren, um fertige Präsentationen in einem Bruchteil der Zeit zu erstellen, die für eine manuelle Erstellung erforderlich wäre.
Übersicht über die API
Die Sammlung presentations enthält Methoden, mit denen Sie Elemente innerhalb der Präsentation abrufen und aktualisieren können.
Der Großteil Ihrer Arbeit mit der Slides API besteht wahrscheinlich darin, Präsentationen zu erstellen und zu aktualisieren. Dazu verwenden Sie die Methode batchUpdate. Diese Methode verwendet eine Liste von Request-Objekten, mit denen Sie unter anderem Folgendes tun können:
- Folien erstellen
- Elemente zu Folien hinzufügen, z. B. Formen oder Tabellen
- Text einfügen, ändern und entfernen
- Transformationen auf Elemente anwenden
- Reihenfolge der Folien ändern
Weitere Informationen finden Sie unter Batch-Updates. In den Startleitfäden finden Sie ein einfaches End-to-End-Beispiel für die Verwendung der API.
Die Struktur einer Präsentation
Eine Präsentation in der 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, der Buchstaben, Ziffern und einige Sonderzeichen enthält. Mit dem folgenden regulären Ausdruck können Sie 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 das presentationId der ID der Ressource File.
Seiten und Seitenelemente werden durch Objekt-IDs identifiziert.
Seiten
Google Präsentationen bietet folgende Arten von Seiten:
| Master | Folienmaster definieren die Standardtextstile, den Standardhintergrund und die Standardseitenelemente, die auf allen Folien angezeigt werden, für die dieser Master verwendet wird. Seitenelemente, die auf allen Folien erscheinen müssen, sollten dem Master hinzugefügt werden. Die meisten Präsentationen haben einen Master, manche aber auch mehrere oder keine. |
| Layouts | Layouts dienen als Vorlage dafür, wie Seitenelemente standardmäßig auf Folien mit einem Layout angeordnet werden. 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. Beim Erstellen einer Folie können Sie festlegen, welches Layout verwendet werden soll. |
| Hinweise | Auf diesen Seiten finden Sie den Inhalt der Handouts, einschließlich einer Form für die Vortragsnotizen der Folie. Jede Folie hat eine entsprechende Notizenseite. Nur der Text in der Form der Vortragsnotizen kann mit der Slides API geändert werden. |
| Notizenmaster | In Notes-Mastern werden die standardmäßigen Textstile 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 | Ein Satz von Seitenelementen, die als einzelne Einheit behandelt werden. Sie können zusammen verschoben, skaliert und gedreht werden. |
| Form | Ein einfaches visuelles Objekt wie Rechtecke, Ellipsen und Textfelder. Formen können Text enthalten. Daher sind sie die am häufigsten zum Erstellen von Folien verwendeten Seitenelemente. |
| Bild | Eine in Google Präsentationen importierte Grafik |
| Video | Ein Video, das in Google Präsentationen importiert wurde |
| Linie | Eine visuelle Linie, Kurve oder Verbindung. |
| Tabelle | Ein Inhaltsraster. |
| WordArt | Ein visuelles Textelement, das sich mehr wie eine Form verhält. |
| SheetsChart | Ein aus Google Tabellen in Google Präsentationen importiertes Diagramm. |
Batch-Updates
Mit der Methode batchUpdate können Sie viele Aspekte einer Präsentation aktualisieren. Änderungen werden in einem Batch gruppiert. Wenn also eine Anfrage fehlschlägt, wird keine der anderen (möglicherweise abhängigen) Änderungen geschrieben.
Die Methode batchUpdate verwendet ein oder mehrere Request-Objekte, von denen jedes eine bestimmte Art von auszuführenden Anfragen angibt. Es gibt viele verschiedene Arten von Anträgen. Hier sehen Sie die Arten von Anfragen,
gruppiert in verschiedene Kategorien.
Die Methode batchUpdate gibt einen Antworttext zurück, der eine Antwort für jede Anfrage enthält. Jede Antwort belegt denselben Index wie die entsprechende Anfrage. Bei Anfragen ohne entsprechende Antwort ist die Antwort an diesem Index leer. Die verschiedenen Create-Anfragen haben normalerweise Antworten, damit Sie die ID des neu hinzugefügten Objekts kennen.
Mit Objekt-IDs arbeiten
Eine Präsentation besteht in der Slides API aus Seiten und Seitenelementen. Diese Objekte enthalten einen Objekt-ID-String, der innerhalb einer Präsentation eindeutig ist.
Objekt-IDs beim Erstellen angeben
Wenn Sie Seiten oder Seitenelemente mit der Methode batchUpdate erstellen, können Sie optional eine Objekt-ID für das neue Objekt angeben. Auf diese Weise können Sie ein Objekt erstellen und in derselben BatchUpdate-Anfrage bearbeiten und so die Anzahl der Aufrufe der Slides API sowie die Kontingentnutzung reduzieren.
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 hinweg verfolgen möchte, sollten Sie sich nicht auf die Objekt-ID verlassen, da diese sich ändern kann. Weitere Informationen finden Sie im folgenden Abschnitt.
Den Überblick über Objekte behalten, ohne die Objekt-ID zu verwenden
Wenn Sie eine Slides API-Anfrage stellen, wird die Objekt-ID normalerweise beibehalten. (Alle Ausnahmen werden in der Referenzdokumentation der Methode angegeben.) Beim Kopieren einer gesamten Präsentation mit der Drive API werden auch Objekt-IDs beibehalten.
Sie können jedoch nicht davon ausgehen, dass eine Objekt-ID unverändert bleibt, nachdem eine Präsentation in der Benutzeroberfläche von Google Präsentationen geändert wurde. Wenn beispielsweise ein Seitenelement über die Google Präsentationen-UI kopiert und eingefügt und dann das Original gelöscht wird, erhält das Seitenelement jetzt eine neue eindeutige ID und die zuvor über die API angegebene ID geht verloren. Daher raten wir davon ab, Objekt-IDs im Speicher Ihrer Anwendung zu speichern. Stattdessen sollten Sie Objekte in der Präsentation anhand ihres Textinhalts oder Alt-Texts finden.
Bei neu erstellten Präsentationen werden normalerweise einheitliche IDs für Standardfolien, Master und Textfelder verwendet. Da sich diese IDs im Laufe der Zeit ändern können, raten wir davon ab, sich auf diese Funktion zu verlassen. Suchen Sie stattdessen nach den Elementen, die Sie ändern möchten. Verwenden Sie dazu das Präsentationsobjekt, das durch Aufrufe von create() oder get() zurückgegeben wird.