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äufige Vorgänge für Präsentationsseiten mit der presentations.batchUpdate Methode.

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äsentation erstellen

Das folgende presentations.create Codebeispiel zeigt, wie Sie eine leere Präsentationsdatei mit dem Titel „Meine neue Präsentation“ erstellen.

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 (siehe unten) 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 beim Ersetzen von Text die Groß-/Kleinschreibung berücksichtigt, indem matchCase auf true gesetzt wird.

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