Folienvorgänge

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