Mit der Google Slides API können Sie
PageElement
Ressource enthalten, darunter Textfelder, Bilder, Tabellen, Grundformen, Linien und
eingebetteten Videos angezeigt. Die Beispiele auf dieser Seite zeigen gängige Seitenelemente.
Operationen mithilfe der
presentations.batchUpdate
.
In diesen Beispielen werden die folgenden Variablen verwendet:
- PRESENTATION_ID: Gibt an, wo Sie die Präsentation ID fest. Sie können ruft den Wert für diese ID aus der Präsentations-URL ab.
- PAGE_ID: Gibt an, wo Sie das Seitenobjekt bereitstellen. ID fest. Sie können die Daten abrufen, den Wert hierfür aus der URL oder mithilfe einer API-Leseanfrage.
- PAGE_ELEMENT_ID: Gibt an, wo Sie die Seite bereitstellen. Objekt-ID des Elements. Ich kann diese ID für von Ihnen erstellte Elemente angeben (mit einigen Einschränkungen) oder der Slides API erlauben, automatisch ein Konto zu erstellen. Element-IDs kann über eine API-Leseanfrage abgerufen werden.
Diese Beispiele werden als HTTP-Anfragen dargestellt, damit sie sprachneutral sind. Weitere Informationen Wie eine Batch-Aktualisierung in verschiedenen Sprachen mithilfe der Google API implementiert wird finden Sie in den folgenden Anleitungen:
Aufzählungslisten zu Textfeldern hinzufügen
Die folgenden
presentations.batchUpdate
wird gezeigt, wie Sie mit der
InsertTextRequest
zum Einfügen von Text in ein leeres Textfeld, das durch die
PAGE_ELEMENT_ID Im Beispiel wird dann die Methode
CreateParagraphBulletsRequest
, um den gesamten Textfeldtext in eine Aufzählungsliste zu konvertieren. Elemente in der Liste
werden durch \n
Zeichen getrennt, während der Einzug mit \t
gesteuert wird
Zeichen.
Das folgende Anfrageprotokoll wird zum Erstellen einer Präsentation verwendet:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "insertText": { "objectId": PAGE_ELEMENT_ID, "text": "My List\n\tItem 1\n\t\tItem 2\n\t\t\tItem 3", "insertionIndex": 0 }, "createParagraphBullets": { "objectId": PAGE_ELEMENT_ID, "bulletPreset": "BULLET_ARROW_DIAMOND_DISC", "textRange": { "type": "ALL" } } } ] }
Mit dieser Anfrage kann eine Aufzählungsliste erstellt werden, die so aussieht:
Formen in Folien einfügen
Die folgenden
presentations.batchUpdate
wird gezeigt, wie Sie mit der
CreateShapeRequest
, um einer durch PAGE_ID angegebenen Folie eine Wellenform hinzuzufügen.
Diese Anfrage gibt den Formtyp an und skaliert die Form dann
auf die Folie. Dann wird die Methode
InsertTextRequest
um Text zu dieser Form hinzuzufügen. Die Anfrage legt die ID der Zeile auf
PAGE_ELEMENT_ID
Mit dem folgenden Anfrageprotokoll können Sie einer Folie eine Form hinzufügen:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createShape": { "objectId": PAGE_ELEMENT_ID, "elementProperties": { "pageObjectId": PAGE_ID, "size": { "width": { "magnitude": 3000000, "unit": "EMU" }, "height": { "magnitude": 3000000, "unit": "EMU" } }, "transform": { "scaleX": 0.6807, "scaleY": 0.4585, "translateX": 6583050, "translateY": 1673950, "unit": "EMU" } }, "shapeType": "WAVE" } }, { "insertText": { "objectId": PAGE_ELEMENT_ID, "text": "My Wave Shape", "insertionIndex": 0 } } ] }
Videos in Folien einfügen
Die folgenden
presentations.batchUpdate
wird gezeigt, wie Sie mit der
CreateVideoRequest
, um ein Video in eine durch PAGE_ID angegebene Folie einzubetten.
Mit dieser Anfrage wird das Video auf der Folie
skaliert und positioniert,
ID an PAGE_ELEMENT_ID. Die eindeutige Kennung des Quellvideos lautet
auf VIDEO_ID festgelegt. Das YouTube-Video unter
https://www.youtube.com/watch?v=7U3axjORYZ0
hat die ID 7U3axjORYZ0
.
Mit dem folgenden Anfrageprotokoll können Sie einer Folie ein Video hinzufügen:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createVideo": { "objectId": PAGE_ELEMENT_ID, "elementProperties": { "pageObjectId": PAGE_ID, "size": { "width": { "magnitude": 12000, "unit": "EMU" }, "height": { "magnitude": 9000, "unit": "EMU" } }, "transform": { "scaleX": 381, "scaleY": 381, "translateX": 152400, "translateY": 152400, "unit": "EMU" } }, "source": "YOUTUBE", "id": VIDEO_ID } } ] }
Elemente kopieren und bearbeiten
Die folgenden
presentations.batchUpdate
wird gezeigt, wie Sie mit der
DuplicateObjectRequest
eine vorhandene Form (angegeben durch das
PAGE_ELEMENT_ID) und erstellen Sie eine Kopie (angegeben durch die
COPY_ELEMENT_ID).
In den nachfolgenden Anfragen werden dann die folgenden Änderungen am doppelten Objekt vorgenommen:
- Als Hintergrundfarbe wird die Designfarbe
LIGHT2
festgelegt. - Die Kopie wird auf der Seite nach unten verschoben (von der Position der ursprünglichen Form aus).
- Hiermit wird die Schriftart für Georgien (18 pt) festgelegt.
- Bearbeitet den Text, sodass er „Meine Form“ lautet.
Die Anfragen hier verwenden Feldmasken, um Formeigenschaften, die nicht geändert werden (z. B. der Umriss), Mit Feldmasken verbessern auch die Leistung.
Weitere Informationen zum Kopieren einer Folie finden Sie im Beispiel Eine Folie.
Das folgende Anfrageprotokoll dient zum Kopieren und Bearbeiten eines Elements:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "duplicateObject": { "objectId": PAGE_ELEMENT_ID, "objectIds": { PAGE_ELEMENT_ID: COPY_ELEMENT_ID } } }, { "updateShapeProperties": { "objectId": COPY_ELEMENT_ID, "fields": "shapeBackgroundFill.solidFill.color", "shapeProperties": { "shapeBackgroundFill": { "solidFill": { "color": { "themeColor": "LIGHT2" } } } } } }, { "updatePageElementTransform": { "objectId": COPY_ELEMENT_ID, "applyMode": "RELATIVE", "transform": { "scaleX": 1, "scaleY": 1, "translateX": 0, "translateY": 1250000, "unit": "EMU" } } }, { "updateTextStyle": { "objectId": COPY_ELEMENT_ID, "fields": "fontFamily,fontSize", "textRange": { "type": "ALL" }, "style": { "fontFamily": "Georgia", "fontSize": { "magnitude": 18, "unit": "PT" } } } }, { "deleteText": { "objectId": COPY_ELEMENT_ID, "textRange": { "type": "ALL" } } }, { "insertText": { "objectId": COPY_ELEMENT_ID, "text": "My Shape Copy", "insertionIndex": 0 } } ] }
So könnte eine Form und ihre Kopie nach diesen Aktualisierungen aussehen:
Bild- oder Videostruktur bearbeiten
Die folgenden
presentations.batchUpdate
wird gezeigt, wie Sie mit der
UpdateImagePropertiesRequest
-Methode zur Aktualisierung der Umrissdarstellung eines Bildes, das durch das
IMAGE_ELEMENT_ID Außerdem werden die
UpdateVideoPropertiesRequest
zur Aktualisierung des Umrisses eines eingebetteten Videos, das in den
VIDEO_ELEMENT_ID.
Mit den Anfragen werden die folgenden Änderungen am Objekt vorgenommen:
- Legt die Umrissfarbe des Bilds auf die Designfarbe
ACCENT5
mit Teilbild fest Transparenz. - Legt die Umrissfarbe des Videos auf die Designfarbe
ACCENT1
fest (ohne Transparenz. - Legt die Umrissstärken für beide auf 3 pt fest.
- Legt den Umrissstil des Bilds auf
SOLID
fest. - Hiermit wird der Videostrukturstil auf „
DASH_DOT
“ festgelegt.
Sowohl die Methode UpdateImagePropertiesRequest
als auch die Methode
Mit der UpdateVideoPropertiesRequest
-Methode kann nur die Darstellung des Bildes geändert werden
und Videokonzepte. Alle anderen Properties sind schreibgeschützt. Die Anfragen hier verwenden
Feldmasken, um anzugeben, dass nur der Umriss
geändert werden, um den Code vor zukünftigen API-Änderungen zu schützen. Feld verwenden
verbessert auch die Leistung.
Das folgende Anfrageprotokoll dient zum Bearbeiten einer Bild- oder Videostruktur:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updateImageProperties": { "objectId": IMAGE_ELEMENT_ID, "fields": "outline", "imageProperties": { "outline": { "dashStyle": "SOLID", "outlineFill": { "solidFill": { "alpha": 0.8, "color": { "themeColor": "ACCENT5" } } }, "weight": { "magnitude": 3, "unit": "PT" } } } } }, { "updateVideoProperties": { "objectId": VIDEO_ELEMENT_ID, "fields": "outline", "videoProperties": { "outline": { "dashStyle": "DASH_DOT", "outlineFill": { "solidFill": { "alpha": 0.8, "color": { "themeColor": "ACCENT1" } } }, "weight": { "magnitude": 3, "unit": "PT" } } } } } ] }
So könnten ein Bild und eingebettetes Video nach diesen Updates aussehen:
Umriss einer Form bearbeiten
Die folgenden
presentations.batchUpdate
wird gezeigt, wie Sie mit der
UpdateShapePropertiesRequest
eine vorhandene Form (angegeben durch das
PAGE_ELEMENT_ID) und aktualisiert das Aussehen des Umrisses.
Mit den Anfragen werden die folgenden Änderungen am Objekt vorgenommen:
- Legt die Umrissfarbe auf die Designfarbe
ACCENT5
mit Teilbild fest Transparenz. - Legt die Umrissstärke auf 3 pt fest.
- Legt den Umrissstil auf
LONG_DASH
fest.
Die Anfragen hier verwenden Feldmasken, um Formeigenschaften, die nicht geändert werden (z. B. die Formfüllfarbe) Mit Feldmasken verbessern auch die Leistung.
Mit dem folgenden Anfrageprotokoll können Sie den Umriss einer Form bearbeiten:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updateShapeProperties": { "objectId": PAGE_ELEMENT_ID, "fields": "outline", "shapeProperties": { "outline": { "dashStyle": "LONG_DASH", "outlineFill": { "solidFill": { "alpha": 0.6, "color": { "themeColor": "ACCENT5" } } }, "weight": { "magnitude": 3, "unit": "PT" } } } } } ] }
So könnte eine Form nach diesen Updates aussehen:
Text in einer Form oder einem Textfeld formatieren
Die folgenden
presentations.batchUpdate
wird gezeigt, wie Sie mit der
UpdateTextStyleRequest
eine vorhandene Form (angegeben durch das
PAGE_ELEMENT_ID) und aktualisiert das Aussehen des Textes.
Mit den Anfragen werden die folgenden Änderungen am Objekt vorgenommen:
- Legt die Textfarbe auf die Designfarbe
ACCENT5
fest. - Legt die Schrift auf fett, kursiv (18-pt-Corsiva) fest.
- Der Text wird unterstrichen.
Die Anfragen hier verwenden Feldmasken, um Textstileigenschaften, die nicht geändert werden (z. B. Hintergrundfarbe, Links oder Referenz-Offsets). Die Verwendung von Feldmasken verbessert auch die Leistung.
Das folgende Anfrageprotokoll dient zum Formatieren von Text in einer Form oder einem Textfeld:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updateTextStyle": { "objectId": PAGE_ELEMENT_ID, "fields": "foregroundColor,bold,italic,fontFamily,fontSize,underline", "style": { "foregroundColor": { "opaqueColor": { "themeColor": "ACCENT5" } }, "bold": true, "italic": true, "underline": true, "fontFamily": "Corsiva", "fontSize": { "magnitude": 18, "unit": "PT" } }, "textRange": { "type": "ALL" } } } ] }
So könnte der Formtext nach diesen Updates aussehen:
Diagramm aus Google Tabellen importieren
Die folgenden
presentations.batchUpdate
wird gezeigt, wie Sie mit der
CreateSheetsChartRequest
um ein Diagramm aus einem Tabellenblatt zu importieren und auf einer Folie zu platzieren,
PAGE_ID
Für den Antrag ist die Tabellen-ID erforderlich (angegeben durch die SPREADSHEET_ID) und die Diagramm-ID der Tabelle (angegeben durch das SPREADSHEET_CHART_ID). Die Diagramm-ID im Die Präsentation wird durch das PRESENTATION_CHART_ID
Die Anfrage legt auch die
LinkingMode
des Diagramms auf LINKED
aus, damit Sie die
eingebettetes Diagramm, wenn das Diagramm in der Quelltabelle aktualisiert wird.
Das folgende Anfrageprotokoll, aus dem ein Diagramm importiert werden soll Google Tabellen:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createSheetsChart": { "objectId": PRESENTATION_CHART_ID, "spreadsheetId": SPREADSHEET_ID, "chartId": SPREADSHEET_CHART_ID, "linkingMode": "LINKED", "elementProperties": { "pageObjectId": PAGE_ID, "size": { "width": { "magnitude": 4000000, "unit": "EMU" }, "height": { "magnitude": 4000000, "unit": "EMU" } }, "transform": { "scaleX": 1, "scaleY": 1, "translateX": 100000, "translateY": 100000, "unit": "EMU" } } } ] }
Diagramme aus Google Tabellen aktualisieren
Die folgenden
presentations.batchUpdate
wird gezeigt, wie Sie mit der
RefreshSheetsChartRequest
-Methode aktualisieren, um ein verknüpftes Diagramm in einer Präsentation durch das neueste
Version dieses Diagramms aus der
Google Tabellen-Quelltabelle. Die
Für die Anfrage ist die Diagramm-ID in der Google-Präsentation erforderlich
(durch PRESENTATION_CHART_ID angegeben).
Das folgende Anfrageprotokoll dient zum Aktualisieren eines Diagramms aus Google Tabellen:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "refreshSheetsChart": { "objectId": PRESENTATION_CHART_ID } } ] }