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. Sie finden den Wert für diese ID in der Präsentations-URL.
  • PAGE_ID und PAGE_ID2: Gibt an, wo Sie die Seitenobjekt-IDs angeben. Sie können den Wert hierfür aus der URL oder über eine API-Leseanfrage abrufen.

Diese Beispiele werden als sprachneutrale HTTP-Anfragen dargestellt. Informationen zum Implementieren einer Batch-Aktualisierung in verschiedenen Sprachen mithilfe der Google API-Clientbibliotheken finden Sie in den folgenden Anleitungen: Folie erstellen und Formen und Text hinzufügen.

Folien kopieren

Das folgende Codebeispiel presentations.batchUpdate 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 Seitenelement-IDs in der Kopie enthalten sein sollen (mit einigen Einschränkungen). In diesem Beispiel enthält die ursprüngliche Folie ein durch TABLE_ELEMENT_ID angegebenes Tabellenelement, das in der Folienkopie (durch COPY_PAGE_ID angegeben) einer neuen Tabelle zugeordnet ist (angegeben durch COPY_TABLE_ELEMENT_ID). Alle anderen Elemente in der Kopie erhalten zufällige IDs.

Weitere Informationen zum Kopieren eines PageElement, einschließlich Textfeldern, Bildern, Tabellen, Grundformen, Linien und eingebetteten Videos, finden Sie im Beispiel Elemente kopieren und bearbeiten.

Das Anfrageprotokoll für das Kopieren einer Folie lautet wie folgt:

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

Folien erstellen

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

Die neue Folie soll PredefinedLayout von TITLE_AND_TWO_COLUMNS verwenden. Sie können einen String angeben, der als PAGE_ID für die Folie verwendet werden soll (mit einigen Einschränkungen), oder der API erlauben, den PAGE_ID zu generieren, indem Sie das Feld in der Anfrage weglassen.

Das Anfrageprotokoll für die Erstellung einer Folie lautet wie folgt:

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 Codebeispiel presentations.batchUpdate zeigt, wie Sie mit der Methode CreateSlideRequest eine Folie mit 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). Der placeholderIdMappings verwendet den Type von TITLE. TITLE_ID verweist auf die Platzhalterform der Folie, sodass sie geändert werden kann.

Das Anfrageprotokoll für die Erstellung einer Folie und das Ändern von Platzhaltern lautet wie folgt:

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 Codebeispiel presentations.batchUpdate zeigt, wie Sie mit der Methode UpdateSlidesPositionRequest die beiden angegebenen Folien in ihrer relativen Reihenfolge an den Anfang der Präsentation verschieben.

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 in der Reihenfolge vor dem Verschieben eingefügt werden sollen. Der Wert muss zwischen 0 und der Anzahl der Folien 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 Folien festlegen

Das folgende Codebeispiel presentations.batchUpdate zeigt, wie Sie mit der Methode UpdatePagePropertiesRequest das Hintergrundbild einer Folie festlegen, das durch die PAGE_ID angegeben wird. Die API ruft das Bild mithilfe von 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 die Methode UpdatePagePropertiesRequest verwendet werden, um für den Hintergrund einer Folie eine Volltonfarbe festzulegen.

Das Anfrageprotokoll zur Festlegung eines Folien-Hintergrundbilds lautet wie folgt:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "updatePageProperties": {
        "objectId": PAGE_ID,
        "pageProperties": {
          "pageBackgroundFill": {
            "stretchedPictureFill": {
              "contentUrl": IMAGE_URL
            }
          }
        },
        "fields": "pageBackgroundFill"
      }
    }
  ]
}

Miniaturansicht erstellen

Sie können eine Miniaturansicht der neuesten Version einer bestimmten Seite in der Präsentation generieren, indem Sie die Methode presentations.pages.getThumbnail aufrufen. Diese gibt eine Miniaturansicht der Seite als Inhalts-URL zurück. Die Bild-URL hat eine Standardlebensdauer von 30 Minuten.

Sie können auch die zurückgegebenen mimeType und thumbnailSize angeben, indem Sie das Feld ThumbnailProperties als Abfrageparameter verwenden.

Das folgende Anfrageprotokoll wird zum Generieren der Miniaturansicht der Seite mit der Einstellung 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"
}