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 Folienpräsentationen aus von Nutzern und Systemen bereitgestellten Daten zu erstellen. Beispielsweise können Sie Kundendetails aus einer Datenbank verwenden und diese mit vordefinierten Vorlagen und ausgewählten Konfigurationsoptionen kombinieren, um fertige Präsentationen in einem Bruchteil der Zeit zu erstellen, die für deren manuelle Erstellung benötigt würde.
Übersicht über die API
Die Sammlung presentations enthält Methoden, mit denen Sie Elemente innerhalb der Präsentation abrufen und aktualisieren können.
Der größte 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 wie Formen oder Tabellen zu Folien hinzufügen
- Text einfügen, ändern und entfernen
- Transformationen auf Elemente anwenden
- Reihenfolge der Folien ändern
Weitere Informationen finden Sie unter Batch-Updates. Im Startleitfaden 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 kann die Präsentations-ID aus einer Google Tabellen-URL extrahiert werden:
/presentation/d/([a-zA-Z0-9-_]+)
Wenn Sie mit der Drive API vertraut sind, entspricht presentationId der ID der Dateiressource.
Seiten und Seitenelemente werden durch Objekt-IDs identifiziert.
iWork Pages
Google Präsentationen umfasst die folgenden Arten von Seiten:
| Master | Folienmaster definieren die Standardtextstile, den Hintergrund und die Seitenelemente, die auf allen Folien erscheinen, die diesen Master verwenden. 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 keinen. |
| Layouts | Layouts dienen als Vorlage dafür, wie Seitenelemente standardmäßig auf Folien in 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. Sie können beim Erstellen einer Folie angeben, welches Layout für jede Folie verwendet werden soll. |
| Hinweise | Diese Seiten enthalten die Inhalte der Handouts für Präsentationen, darunter eine Form, die die Vortragsnotizen der Folie enthält. Jede Folie hat eine entsprechende Notizenseite. Mit der Slides API kann nur der Text in der Form für Vortragsnotizen geändert werden. |
| Notizenvorlagen | In Notes-Mastern werden die Standardtextstile und die Seitenelemente für alle Notizenseiten definiert. Notizen-Master 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 eine 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, weshalb sie die am häufigsten verwendeten Seitenelemente zum Erstellen von Folien sind. |
| Bild | Eine in Google Präsentationen importierte Grafik. |
| Video | Ein Video, das in Google Präsentationen importiert wurde. |
| Liniendiagramm | Eine visuelle Linie, Kurve oder ein Verbindungselement. |
| Tabelle | Ein Inhaltsraster. |
| WordArt | Ein visuelles Textelement, das sich eher wie eine Form verhält. |
| SheetsChart | Ein Diagramm, das aus Google Tabellen 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 zusammengefasst. Wenn eine Anfrage fehlschlägt, werden keine der anderen (möglicherweise abhängigen) Änderungen geschrieben.
Für die Methode batchUpdate werden ein oder mehrere Request-Objekte verwendet, die jeweils eine bestimmte Art von Anfrage definieren. Es gibt viele verschiedene Arten von Anträgen. Hier sehen Sie eine Aufschlüsselung der Arten
von Anträgen, gruppiert in verschiedene Kategorien.
Die Methode batchUpdate gibt einen Antworttext zurück, der für jede Anfrage eine Antwort enthält. Jede Antwort belegt denselben Index wie die entsprechende Anfrage. Bei Anfragen ohne entsprechende Antwort ist die Antwort bei diesem Index leer. Für die verschiedenen Create-Anfragen gibt es normalerweise Antworten, sodass Sie die ID des neu hinzugefügten Objekts kennen.
Mit Objekt-IDs arbeiten
Eine Präsentation in der Slides API besteht 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. So können Sie ein Objekt erstellen und innerhalb derselben BatchUpdate-Anfrage ändern, um die Anzahl der Aufrufe der Slides API und die Kontingentnutzung zu reduzieren.
Wir empfehlen in den meisten Fällen, 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 im Auge behalten möchte, sollten Sie sich nicht auf die Objekt-ID verlassen, da diese sich ändern kann. Weitere Informationen finden Sie im folgenden Abschnitt.
Nachverfolgen von Objekten ohne die Objekt-ID
Bei einer Slides API-Anfrage wird die Objekt-ID normalerweise beibehalten. Ausnahmen sind in der Referenzdokumentation der Methode aufgeführt. Wenn Sie eine Kopie einer ganzen Präsentation mit der Drive API erstellen, bleiben auch Objekt-IDs erhalten.
Sie können sich jedoch nicht darauf verlassen, dass eine Objekt-ID unverändert bleibt, nachdem eine Präsentation in der Benutzeroberfläche von Google Präsentationen geändert wurde. Wenn ein Nutzer beispielsweise über die Benutzeroberfläche von Google Präsentationen ein Seitenelement kopiert und anschließend das Original löscht, erhält das Seitenelement jetzt eine neue eindeutige ID und die ID, die Sie zuvor über die API angegeben haben, geht verloren. Daher raten wir davon ab, Objekt-IDs im Speicher Ihrer Anwendung zu speichern. Stattdessen sollten Sie Objekte in der Präsentation anhand des Textinhalts oder Alt-Textes suchen.
Neu erstellte Präsentationen verwenden normalerweise einen einheitlichen ID-Satz für Standardfolien, Master und Textfelder. Da sich diese IDs im Laufe der Zeit ändern können, raten wir davon ab, dieses Feature zu verwenden. Verwenden Sie stattdessen das Präsentationsobjekt, das durch Aufrufe von create() oder get() zurückgegeben wird.