Folienvorgänge

Mit der Google Präsentationen API können Sie Präsentationen erstellen, verschieben und löschen. Die Beispiele auf dieser Seite zeigen einige häufige Folienvorgänge mit der presentations.batchUpdate Methode.

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 Präsentations-URL.
• PAGE_ID und PAGE_ID2: Gibt an, wo Sie die Objekt-IDs der Seite angeben. Sie können den Wert dafür aus der URL abrufen oder eine API-Lesenanfrage verwenden.

Diese Beispiele werden als HTTP-Anfragen dargestellt, um sprachneutral zu sein. Informationen zum Implementieren einer Batchaktualisierung in verschiedenen Sprachen mit den Google API Clientbibliotheken finden Sie in den folgenden Anleitungen: Folie erstellen und Formen und Text hinzufügen.

Folie kopieren

Das folgende presentations.batchUpdate Codebeispiel zeigt, wie Sie mit der DuplicateObjectRequest Methode eine Folie kopieren und sie in der Präsentation nach der Originalfolie einfügen. Die Originalfolie wird durch PAGE_ID angegeben.

In der Anfrage können Sie angeben, ob einige oder alle Seiten-Element-IDs in der Kopie enthalten sein sollen (mit einigen Einschränkungen). In diesem Beispiel enthält die Originalfolie ein Tabellenelement (angegeben durch das TABLE_ELEMENT_ID), das in der Folienkopie (angegeben durch das COPY_PAGE_ID) einer neuen Tabelle (angegeben durch das COPY_TABLE_ELEMENT_ID) zugeordnet ist. Alle anderen Elemente in der Kopie erhalten zufällige IDs.

Weitere Informationen zum Kopieren eines PageElement, einschließlich Textfelder, Bilder, Tabellen, Grundformen, Linien und eingebetteter Videos, finden Sie im Beispiel Element kopieren und bearbeiten.

Das folgende Protokoll wird für die Anfrage zum Kopieren einer Folie verwendet:

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

Das folgende presentations.batchUpdate Codebeispiel zeigt, wie Sie mit der Methode CreateSlideRequest eine Folie erstellen und sie als vierte Folie (mit dem nullbasierten insertionIndex) in die Präsentation einfügen.

Für die neue Folie wird das PredefinedLayout von TITLE_AND_TWO_COLUMNS verwendet. Sie können eine String angeben, die als PAGE_ID für die Folie verwendet werden soll (mit einigen Einschränkungen), oder die API die PAGE_ID generieren lassen, indem Sie das Feld in der Anfrage weglassen.

Das folgende Protokoll wird für die Anfrage zum Erstellen einer Folie verwendet:

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

Das folgende presentations.batchUpdate Codebeispiel zeigt, wie Sie mit der Methode CreateSlideRequest eine Folie mit dem PredefinedLayout von TITLE_AND_TWO_COLUMNS erstellen.

Sie können eine String angeben, die als PAGE_ID für die Folie verwendet werden soll (mit einigen Einschränkungen). Für placeholderIdMappingswird der Typevon TITLEverwendet. Der TITLE_ID verweist auf die Platzhalterform der Folie , damit sie geändert werden kann.

Das folgende Protokoll wird für die Anfrage zum Erstellen einer Folie und zum Ändern von Platzhaltern verwendet:

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

Das folgende presentations.batchUpdate Codebeispiel zeigt, wie Sie mit der Methode UpdateSlidesPositionRequest die beiden angegebenen Folien an den Anfang der Präsentation verschieben und dabei ihre relative Reihenfolge beibehalten.

Die angegebenen Folien-IDs (PAGE_ID und PAGE_ID2) müssen in der vorhandenen Präsentationsreihenfolge und ohne Duplikate angegeben werden. Der nullbasierte insertionIndex gibt an, wo die Folien eingefügt werden sollen, basierend auf der Reihenfolge vor dem Verschieben. Der Wert muss zwischen 0 und der Anzahl der Folien in der Präsentation liegen (einschließlich).

Das folgende Protokoll wird für die Anfrage zum Verschieben von Folien an eine neue Position verwendet:

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

Das folgende presentations.batchUpdate Codebeispiel zeigt, wie Sie mit der UpdatePagePropertiesRequest Methode das Hintergrundbild einer Folie festlegen, die durch die PAGE_IDangegeben wird. Die API ruft das Bild mit der IMAGE_URL ab.

Mit einer Feldmaske wird angegeben, dass nur der Folienhintergrund geändert werden soll, um die anderen Eigenschaften beizubehalten. Die Verwendung von Feldmasken verbessert auch die Leistung.

Alternativ kann mit der Methode UpdatePagePropertiesRequest der Hintergrund einer Folie auf eine Vollfarbe festgelegt werden.

Das folgende Protokoll wird für die Anfrage zum Festlegen eines Hintergrundbilds für eine Folie verwendet:

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 eine Miniaturansicht der neuesten Version einer bestimmten Seite in der Präsentation generieren, indem Sie die presentations.pages.getThumbnail Methode aufrufen. Diese gibt eine Miniaturansicht der Seite als Content-URL zurück. Die Bild-URL hat eine Standardlebensdauer von 30 Minuten.

Sie können auch mimeType und thumbnailSize angeben, die mit dem ThumbnailProperties Feld als Abfrageparameter zurückgegeben werden.

Das folgende Protokoll wird für die Anfrage zum Generieren der Miniaturansicht der Seite mit den festgelegten ThumbnailProperties verwendet:

 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"
}