Folienvorgänge

Mit der Google Slides 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. Den Wert für diese ID finden Sie in der Präsentations-URL.
• PAGE_ID und PAGE_ID2: Hier geben Sie die Seitenobjekt-IDs an. Sie können den Wert dafür aus der URL oder mit einer API-Leseanfrage abrufen.

Diese Beispiele werden als HTTP-Anfragen dargestellt, um sprachneutral zu sein. Informationen zum Implementieren einer Batch-Aktualisierung 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 Methode DuplicateObjectRequest eine Folie kopieren und nach dem Original in die Präsentation einfügen. Die Originalfolie wird durch PAGE_ID angegeben.

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

Weitere Informationen zum Kopieren eines 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

Das folgende presentations.batchUpdate-Codebeispiel zeigt, wie Sie mit der Methode CreateSlideRequest eine Folie erstellen und als vierte Folie (mit dem nullbasierten 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 die API die PAGE_ID generieren lassen, indem Sie das Feld in der Anfrage weglassen.

Im Folgenden finden Sie das Anfrageprotokoll 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 bearbeiten

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 einen String angeben, der als PAGE_ID für die Folie verwendet werden soll (mit einigen Einschränkungen). Die placeholderIdMappings verwendet die Type von TITLE. Mit TITLE_ID wird auf die Platzhalterform der Folie verwiesen, damit sie geändert werden kann.

Das Anfrageprotokoll zum Erstellen einer Folie und zum Ändern von Platzhaltern sieht so aus:

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 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 null und der Anzahl der Folien in der Präsentation liegen (einschließlich).

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

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

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

Alternativ kann die Methode UpdatePagePropertiesRequest verwendet werden, um den Hintergrund einer Folie auf eine Volltonfarbe festzulegen.

Im Folgenden finden Sie das Anfrageprotokoll zum Festlegen eines Folienhintergrundbilds:

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. Diese gibt ein Thumbnail der Seite als Inhalts-URL zurück. Die Bild-URL hat eine Standardlaufzeit von 30 Minuten.

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

Das folgende Protokoll zeigt, wie die Miniaturansicht der Seite mit dem festgelegten ThumbnailProperties generiert wird:

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