Mit der Google Slides API können Sie Google-Präsentationen erstellen und bearbeiten.
Apps können in die Google Slides API integriert werden, um ansprechende Folienpräsentationen zu erstellen. automatisch aus von Nutzern und vom System bereitgestellten Daten. Zum Beispiel könnten Sie Kundendetails aus einer Datenbank nutzen und diese mit vorgefertigten Vorlagen und ausgewählte Konfigurationsoptionen, um fertige Präsentationen zu erstellen in einem Bruchteil der Zeit, die für ihre manuelle Erstellung benötigt wird.
Übersicht über die API
Die Sammlung presentations bietet Methoden, mit denen Sie Elemente in der Präsentation abrufen und aktualisieren können.
Der größte Teil Ihrer Arbeit mit der Slides API wird wahrscheinlich Präsentationen. Dazu verwenden Sie den batchUpdate. Diese Methode verwendet eine Liste Anfrage Objekte, mit denen Sie beispielsweise 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. Startleitfaden ansehen 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 jeweils eine Seite enthalten Elemente.
Die ID einer Präsentation kann aus der URL abgeleitet werden:
https://docs.google.com/presentation/d/presentationId/edit
Die Präsentations-ID ist eine Zeichenfolge, die Buchstaben, Zahlen und einige Sonderzeichen Zeichen. Mit dem folgenden regulären Ausdruck können Sie Folgendes extrahieren: Präsentations-ID aus einer Google Tabellen-URL:
/presentation/d/([a-zA-Z0-9-_]+)
Wenn Sie mit der Drive API vertraut sind, entspricht die presentationId dem
ID der Datei
.
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 Elemente, die auf allen Folien erscheinen, die diesen Master verwenden. Seite Elemente, die auf allen Folien erscheinen müssen, sollten dem Master hinzugefügt werden. Meiste Präsentationen haben einen Master, aber manche können auch mehrere oder keine haben. |
| Layouts | Layouts dienen als Vorlage dafür, wie Seitenelemente auf Folien mit einem Layout. Jedes Layout ist einem Master. |
| 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 festlegen, Layout für jede Folie zu verwenden. |
| Hinweise | Diese Seiten enthalten Inhalte für Handouts, einschließlich eines eine Form, die die Vortragsnotizen der Folie enthält. Jede Folie enthält eine zur entsprechenden Notizenseite. Nur der Text in der Form der Vortragsnotizen darf mit der Slides API geändert. |
| Notizenvorlagen | In Notes-Mastern werden die standardmäßigen Textstile und Seitenelemente für alle Notizenseiten. 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 bereit:
| Gruppe | Eine Gruppe von Seitenelementen, die als eine einzelne Einheit behandelt werden. Sie können verschoben, skaliert und gedreht werden. |
| Form | Ein einfaches visuelles Objekt wie Rechtecke, Ellipsen und Textfelder. Formen können Text enthalten und sind daher die am häufigsten verwendeten Seitenelemente. Folien. |
| Bild | Eine in Google Präsentationen importierte Grafik. |
| Video | Ein Video, das in Google Präsentationen importiert wurde. |
| Linie | 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
Die Methode batchUpdate können Sie viele Aspekte einer Präsentation aktualisieren. Änderungen werden in einem einen Batch, sodass, wenn eine Anfrage fehlschlägt, keine der anderen (potenziell abhängigen) Anfragen Änderungen geschrieben werden.
Für die Methode batchUpdate werden ein oder mehrere
Anfrage
-Objekte, die jeweils eine bestimmte Art von auszuführender Anfrage definieren. Es gibt
viele verschiedene Arten von Anträgen. Hier sind die Arten von Anträgen
verschiedenen Kategorien zugeordnet.
Die Methode batchUpdate gibt einen Antworttext zurück.
mit einem
Antwort
für jede Anfrage. Jede Antwort belegt denselben Index wie die entsprechende
anfragen: Bei Anfragen ohne passende Antwort wird die Antwort bei diesem Index
ist leer. Für die verschiedenen Create-Anfragen gibt es normalerweise Antworten.
dass 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 eines zu präsentieren.
Objekt-IDs beim Erstellen angeben
Wenn Sie Seiten oder Seitenelemente mithilfe der batchUpdate verwenden, kann optional eine Objekt-ID für das neue Objekt angeben. So können Sie ein -Objekt und ändern es innerhalb derselben BatchUpdate-Anfrage. Dadurch wird die Anzahl und die Kontingentnutzung 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 verlassen Sie sich nicht auf die Objekt-ID, da diese sich ändern kann. Weitere Informationen: .
Nachverfolgen von Objekten ohne die Objekt-ID
Bei einer Slides API-Anfrage wird die Objekt-ID normalerweise beibehalten. (Alle Ausnahmen werden in der Referenzdokumentation der Methode angegeben.) Wenn Sie Beim Kopieren einer ganzen Präsentation werden mit der Drive API auch Objekt-IDs beibehalten.
Sie können sich jedoch nicht darauf verlassen, dass eine Objekt-ID nach einer Präsentation unverändert bleibt. wird in der Benutzeroberfläche von Google Präsentationen geändert. Wenn jemand zum Beispiel die Google-Präsentation Benutzeroberfläche zum Kopieren und Einfügen eines Seitenelements und anschließendes Löschen des Originals, des Seitenelements erhält nun eine neue eindeutige ID sowie die ID, die Sie zuvor über die API angegeben haben. gehen verloren. Daher raten wir davon ab, Objekt-IDs in Ihrem des Anwendungsspeichers. Stattdessen sollten Sie Objekte in der Präsentation finden, indem Sie dessen Textinhalt oder Alt-Text.
Bei neu erstellten Präsentationen wird als Standardeinstellung normalerweise ein einheitlicher Satz von IDs verwendet. Folien, Master und Textfelder. Diese IDs können sich im Laufe der Zeit ändern. Daher empfehlen wir Ihnen nicht, sich auf diese Funktion zu verlassen. Suchen Sie stattdessen nach den Elementen, die Sie mithilfe des Präsentationsobjekts ändern möchten, das von Aufrufen an create() oder get().