Mit der Google Slides API können Sie Präsentationen in Google Präsentationen erstellen und ändern.
Apps können in die Google Slides API eingebunden werden, um automatisch ansprechende Präsentationen aus Daten zu erstellen, die von Nutzern und Systemen bereitgestellt werden. Sie können beispielsweise Kundendetails aus einer Datenbank verwenden und mit vordefinierten Vorlagen und ausgewählten Konfigurationsoptionen kombinieren, um fertige Präsentationen in einem Bruchteil der Zeit zu erstellen, die für die manuelle Erstellung erforderlich wäre.
Ü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 Slides API besteht wahrscheinlich darin, Präsentationen zu erstellen und zu aktualisieren. Dazu verwenden Sie die batchUpdate-Methode. Diese Methode verwendet eine Liste von Request -Objekten, mit denen Sie beispielsweise 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 von Folien ändern
Weitere Informationen finden Sie unter Batch-Updates. In den Leitfäden für den Einstieg finden Sie ein einfaches End-to-End-Beispiel für die Verwendung der API.
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 kann die Präsentations-ID aus einer Google Sheets-URL extrahiert werden:
/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.
Seiten
Google Präsentationen bietet die folgenden Arten von Seiten:
| Master | In Folienmastern werden die Standardtextstile, der Hintergrund und die Seiten elemente definiert, die auf allen Folien angezeigt werden, die diesen Master verwenden. Seitenelemente, die auf allen Folien angezeigt werden müssen, sollten dem Master hinzugefügt werden. Die meisten Präsentationen haben einen Master, einige haben mehrere oder keinen. |
| Layouts | Layouts dienen als Vorlage für die Standardanordnung von Seitenelementen auf Folien, die ein Layout verwenden. Jedes Layout ist mit einem Master verknüpft. |
| Folien | 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. |
| Notizen | Diese Seiten enthalten die Inhalte für Präsentationshandouts, einschließlich einer einer Form, die die Referentennotizen der Folie enthält. Jeder Folie ist eine entsprechende Notizenseite zugeordnet. Mit der Slides API kann nur der Text in der Form für Referentennotizen geändert werden. |
| Notizenmaster | In Notizenmastern 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 bietet verschiedene Arten von Seitenelementen:
| 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 häufigsten Seitenelemente zum Erstellen von Folien. |
| Bild | Eine Grafik, die in Google Präsentationen importiert wurde. |
| Video | Ein Video, das in Google Präsentationen importiert wurde. |
| 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 batchUpdate Methode können Sie viele Aspekte einer Präsentation aktualisieren. Änderungen werden in einem Batch zusammengefasst. Wenn eine Anfrage fehlschlägt, werden keine der anderen (potenziell abhängigen) Änderungen geschrieben.
Die batchUpdate Methode verwendet ein oder mehrere
Request
Objekte, die jeweils eine einzelne Art von Anfrage angeben. Es gibt viele verschiedene Arten von Anfragen. Hier ist eine Aufschlüsselung der Anfragetypen, gruppiert in verschiedene Kategorien.
Die Methode batchUpdate gibt einen Antworttext zurück,
der für jede Anfrage eine
Response
enthält. Jede Antwort hat 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, damit 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
batchUpdate
Methode 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 folgenden Abschnitt.
Objekte ohne Objekt-ID verfolgen
Wenn Sie eine Anfrage an die Slides API senden, bleibt die Objekt-ID normalerweise erhalten. Ausnahmen werden in der Referenzdokumentation der Methode genannt. Wenn Sie mit der Drive API eine Kopie einer gesamten Präsentation erstellen, bleiben die Objekt-IDs ebenfalls erhalten.
Sie können sich jedoch nicht darauf verlassen, dass eine Objekt-ID unverändert bleibt, nachdem eine Präsentation in der Slides-Benutzeroberfläche geändert wurde. Wenn beispielsweise ein Nutzer ein Seitenelement mit der Slides-Benutzeroberfläche kopiert und einfügt und dann das Original löscht, hat das Seitenelement jetzt eine neue eindeutige ID und 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.
Neu erstellte Präsentationen verwenden normalerweise eine einheitliche Gruppe von IDs für Standardfolien, Master und Textfelder. 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.