Einführung

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.

Mit Google Präsentationen arbeiten: CreateSlideRequest
UpdateSlidesPositionRequest
DuplicateObjectRequest
UpdatePagePropertiesRequest
DeleteObjectRequest
Mit Seitenelementen arbeiten: CreateShapeRequest
CreateLineRequest
UpdatePageElementTransformRequest
UpdateShapePropertiesRequest
DuplicateObjectRequest
DeleteObjectRequest
Mit Tabellen arbeiten: CreateTableRequest
InsertTableRowsRequest
InsertTableColumnsRequest
DeleteTableRowRequest
DeleteTableColumnRequest
UpdateTableRowPropertiesRequest
UpdateTableColumnPropertiesRequest
UpdateTableBorderPropertiesRequest
UpdateTableCellPropertiesRequest
MergeTableCellsRequest
UnmergeTableCellsRequest
DeleteObjectRequest
Mit Diagrammen arbeiten: CreateSheetsChartRequest
RefreshSheetsChartRequest
ReplaceAllShapesWithSheetsChartRequest
DeleteObjectRequest
Mit Bildern und Videos arbeiten: CreateImageRequest
CreateVideoRequest
UpdateImagePropertiesRequest
UpdateVideoPropertiesRequest
ReplaceAllShapesWithImageRequest
DuplicateObjectRequest
DeleteObjectRequest
Mit Text arbeiten: InsertTextRequest
DeleteTextRequest
ReplaceAllTextRequest
CreateParagraphBulletsRequest
DeleteParagraphBulletsRequest
UpdateTextStyleRequest
UpdateParagraphStyleRequest

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().