Eine nützliche Anwendung der Google Slides API ist es, Informationen aus einer oder mehr Datenquellen in einer Folienvorlage zusammenfassen.
Auf dieser Seite wird beschrieben, wie Sie Daten aus einer externen Quelle und fügen ihn in eine vorhandene Vorlage ein. Das Konzept ist ähnlich wie bei der Zusammenstellung von E-Mail-Inhalten in einem Textverarbeitungsprogramm und einer Tabellenkalkulation.
Dieser Ansatz ist aus mehreren Gründen hilfreich:
Es ist für Designschaffende leicht, das Design einer Präsentation mithilfe im Google Präsentationen-Editor. Das ist viel einfacher als die Feinabstimmung der um das Design der gerenderten Folie festzulegen.
Das Trennen von Inhalten von der Präsentation ist ein bekanntes Design Prinzip mit vielen Vorteilen.
Ein einfaches Rezept
Hier ist ein Beispiel dafür, wie Sie mit der Slides API Daten in einer Präsentation zusammenführen können:
Erstellen Sie Ihre Präsentation so, wie sie aussehen soll, indem Sie um Ihnen beim Design zu helfen.
Ersetzen Sie für jedes einzufügende Inhaltselement den Platzhalter mit einem Tag versehen. Tags sind Textfelder oder Formen mit einer eindeutigen Zeichenfolge. Achten Sie darauf, Zeichenfolgen zu verwenden, die wahrscheinlich nicht normal auftreten. Beispiel:
{{account-holder-name}}
wäre ein gutes Tag.Erstellen Sie in Ihrem Code mithilfe der Google Drive API eine Kopie der Datei zu präsentieren.
Verwenden Sie in Ihrem Code die
batchUpdate
mit einer Reihe vonreplaceAllText
-Anforderungen, um alle Textersetzungen in der Präsentation durchzuführen.replaceAllShapesWithImage
verwenden -Anfragen zum Ausführen von Bildersetzungen in der Präsentation.
Nachdem Sie eine Präsentation mit Tags erstellt haben, und bearbeiten die Kopie mithilfe der Slides API. Die Slides API nicht verwenden um Ihre primäre "Vorlage" kopieren!
Die folgenden Abschnitte enthalten Code-Snippets, die einige davon veranschaulichen. . Ein vollständiges Beispiel finden Sie auch im Video oben. (Python) und kombinieren mehrere der Konzepte aus den einzelnen Abschnitten unten.
Text zusammenführen
Sie können ein replaceAllText
-
-Anforderung zum Ersetzen aller Instanzen einer bestimmten Textzeichenfolge in einem
Präsentation mit neuem Text. Bei Zusammenführungen ist das einfacher als
Suchen und Ersetzen jeder Instanz von Text einzeln. Ein Grund dafür ist die
ist die komplexeste Herangehensweise,
dass Seitenelement-IDs schwer vorherzusagen sind,
insbesondere wenn die Mitarbeiter die Vorlage
optimieren und pflegen
zu präsentieren.
Beispiel
In diesem Beispiel wird die Drive API verwendet, um eine Präsentationsvorlage zu kopieren, sodass eine neue Instanz der Präsentation. Dann verwendet es die Google Sheets API, um Daten zu lesen. aus einer Google Tabellen-Tabelle und nutzt schließlich die Slides API, um die in der neuen Präsentation.
In diesem Beispiel werden Daten aus drei Zellen in einer Zeile eines benannten Bereichs in der
Tabelle. Diese Daten werden dann überall dort, wo sie angezeigt werden, in die Präsentation eingefügt.
die Strings {{customer-name}}
,
{{case-description}}
oder
{{total-portfolio}}
auftreten.
Apps Script
Ok
Java
JavaScript
Node.js
PHP
Python
Ruby
Bilder zusammenführen
Sie können Bilder auch mithilfe eines
replaceAllShapesWithImage
Diese Anfrage ersetzt alle Instanzen von Formen, die den
angegebene Textzeichenfolge mit dem bereitgestellten Bild. Die Anfrage wird automatisch
das Bild so positioniert und skaliert, dass es in die Begrenzungen der Tag-Form passt, während
Das Seitenverhältnis des Bildes wird beibehalten.
Beispiel
In diesem Beispiel wird die Google Drive API verwendet, um eine Präsentationsvorlage zu kopieren. Dadurch werden
eine neue Instanz der Präsentation. Dann nutzt es die Slides API,
beliebige Form mit dem Text „{{company-logo}}
“
und durch ein Firmenlogo ersetzen. Die Anfrage ersetzt außerdem alle
Form mit dem Text „{{customer-graphic}}
“
mit einem anderen Bild.
Apps Script
Ok
Java
JavaScript
Node.js
PHP
Python
Ruby
Bestimmte Textfeld- oder Bildinstanzen ersetzen
Die replaceAllText
und replaceAllShapesWithImage
-Anfragen sind nützlich, um Tags in einer Präsentation zu ersetzen.
manchmal müssen Sie Elemente nur nach anderen Kriterien ersetzen, z. B.
die auf einer bestimmten Folie zu finden sind.
In diesen Fällen müssen Sie die IDs der Tag-Formen abrufen, die Sie ersetzen möchten. Beim Ersetzen von Text löschen Sie die Text in diese Formen einfügen und dann den neuen Text einfügen (siehe Beispiel Text in einer bestimmten Form bearbeiten.
Das Ersetzen von Bildern ist komplexer. So fügen Sie ein Bild zusammen:
- Rufen Sie die ID der Tag-Form ab.
- Kopieren Sie die Informationen zur Größe und Transformation aus dem Tag.
- Fügen Sie der Seite Ihr Bild hinzu und verwenden Sie dabei die Angaben zu Größe und Umwandlung.
- Löschen Sie die Tag-Form.
Das Beibehalten des Seitenverhältnisses beim Skalieren auf die gewünschte Größe könnte besonders sorgfältig vorgehen, wie im folgenden Abschnitt beschrieben. Sehen Sie sich auch dieses Beispiel an: Form-Tag durch ein Bild ersetzen
Seitenverhältnis beibehalten
Wenn Sie Bilder mit der Slides API erstellen, basieren die Seitenanpassungen nur auf dem
und nicht auf die Größe und Transformationsdaten. Die von Ihnen angegebenen Größendaten
in der createImage
-Anforderung als gewünschte Größe des Bildes betrachtet. Die API passt zu
das Seitenverhältnis des Bilds auf die gewünschte Größe an und wendet dann die angegebene Transformation an.
Wenn Sie ein Tag durch ein Bild ersetzen, wird das Seitenverhältnis des Bildes beibehalten. Seitenverhältnis durch Festlegen der Größe und Skalierung des Bildes folgendermaßen:
- width: Legen Sie das Produkt aus
width
undscaleX
des Tags fest. - height: Legen Sie als Wert das Produkt aus
height
undscaleY
des Tags fest. - scale_x: auf
1
gesetzt - scale_y: auf
1
festgelegt
Dadurch passt die Slides API das Bild entsprechend der
nicht skaliert, sondern mit der nicht skalierten Größe (siehe
Form-Tag durch ein Bild ersetzen.
Wenn Sie die Skalierungsparameter auf 1
festlegen, wird das Bild nicht skaliert.
zweimal.
Diese Anordnung sorgt dafür, dass das Seitenverhältnis des Bildes erhalten bleibt, und verhindert, dass das Bild die Tag-Form nicht überschreitet. Das Bild enthält auf denselben Mittelpunkt wie die Tag-Form.
Vorlagen verwalten
Für Vorlagenpräsentationen, die die Anwendung definiert und besitzt, erstellen Sie Vorlage mithilfe eines speziellen Kontos erstellen, das die Anwendung repräsentiert. Dienstkonten sind eine gute Wahl und vermeiden Komplikationen mit Google Workspace-Richtlinien, die Teilen von Inhalten.
Wenn Sie Instanzen von Präsentationen aus Vorlagen erstellen, verwenden Sie Endnutzer-Anmeldedaten. So haben Nutzer die volle Kontrolle Ergebnis der Präsentation und verhindert Skalierungsprobleme in Bezug auf die in Google Drive.
Führen Sie zum Erstellen einer Vorlage mit einem Dienstkonto die folgenden Schritte mit Anwendungsanmeldedaten:
- Erstellen Sie mit presentations.create in der Slides API eine Präsentation.
- Aktualisieren Sie die Berechtigungen, damit die Empfänger der Präsentation sie lesen können. permissions.create in der Drive API.
- Aktualisieren Sie die Berechtigungen, damit Vorlagenautoren mit schreiben können. permissions.create in der Drive API.
- Bearbeiten Sie die Vorlage nach Bedarf.
Führen Sie die folgenden Schritte aus, um eine Instanz der Präsentation zu erstellen durch die Nutzeranmeldedaten:
- Erstellen Sie eine Kopie der Vorlage mithilfe von files.copy:
- Ersetzen Sie Werte mithilfe von presentation.batchUpdate in der Slides API.