Präsentationsvorgänge

Mit der Google Präsentationen API können Sie Präsentationsdateien erstellen und vorhandene verwalten. Die Beispiele auf dieser Seite zeigen einige gängige Vorgänge zur Seitenpräsentation mit der Methode presentations.batchUpdate.

Diese Beispiele werden als HTTP-Anfragen dargestellt, um sprachenunabhängig zu sein. Informationen zum Implementieren eines Batch-Updates in verschiedenen Sprachen mit den Clientbibliotheken der Google API finden Sie in den folgenden Anleitungen:

Präsentation erstellen

Im folgenden presentations.create-Codebeispiel wird gezeigt, wie eine leere Präsentationsdatei mit dem Titel „Meine neue Präsentation“ erstellt wird.

Sie können auch leere Präsentationsdateien mit der Google Drive API-Methode files.create erstellen, indem Sie application/vnd.google-apps.presentation als MIME-Typ angeben.

Im Folgenden finden Sie das Anfrageprotokoll zum Erstellen einer Präsentation:

POST https://slides.googleapis.com/v1/presentations
{
  "title": "My New Presentation"
}

Vorhandene Präsentationsdateien auflisten

Die Google Präsentationen API bietet keine Methode zum Abrufen einer Liste von Präsentationen. Die Drive API bietet jedoch eine solche Methode. Bei der Methode files.list (unten dargestellt) werden Feldmasken verwendet, um eine Liste der Präsentationsdateien aus Google Drive mit der Datei-ID, dem Dateinamen und einem Link zum Öffnen der Datei zurückzugeben. In der Anfrage wird auch application/vnd.google-apps.presentation als MIME-Typ angegeben.

Im Folgenden ist das Anfrageprotokoll zum Auflisten vorhandener Präsentationsdateien aufgeführt:

GET https://www.googleapis.com/drive/v3/files?q="mimeType=application/vnd.google-apps.presentation"&fields=files(id,name,webViewLink)

Die Antwort auf diese Anfrage hat die folgende Struktur:

{
 "files": [
    {
     "id": "abcdefghijklmnopqrstuvwxyz0123456789",
     "name": "Project Vision",
     "webViewLink": "https://docs.google.com/a/google.com/presentation/d/abcdefghijklmnopqrstuvwxyz0123456789/edit?usp=drivesdk"
    },
    {
     "id": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789",
     "name": "Untitled Presentation",
     "webViewLink": "https://docs.google.com/a/google.com/presentation/d/ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/edit?usp=drivesdk"
    },
    ...
  ]
}

Text in einer Präsentation ersetzen

Im folgenden Codebeispiel für presentations.batchUpdate wird gezeigt, wie mit der Methode ReplaceAllTextRequest Text in der gesamten Präsentation durch den mit PRESENTATION_ID angegebenen Text ersetzt wird. Sie finden den Wert für die Präsentations-ID in der URL der Präsentation.

Jede Instanz des Strings „Gizmo Corp.“ wird durch den Text „Gadget Inc.“ ersetzt. Dazu gehören Text in Textfeldern und anderen Formen, auf Folien und in Masterfolien. In diesem Fall wird bei der Textersetzung die Groß- und Kleinschreibung berücksichtigt, da matchCase auf true festgelegt ist.

Im Folgenden finden Sie das Anfrageprotokoll zum Ersetzen von Text in einer Präsentation:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "replaceAllText": {
          "containsText": {
            "text": "Gizmo Corp.",
            "matchCase": true
          },
          "replaceText": "Gadget Inc."
      }
    }
  ]
}