Mit der Google Präsentationen API können Sie Folien erstellen, verschieben und löschen. Die Beispiele auf dieser Seite zeigen einige gängige Folienvorgänge mit der Methode presentations.batchUpdate.
In diesen Beispielen werden die folgenden Variablen verwendet:
- PRESENTATION_ID: Gibt an, wo Sie die Präsentations-ID angeben. Sie finden den Wert für diese ID in der URL der Präsentation.
- PAGE_ID und PAGE_ID2: Gibt an, wo Sie die IDs der Seitenobjekte angeben. Sie können den Wert dafür über die URL oder mithilfe einer API-Leseanfrage abrufen.
Diese Beispiele werden als HTTP-Anfragen dargestellt, um sprachenunabhängig zu sein. Weitere Informationen zum Implementieren eines Batch-Updates in verschiedenen Sprachen mit den Google API-Clientbibliotheken finden Sie in den folgenden Anleitungen: Folie erstellen und Formen und Text hinzufügen.
Folie kopieren
Im folgenden Codebeispiel presentations.batchUpdate wird gezeigt, wie Sie mit der Methode DuplicateObjectRequest eine Folie kopieren und nach dem Original in die Präsentation einfügen.
Die Originalfolie wird durch PAGE_ID angegeben.
Sie können angeben, ob einige oder alle Seitenelement-IDs in der Kopie enthalten sein sollen (mit einigen Einschränkungen). In diesem Beispiel enthält die ursprüngliche Folie ein Tabellenelement (TABLE_ELEMENT_ID), das in der Folienkopie (COPY_PAGE_ID) einer neuen Tabelle (COPY_TABLE_ELEMENT_ID) zugeordnet ist. Alle anderen Elemente in der Kopie erhalten zufällige IDs.
Weitere Informationen zum Kopieren von PageElement, einschließlich Textfeldern, Bildern, Tabellen, einfachen Formen, Linien und eingebetteten Videos, finden Sie im Beispiel Element kopieren und bearbeiten.
Im Folgenden finden Sie das Anfrageprotokoll 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"
}
}
}
]
}
Folie erstellen
Im folgenden Codebeispiel für presentations.batchUpdate wird gezeigt, wie Sie mit der Methode CreateSlideRequest eine Folie erstellen und als vierte Folie (mit der 0-basierten insertionIndex) in die Präsentation einfügen.
Für die neue Folie wird die PredefinedLayout von TITLE_AND_TWO_COLUMNS verwendet. Sie können einen String als PAGE_ID für die Folie angeben (mit einigen Einschränkungen) oder der API erlauben, den PAGE_ID zu generieren, indem Sie das Feld in der Anfrage weglassen.
Im Folgenden ist das Anfrageprotokoll zum Erstellen einer Folie aufgeführt:
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
Im folgenden Codebeispiel für presentations.batchUpdate wird gezeigt, wie Sie mit der Methode CreateSlideRequest eine Folie mit dem PredefinedLayout von TITLE_AND_TWO_COLUMNS erstellen.
Sie können einen String als PAGE_ID für die Folie angeben (mit einigen Einschränkungen).
Die placeholderIdMappings verwendet den Type von TITLE. Der Platzhalter TITLE_ID verweist auf die Platzhalterform der Folie und kann daher geändert werden.
Im Folgenden finden Sie das Anfrageprotokoll 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
Im folgenden Codebeispiel für presentations.batchUpdate wird gezeigt, wie Sie mit der Methode UpdateSlidesPositionRequest die beiden angegebenen Folien an den Anfang der Präsentation verschieben, wobei ihre relative Reihenfolge beibehalten wird.
Die angegebenen Folien-IDs (PAGE_ID und PAGE_ID2) müssen in der vorhandenen Präsentationsreihenfolge angegeben werden und dürfen nicht doppelt vorhanden sein. Die insertionIndex, die auf null basiert, gibt an, wo die Folien eingefügt werden sollen, basierend auf der Reihenfolge vor dem Verschieben. Der Wert muss zwischen null und der Anzahl der Folien in der Präsentation liegen.
Im Folgenden finden Sie das Anfrageprotokoll zum Verschieben von Folien an eine neue Position:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updateSlidesPosition": {
"slideObjectIds": [
PAGE_ID,
PAGE_ID2
],
"insertionIndex": 0
}
}
]
}
Hintergrundbild für eine Folie festlegen
Im folgenden Codebeispiel für presentations.batchUpdate wird gezeigt, wie mit der Methode UpdatePagePropertiesRequest das Hintergrundbild einer Folie festgelegt wird, die durch PAGE_ID angegeben wird. Die API ruft das Bild mithilfe der IMAGE_URL ab.
Mit einer Feldmaske können Sie angeben, dass nur der Hintergrund der Folie geändert werden soll, um die anderen Eigenschaften beizubehalten. Die Verwendung von Feldmasken verbessert ebenfalls die Leistung.
Alternativ können Sie mit einer UpdatePagePropertiesRequest-Methode den Hintergrund einer Folie in einer einfarbigen Farbe festlegen.
Im Folgenden finden Sie das Anfrageprotokoll zum Festlegen eines Hintergrundbilds für eine Folie:
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
Sie können ein Thumbnail der neuesten Version einer bestimmten Seite in der Präsentation generieren, indem Sie die Methode presentations.pages.getThumbnail aufrufen. Dadurch wird ein Thumbnail-Bild der Seite als Inhalts-URL zurückgegeben. Die Standardlebensdauer der Bild-URL beträgt 30 Minuten.
Sie können mimeType und thumbnailSize auch mit dem Feld ThumbnailProperties als Abfrageparameter zurückgeben.
Im Folgenden findest du das Anfrageprotokoll zum Generieren der Miniaturansicht der Seite mit dem ThumbnailProperties-Set:
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"
}