Erweiterte APIs

Mit den erweiterten APIs in Google Ads-Scripts können Entwickler mit weniger Aufwand als bei Verwendung der HTTP-Schnittstellen eine Verbindung zu bestimmten öffentlichen Google-APIs herstellen. Sie können diese APIs ähnlich wie die integrierten Dienste von Scripts verwenden und sie bieten dieselben Vorteile wie automatische Vervollständigung und automatische Autorisierung.

Auf unserer Seite mit Code-Snippets finden Sie einige Beispiele für die Verwendung dieser APIs.

Verfügbare erweiterte APIs

Google Analytics
Mit Google Analytics können Sie die Zugriffe auf Ihre Website erfassen und Ihre Kampagnengebote entsprechend anpassen. Wenn Sie eine Google Analytics-Property mit Ihrem Google Ads-Konto verknüpfen, können Sie auch die Nutzeraktivitäten auf Ihrer Website analysieren. Anhand dieser Informationen lässt sich erkennen, welcher Anteil Ihrer Websitezugriffe oder Ihres Umsatzes auf Google Ads entfällt. Außerdem können Sie Ihre Anzeigen und Ihre Website basierend auf diesen Daten optimieren. Weitere Informationen zum Verknüpfen von Analytics- und Google Ads-Konten
Google BigQuery
Sie können große Datenmengen in Google Cloud Storage laden und diese Daten dann mit Google BigQuery abfragen. Sie können beispielsweise öffentliche Wetterdaten für die letzten 10 Jahre laden und dann in einem Skript, in dem Gebote angepasst werden, die Durchschnittstemperatur einer Region abfragen. Eine weitere Anwendungsmöglichkeit ist die Analyse der Leistungsdaten Ihres Kontos über mehrere Jahre hinweg.
Google Kalender
Mit Ihrem Skript können Sie Termine für zukünftige Aufgaben erstellen (z. B. in zwei Wochen einen Leistungsbericht für Ihre Kampagnen erstellen) oder Aktionen basierend auf einem Eintrag in Ihrem Kalender ausführen (z. B. eine Kampagne an einem bestimmten Datum aktivieren).
Google Präsentationen
Mit Ihrem Script können Sie Kampagnendetails oder ‑statistiken in Google-Präsentationen exportieren, um diese Informationen in einem präsentablen Format zu veröffentlichen.
Google Tasks
Mit Ihrem Skript können Sie eine Erinnerungsliste für zukünftige Aufgaben erstellen (z. B. einen Leistungsbericht für Ihre Kampagnen in zwei Wochen erstellen) oder Aktionen basierend auf einem Eintrag in Ihrer Erinnerungsliste ausführen (z. B. eine Kampagne an einem bestimmten Datum aktivieren).
Merchant API
Mit Ihrem Script können Sie die Merchant API verwenden, um Ihre Produkteinträge hochzuladen und zu verwalten sowie Ihre Google Merchant Center-Konten zu verwalten. In Scripts kann dies nützlich sein, um Produkteinträge zu prüfen und bestimmte Produkte mit bestimmten Anzeigen zu verknüpfen. Die Merchant API hat untergeordnete APIs, die im Dialogfeld Erweiterte APIs einzeln aktiviert werden können. Weitere Informationen zum Verknüpfen Ihres Google Merchant Center-Kontos
Shopping-Inhalte
Mit Ihrem Script können Sie die Google Content API for Shopping verwenden, um Ihre Produkteinträge hochzuladen und zu verwalten sowie Ihre Google Merchant Center-Konten zu verwalten. In Scripts kann dies nützlich sein, um Produkteinträge zu prüfen und bestimmte Produkte mit bestimmten Anzeigen zu verknüpfen. Hinweis:Die Content API for Shopping wird am 18. August 2026 eingestellt. Verwenden Sie stattdessen die Merchant API, die im vorherigen Abschnitt beschrieben wird.
YouTube und YouTube Analytics
Sie können Ihre Videos, Playlists usw. sowie die Leistungsdaten Ihrer Videos abrufen und aktualisieren, um Gebotsentscheidungen zu treffen.

Erweiterte APIs aktivieren

Wenn Sie sehen möchten, welche Google-APIs als erweiterte APIs verfügbar sind, klicken Sie in der oberen Bearbeitungsleiste auf Erweiterte APIs, um das Dialogfeld Erweiterte APIs aufzurufen. Wählen Sie die APIs aus, die Sie aktivieren möchten.

Klicken Sie auf Speichern, um Ihre Auswahl zu speichern und zum Script-Editor zurückzukehren. Die neuen APIs werden für Ihr Skript aktiviert und sind in der Liste für die automatische Vervollständigung verfügbar.

Weitere Überlegungen

Bei der Arbeit mit den erweiterten APIs sind einige Dinge zu beachten.

Abhängigkeiten

Nur der Nutzer, der das Skript im Konto erstellt hat, kann die Abhängigkeiten von erweiterten APIs für dieses Skript ändern.

Berechtigungen

Beim Zugriff auf die APIs verwendet ein Script die Berechtigungen des Nutzers, der das Script autorisiert hat. Achten Sie darauf, dass der Nutzer, der das Skript autorisiert hat, den erforderlichen Zugriff auf alle Daten hat, die das Skript benötigt. Wenn Sie die Google Analytics API verwenden, prüfen Sie, ob der Nutzer, der das Skript autorisiert hat, die erforderlichen Berechtigungen für das Analytics-Konto hat, auf das zugegriffen wird.

Hinweise zu Skripts vor Mai 2019

Bei Skripts, die vor Mai 2019 erstellt wurden, müssen Sie die entsprechenden APIs möglicherweise manuell im zugehörigen Google Cloud-Projekt des Skripts aktivieren. Ob Ihr Skript betroffen ist, erkennen Sie daran, dass im Dialogfeld „Erweiterte APIs“ ein Link zur Google Cloud Console angezeigt wird.

Erweiterte APIs aktivieren

Bei Skripten, die vor 2019 erstellt wurden, müssen Sie jede erweiterte API, die Sie in Ihrem Skript verwenden möchten, manuell aktivieren:

  1. Klicken Sie auf die Schaltfläche Advanced APIs (Erweiterte APIs). Klicken Sie im folgenden Dialogfeld auf den Link zur Google Cloud Console.
  2. Wenn Ihr Projekt noch nicht ausgewählt ist, wählen Sie es aus der Drop-down-Liste „Projekt“ aus.
  3. Suchen Sie nach den APIs, die Sie in Ihrem Skript verwenden möchten, indem Sie den API-Namen in die Suchleiste eingeben.
  4. Wählen Sie die API in den Suchergebnissen aus und klicken Sie auf der folgenden Seite auf die Schaltfläche „Aktivieren“.

Wenn der Nutzer, der das Skript erstellt hat, später aus dem Konto entfernt wird, werden alle neuen Nutzer, die auf das Skript zugreifen möchten, aufgefordert, die erweiterten API-Abhängigkeiten noch einmal zu aktivieren und das Skript neu zu autorisieren.