Mit den erweiterten APIs in Google Ads-Skripts können erfahrene Entwickler eine Verbindung zu bestimmten öffentlichen Google APIs mit weniger Einrichtungsaufwand als mit HTTP-Schnittstellen herstellen. Sie verwenden diese APIs ähnlich wie die integrierten Dienste von Skripts und bieten die gleichen Vorteile wie automatische Vervollständigung und automatische Autorisierung.
Mögliche Anwendungen für erweiterte APIs
- Google Analytics
- Mit Google Analytics können Sie die Zugriffe auf Ihre Website erfassen und die Gebote für Ihre Kampagnen entsprechend anpassen. Wenn Sie eine Google Analytics-Property mit Ihrem Google Ads-Konto verknüpfen, können Sie auch Kundenaktivitä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 anhand dieser Informationen optimieren. Weitere Informationen zum Verknüpfen von Analytics- und Google Ads-Konten finden Sie in der Google Ads-Hilfe.
- Google BigQuery
- Sie können große Datenmengen in Google Cloud Storage laden und diese Daten dann mit Google BigQuery abfragen. So lassen sich beispielsweise die Wetterdaten der letzten 10 Jahre aus der Öffentlichkeit laden und dann die Durchschnittstemperatur einer Region in einem Skript abfragen, das diese Informationen zum Anpassen von Geboten verwendet. Eine weitere Anwendungsmöglichkeit wäre, die Leistungsdaten Ihres Kontos über mehrere Jahre hinweg zu erfassen.
- YouTube und YouTube Analytics
- Sie können Ihre Videos, Playlists usw. sowie die Leistungsdaten Ihrer Videos abrufen und aktualisieren, um Gebotsentscheidungen zu treffen.
- Google Kalender
- Ihr Skript kann Termine für zukünftige Aufgaben erstellen (z. B. einen Leistungsbericht für Ihre Kampagnen zwei Wochen nach dem heutigen Datum erstellen) oder Aktionen basierend auf einem Eintrag ausführen, den Sie in Ihrem Kalender erstellt haben (z. B. eine Kampagne an einem bestimmten Datum aktivieren).
- Shopping Content
- Ihr Script kann die Google Content API for Shopping in Apps Script verwenden. Mit dieser API können Google Merchant Center-Nutzer ihre Produkteinträge hochladen und verwalten sowie ihre Merchant Center-Konten verwalten. In Skripts kann dies nützlich sein, um Produkteinträge zu überprüfen und bestimmte Produkte mit bestimmten Anzeigen zu verknüpfen.
- Google Tasks
- Ihr Script kann eine Erinnerungsliste für zukünftige Aufgaben erstellen (z. B. einen Leistungsbericht für Ihre Kampagnen zwei Wochen nach heute ausführen) oder Aktionen basierend auf einem Eintrag in Ihrer Erinnerungsliste ausführen (z. B. eine Kampagne an einem bestimmten Datum aktivieren).
- Google Präsentationen
- Mit Ihrem Script können Sie Kampagnendetails oder Statistiken nach Google Präsentationen exportieren, um diese Informationen in einem vorzeigbaren Format zu veröffentlichen.
Erweiterte APIs aktivieren
Wenn Sie sehen möchten, welche Google APIs als erweiterte APIs verfügbar sind, klicken Sie oben in der Editorleiste auf die Schaltfläche Erweiterte APIs.
Daraufhin wird das Dialogfeld Erweiterte APIs geöffnet. Wählen Sie die APIs aus, die Sie aktivieren möchten.
Klicken Sie als Nächstes auf den Link Google API Console, um die Seite API Console mit dem Projekt, das Ihrem Skript zugeordnet ist, in der Console aufzurufen. Falls Ihr Projekt noch nicht ausgewählt ist, wählen Sie es aus der Drop-down-Liste „Projekt“ aus. Suchen Sie nach den APIs, die Sie im Skript verwenden möchten. Geben Sie dazu den API-Namen in die Suchleiste ein.
Wählen Sie in den Suchergebnissen die API und dann auf der nächsten Seite Aktivieren aus. Wenn die Schaltfläche Deaktivieren angezeigt wird, ist die API bereits aktiviert. Wenn Sie mehrere APIs aktivieren möchten, wiederholen Sie diesen Schritt jeweils.
Wählen Sie die Seite Dashboard aus, um die Liste der für das Projekt aktivierten APIs aufzurufen. Prüfen Sie, ob alle erweiterten APIs aufgeführt sind, die Sie für das Skript verwenden möchten.
Schließen Sie nun das Dialogfeld "Erweiterte APIs", um zum Editor zurückzukehren. Die neuen APIs werden für Ihr Script aktiviert und sind in der Liste für die automatische Vervollständigung verfügbar.
Verfügbare APIs
Die folgenden APIs können verwendet werden:
| API-Name | Dokumentation |
|---|---|
| Google Analytics | https://developers.google.com/apps-script/advanced/analytics |
| Google BigQuery | https://developers.google.com/apps-script/advanced/bigquery |
| Google Kalender | https://developers.google.com/apps-script/advanced/calendar |
| Google Präsentationen | https://developers.google.com/apps-script/advanced/slides |
| Google Tasks | https://developers.google.com/apps-script/advanced/tasks |
| Shopping Content | https://developers.google.com/apps-script/advanced/shopping-content |
| YouTube | https://developers.google.com/apps-script/advanced/youtube |
| YouTube Analytics | https://developers.google.com/apps-script/advanced/youtube-analytics |
Einige Beispiele zur Verwendung dieser APIs finden Sie auf unserer Seite mit Code-Snippets.
Abschließende Hinweise
Bei der Arbeit mit erweiterten APIs sind einige Dinge zu beachten.
Projekt-ID
Jedem Google Ads-Skript ist eine Google Cloud Platform-Projekt-ID (auch Projektnummer genannt) zugeordnet. Sie finden die Projektnummer Ihres Skripts, indem Sie im Dialogfeld Erweiterte APIs die Seite der Google API Console öffnen. Diese Projekt-ID wird beim Erstellen des Skripts generiert und ist an den Nutzer gebunden, der das Google Ads-Skript erstellt hat. Wenn der Nutzer, der das Skript erstellt hat, später aus dem Konto entfernt wird, wird ein Nutzer, der auf das Skript zugreifen möchte, aufgefordert, das Skript noch einmal zu autorisieren und die Abhängigkeiten der erweiterten API noch einmal einzurichten. Außerdem wird eine neue Google Developers-Projekt-ID erstellt und Sie müssen die erweiterten APIs noch einmal einrichten, wie weiter oben in diesem Dokument erläutert.
Abhängigkeiten
Nur der Nutzer, der das Skript im Konto erstellt hat, kann die Abhängigkeiten der erweiterten APIs für dieses Skript ändern.
Berechtigungen
Beim Zugriff auf die APIs verwendet ein Skript die Berechtigungen des Nutzers, der das Skript autorisiert hat. Der Nutzer, der das Skript autorisiert hat, muss den erforderlichen Zugriff auf alle verwendeten erweiterten APIs sowie die vom Skript benötigten Daten haben. Wenn Sie die Google Analytics API verwenden, muss der Nutzer, der das Skript autorisiert hat, die erforderlichen Berechtigungen für das Analytics-Konto haben, auf das zugegriffen wird.
Nutzungsbedingungen
Für jede erweiterte API kann es eigene Nutzungsbedingungen geben, die Sie akzeptieren müssen, wenn Sie die API in der Google API Console aktivieren.
Kontingent
Zu den meisten erweiterten APIs gehört ein kostenloses Tageskontingent. Sobald das Skript dieses Kontingent überschreitet, funktioniert die API erst wieder, wenn Sie weitere Daten anfordern oder das kostenlose Kontingent aufgefüllt ist. Sie können das von Ihrem Skript verwendete Kontingent überwachen. Öffnen Sie dazu im Dialogfeld Erweiterte APIs die Google API Console für das Skript. Über die Google API Console können Sie auch zusätzliche Kontingente für die API anfordern.
Abrechnung
Bei einigen erweiterten APIs ist die Nutzung kostenpflichtig. Diese Zahlungen werden über das mit Ihrem Skript verknüpfte Google Cloud Platform-Projekt und nicht über Google Ads verwaltet. Weitere Informationen dazu, wie Sie die Abrechnung für das Google Cloud Platform-Projekt Ihres Skripts aktivieren, finden Sie in unserer Dokumentation.