Mit der Google Präsentationen 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 Foliensammlungen aus von Nutzern und dem System bereitgestellten Daten zu erstellen. So können Sie beispielsweise Kundendaten aus einer Datenbank mit vorgefertigten Vorlagen und ausgewählten Konfigurationsoptionen kombinieren, um fertige Präsentationen in einem Bruchteil der Zeit zu erstellen, die das manuelle Erstellen in Anspruch nehmen würde.
API – Übersicht
Die Sammlung Präsentationen bietet Methoden, mit denen Sie Elemente in der Präsentation abrufen und aktualisieren können.
Die meisten Ihrer Aufgaben mit der Google Präsentationen API werden wahrscheinlich darin bestehen, Präsentationen zu erstellen und zu aktualisieren. Dazu verwenden Sie die Methode batchUpdate. Sie nimmt eine Liste von Request-Objekten entgegen, mit denen Sie Folgendes tun können:
- Folien erstellen
- Folien Elemente wie Formen oder Tabellen hinzufügen
- Text einfügen, ändern und entfernen
- Transformationen auf Elemente anwenden
- Reihenfolge der Folien ändern
Weitere Informationen finden Sie unter Batch-Aktualisierungen. In den Leitfäden für den Einstieg 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, Zahlen und einige Sonderzeichen enthält. 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 Datei-Ressource.
Seiten und Seitenelemente werden anhand von Objekt-IDs identifiziert.
iWork Pages
In Google Präsentationen gibt es die folgenden Arten von Seiten:
| Master | In Folienmastern werden die Standardtextstile, der Hintergrund und die Seitenelemente definiert, die auf allen Folien zu sehen sind, 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, einige aber mehrere oder keinen. |
| Layouts | Layouts dienen als Vorlage für die Standardanordnung von Seitenelementen auf Folien. Jedem Layout ist ein 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 verwendet werden soll. |
| Hinweise | Diese Seiten enthalten den Inhalt der Präsentationsunterlagen, einschließlich einer Form mit den Vortragsnotizen der Folie. Jede Folie hat eine entsprechende Notizenseite. Mit der Präsentationen API kann nur der Text in der Form der Vortragsnotizen geändert werden. |
| Notizen-Master | Notizenmaster definieren die Standardtextstile und Seitenelemente für alle Notizenseiten. Notizenmaster sind in der Google Präsentationen API schreibgeschützt. |
Seitenelemente
Seitenelemente sind die visuellen Komponenten, die auf Seiten platziert werden. Die API bietet mehrere Arten von Seitenelementen:
| Gruppe | Eine Reihe 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 für die Erstellung 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 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 gruppiert, sodass bei einem Fehler bei einer Anfrage keine der anderen (potenziell abhängigen) Änderungen geschrieben werden.
Die Methode batchUpdate nimmt ein oder mehrere Request-Objekte an, die jeweils eine einzelne Art von Anfrage angeben. Es gibt viele verschiedene Arten von Anfragen. Im Folgenden finden Sie eine Aufschlüsselung der Anfragetypen in verschiedene Kategorien.
Die batchUpdate-Methode gibt einen Antworttext zurück, der für jede Anfrage eine Antwort enthält. Jede Antwort hat denselben Index wie die entsprechende Anfrage. Bei Anfragen ohne gültige 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 Slides API besteht aus Seiten und Seitenelementen. Diese Objekte enthalten einen String mit einer Objekt-ID, die 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 innerhalb derselben batchUpdate-Anfrage ändern, wodurch die Anzahl der Aufrufe der Google Präsentationen API minimiert und die Kontingentnutzung reduziert wird.
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 Sie in Ihrer Anwendung Objekte über einen längeren Zeitraum hinweg im Blick behalten möchten, sollten Sie sich nicht auf die Objekt-ID verlassen, da sich diese ändern kann. Weitere Informationen finden Sie im nächsten Abschnitt.
Objekte ohne Objekt-ID im Blick behalten
Wenn Sie eine Anfrage an die Google Präsentationen API senden, wird die Objekt-ID in der Regel beibehalten. Ausnahmen werden in der Referenzdokumentation der Methode aufgeführt. Wenn Sie mit der Drive API eine Kopie einer ganzen Präsentation erstellen, bleiben auch die Objekt-IDs 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 jemand beispielsweise über die Benutzeroberfläche von Google Präsentationen ein Seitenelement kopiert und einfügt und dann das Original löscht, erhält das Seitenelement eine neue eindeutige ID und die ID, die Sie zuvor über die API angegeben haben, geht verloren. Daher empfehlen wir Ihnen, keine Objekt-IDs im Speicher Ihrer App 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, Masterfolien und Textfelder verwendet. Diese IDs können sich im Laufe der Zeit ändern. Wir empfehlen daher, diese Funktion nicht zu verwenden. Suchen Sie stattdessen die Elemente, die Sie ändern möchten, mithilfe des Präsentationsobjekts, das durch Aufrufe von create() oder get() zurückgegeben wird.