Präsentationsvorgänge

Mit der Google Slides API können Sie Präsentationsdateien erstellen und vorhandene Dateien verwalten. In den Beispielen auf dieser Seite werden einige häufige Vorgänge für Präsentationsseiten mit der presentations.batchUpdate Methode gezeigt.

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

Präsentationen 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 files.create-Methode 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. Die files.list Methode (unten dargestellt) verwendet Feldmasken, um eine Liste von Präsentationsdateien aus Ihrem Drive zurückzugeben, einschließlich der Datei-ID, des Dateinamens und eines Links zum Öffnen der Datei. In der Anfrage wird auch application/vnd.google-apps.presentation als der 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 Präsentation ersetzen

Das folgende presentations.batchUpdate Codebeispiel zeigt, wie Sie mit der ReplaceAllTextRequest Methode Text in der Präsentation ersetzen, die durch PRESENTATION_IDangegeben wird. 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. Dies umfasst Text in Textfeldern und anderen Formen, auf Folien und in Masterfolien. In diesem Fall wird der Text nur ersetzt, wenn die Groß- und Kleinschreibung übereinstimmt, da matchCase auf true gesetzt 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."
      }
    }
  ]
}