Mit der Google Slides API können Sie Folien erstellen, verschieben und löschen. Die Beispiele auf
einige gängige Folienoperationen 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 finden Sie den Wert für diese ID in der Präsentations-URL.
- PAGE_ID und PAGE_ID2: gibt an, wo legen Sie das Seitenobjekt IDs: Sie können die Daten abrufen, den Wert hierfür aus der URL oder mithilfe einer API-Leseanfrage.
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 Clientbibliotheken finden Sie in den folgenden Anleitungen: Eine Folie und Formen und Formen hinzufügen Text
Folien kopieren
Die folgenden
presentations.batchUpdate
wird gezeigt, wie Sie mit der
DuplicateObjectRequest
eine Folie zu kopieren und nach dem Original in die Präsentation einzufügen.
Die Originalfolie wird durch PAGE_ID festgelegt.
Mit der Anfrage können Sie angeben, ob einige oder alle Seitenelement-IDs in die Kopie (mit einigen Einschränkungen). In diesem Beispiel enthält die Originalfolie ein Tabellenelement (angegeben durch die TABLE_ELEMENT_ID), die einer neuen Tabelle zugeordnet ist (angegeben durch COPY_TABLE_ELEMENT_ID) in der Folienkopie (angegeben durch die COPY_PAGE_ID. Alle anderen Elemente in der Kopie werden nach dem Zufallsprinzip vergeben. IDs.
Weitere Informationen zum Kopieren eines
PageElement
,
darunter Textfelder, Bilder, Tabellen,
Basisformen, Linien und eingebettete Videos,
Beispiel kopieren und bearbeiten
-Element.
Das folgende Anfrageprotokoll dient zum Kopieren einer Folie:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "duplicateObject": { "objectId": PAGE_ID, "objectIds": { "PAGE_ID": "COPY_PAGE_ID", "TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID" } } } ] }
Erstelle eine Folie
Die folgenden
presentations.batchUpdate
wird gezeigt, wie Sie mit der
CreateSlideRequest
um eine Folie zu erstellen und als vierte Folie einzufügen (mithilfe der nullbasierten
insertionIndex
) in der Präsentation.
Auf der neuen Folie wird
PredefinedLayout
von TITLE_AND_TWO_COLUMNS
. Sie können einen String angeben, der als
PAGE_ID für die Folie (mit einigen
Einschränkungen)
oder zulassen, dass die API die PAGE_ID generiert, indem Sie das Feld weglassen
in der Anfrage.
Das folgende Anfrageprotokoll dient zum Erstellen einer Folie:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createSlide": { "objectId": "PAGE_ID", "insertionIndex": 3, "slideLayoutReference": { "predefinedLayout": "TITLE_AND_TWO_COLUMNS" } } } ] }
Folie erstellen und Platzhalter ändern
Die folgenden
presentations.batchUpdate
wird gezeigt, wie Sie mit der
CreateSlideRequest
zum Erstellen einer Folie
PredefinedLayout
von TITLE_AND_TWO_COLUMNS
.
Sie können einen String angeben, der als PAGE_ID für die Folie verwendet werden soll.
(mit einigen
Einschränkungen) angezeigt.
Die
placeholderIdMappings
verwendet die
Type
von
TITLE
TITLE_ID verweist auf die Platzhalterform der Folie.
damit er geändert werden kann.
Das folgende Anfrageprotokoll dient zum Erstellen einer Folie und zum Ändern von Platzhaltern:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createSlide": { "objectId": PAGE_ID, "slideLayoutReference": { "predefinedLayout": "TITLE_AND_TWO_COLUMNS" }, "placeholderIdMappings": [ { "layoutPlaceholder": { "type": "TITLE", "index": 0 }, "objectId": TITLE_ID, }, ], } }, { "insertText": { "objectId": TITLE_ID, "text": "This is my slide title", } }, ] }
Folien an eine neue Position verschieben
Die folgenden
presentations.batchUpdate
wird gezeigt, wie Sie mit der
UpdateSlidesPositionRequest
die beiden angegebenen Folien an den Anfang der
Präsentation, wobei ihre relative Reihenfolge beibehalten wird.
Die angegebenen Folien-IDs (PAGE_ID und PAGE_ID2)
müssen in der vorhandenen Präsentationsreihenfolge ohne Duplikate angegeben werden. Die
insertionIndex
gibt an, wo die Folien eingefügt werden sollen.
in der Bestellung vor dem Verschieben. Der Wert muss zwischen 0 und der
Folien in der Präsentation enthalten.
Mit dem folgenden Anfrageprotokoll werden Folien an eine neue Position verschoben:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updateSlidesPosition": { "slideObjectIds": [ PAGE_ID, PAGE_ID2 ], "insertionIndex": 0 } } ] }
Hintergrundbild für Folien festlegen
Die folgenden
presentations.batchUpdate
wird gezeigt, wie Sie mit der
UpdatePagePropertiesRequest
zum Festlegen des Hintergrundbilds einer Folie, die durch das
PAGE_ID Die API ruft das Bild mithilfe der Methode
IMAGE_URL
Mit einer Feldmaske wird angegeben, dass nur die Folienhintergrund sollte geändert werden, um die anderen Eigenschaften beizubehalten. Feld verwenden verbessert auch die Leistung.
Alternativ kann die Methode UpdatePagePropertiesRequest
verwendet werden, um den Parameter
einer Folie in eine Volltonfarbe ändern.
Das folgende Anfrageprotokoll dient zum Festlegen eines Folien-Hintergrundbilds:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updatePageProperties": { "objectId": PAGE_ID, "pageProperties": { "pageBackgroundFill": { "stretchedPictureFill": { "contentUrl": IMAGE_URL } } }, "fields": "pageBackgroundFill" } } ] }
Miniaturansicht generieren
Eine Miniaturansicht der neuesten Version einer bestimmten Seite können Sie im
indem Sie die Methode
presentations.pages.getThumbnail
, die eine Miniaturansicht der Seite als Inhalts-URL zurückgibt. Das Bild
Die URL hat eine Standardlebensdauer von 30 Minuten.
Sie können auch die zurückgegebenen Werte für mimeType
und thumbnailSize
mithilfe der
ThumbnailProperties
als Suchparameter angeben.
Mit dem folgenden Anfrageprotokoll wird die Miniaturansicht der Seite mit dem
ThumbnailProperties
festgelegt:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM
{ "width": 800, "height": 450, "contentUrl": "CONTENT_URL" }