Präsentationsvorgänge

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

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:

Präsentation erstellen

Das folgende presentations.create-Codebeispiel zeigt, 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 Slides API bietet keine Methode zum Abrufen einer Liste von Präsentationen, die Drive API jedoch schon. Bei der Methode files.list (siehe unten) werden Feldmasken verwendet, um eine Liste von Präsentationsdateien aus Ihrem Drive zurückzugeben, die die Datei-ID, den Dateinamen und einen Link zum Öffnen der Datei enthält. In der Anfrage wird auch application/vnd.google-apps.presentation als MIME-Typ angegeben.

Im Folgenden finden Sie das Anfrageprotokoll zum Auflisten vorhandener Präsentationsdateien:

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 gesamten Präsentation ersetzen

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

Jedes Vorkommen des Strings „Gizmo Corp.“ wird durch den Text „Gadget Inc.“ ersetzt. Dazu gehören Text in Textfeldern und anderen Formen, auf Folien und in Vorlagen. In diesem Fall wird beim Ersetzen von Text die Groß-/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."
      }
    }
  ]
}