Mit den erweiterten APIs in Google Ads-Scripts können erfahrene Entwickler eine Verbindung zu bestimmten öffentlichen Google APIs herstellen, die mit ihren HTTP-Schnittstellen mehr Einrichtungsaufwand erfordern. Sie verwenden diese APIs ähnlich wie die integrierten Dienste von Scripts und sie bieten dieselben Vorteile wie die automatische Vervollständigung und die automatische Autorisierung.
Mögliche Anwendungen für 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 finden Sie in der Google Analytics-Hilfe.
- Google BigQuery
- Sie können große Datenmengen in Google Cloud Storage laden und diese dann mit Google BigQuery abfragen. Sie können beispielsweise öffentliche Wetterdaten der letzten zehn Jahre laden und dann in einem Script nach der Durchschnittstemperatur einer Region fragen, um Gebote entsprechend anzupassen. Eine weitere Möglichkeit ist die Auswertung der Leistungsdaten Ihres Kontos über mehrere Jahre hinweg.
- YouTube und YouTube Analytics
- Du kannst deine Videos, Playlists usw. sowie die Leistungsdaten deiner Videos abrufen und aktualisieren, um Gebotsentscheidungen zu treffen.
- Google Kalender
- Ihr Script kann Ereignisse für zukünftige Aufgaben erstellen (z. B. einen Leistungsbericht für Ihre Kampagnen in zwei Wochen ausführen) oder Aktionen basierend auf einem Eintrag in Ihrem Kalender ausführen (z. B. eine Kampagne an einem bestimmten Datum aktivieren).
- Shopping Content
- In Ihrem Script kann die Google Content API for Shopping in Apps Script verwendet werden. Mit dieser API können Google Merchant Center-Nutzer ihre Produkteinträge hochladen und verwalten sowie ihre Merchant Center-Konten verwalten. In Scripts kann dies nützlich sein, um Produkteinträge zu prü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 in zwei Wochen ausführen) oder Aktionen basierend auf einem Eintrag ausführen, den Sie in Ihrer Erinnerungsliste erstellt haben (z. B. eine Kampagne an einem bestimmten Datum aktivieren).
- Google Präsentationen
- Ihr Script kann Kampagnendetails oder -statistiken in Google Präsentationen exportieren, um diese Informationen in einem ansprechenden 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. Setzen Sie ein Häkchen bei den APIs, die Sie aktivieren möchten.
Klicken Sie als Nächstes auf den Link Google API Console, um die Seite API Console in der Console mit dem Projekt aufzurufen, das mit Ihrem Script verknüpft ist. Wenn Ihr Projekt noch nicht ausgewählt ist, wählen Sie es im Drop-down-Menü „Projekt“ aus. Geben Sie in der Suchleiste den Namen der API ein, die Sie in Ihrem Script verwenden möchten.
Wählen Sie in den Suchergebnissen die API aus und dann auf der nächsten Seite Aktivieren. Wenn die Schaltfläche Deaktivieren angezeigt wird, ist die API bereits aktiviert. Wenn Sie mehrere APIs aktivieren möchten, wiederholen Sie diesen Schritt jeweils.
Wenn Sie die Liste der für das Projekt aktivierten APIs aufrufen möchten, wählen Sie die Seite Dashboard aus. Prüfen Sie, ob alle erweiterten APIs, die Sie für das Script verwenden möchten, aufgeführt sind.
Schließen Sie nun das Dialogfeld "Erweiterte APIs", um zum Editor zurückzukehren. Die neuen APIs werden für Ihr Script aktiviert und in der Liste für die automatische Vervollständigung angezeigt.
Verfügbare APIs
Folgende APIs sind verfügbar:
| 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 |
Auf unserer Seite mit Code-Snippets finden Sie einige Beispiele für die Verwendung dieser APIs.
Abschließende Hinweise
Bei der Arbeit mit den erweiterten APIs sind einige Dinge zu beachten.
Projekt-ID
Jedem Google Ads-Script ist eine Google Cloud-Projekt-ID (auch als Projektnummer bezeichnet) zugewiesen. Die Projektnummer Ihres Scripts finden Sie, wenn Sie im Dialogfeld Erweiterte APIs die Seite der Google API Console öffnen. Diese Projekt-ID wird beim Erstellen des Scripts erstellt und ist mit dem Nutzer verknüpft, der das Google Ads-Script erstellt hat. Wenn der Nutzer, der das Script erstellt hat, später aus dem Konto entfernt wird, wird ein Nutzer, der versucht, auf das Script zuzugreifen, aufgefordert, das Script noch einmal zu autorisieren und die Abhängigkeiten der erweiterten API noch einmal einzurichten. Außerdem wird eine neue Google-Entwicklerprojekt-ID erstellt und Sie müssen die erweiterten APIs wie oben in diesem Dokument beschrieben neu einrichten.
Abhängigkeiten
Nur der Nutzer, der das Script im Konto erstellt hat, kann die Abhängigkeiten von erweiterten APIs für dieses Script ändern.
Berechtigungen
Beim Zugriff auf die APIs verwendet ein Script die Berechtigungen des Nutzers, der das Script autorisiert hat. Der Nutzer, der das Script autorisiert hat, muss den erforderlichen Zugriff auf alle verwendeten erweiterten APIs sowie auf die Daten haben, die für das Script erforderlich sind. Wenn Sie die Google Analytics API verwenden, muss der Nutzer, der das Script autorisiert hat, die erforderlichen Berechtigungen für das Analytics-Konto haben, auf das zugegriffen wird.
Nutzungsbedingungen
Für jede der erweiterten APIs gelten möglicherweise eigene Nutzungsbedingungen, 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 Ihr Script dieses Kontingent überschreitet, funktioniert die API nicht mehr, bis Sie zusätzliche Daten anfordern oder das Kontingent wieder aufgefüllt wurde. Sie können das vom Script genutzte Kontingent überwachen, indem Sie im Dialogfeld Erweiterte APIs die Google API Console für das Script öffnen. In der Google API Console können Sie auch ein zusätzliches Kontingent für die API anfordern.
Abrechnung
Für einige erweiterte APIs müssen Sie die Nutzung bezahlen. Diese Zahlungen werden über das Google Cloud Platform-Projekt verwaltet, das mit Ihrem Script verknüpft ist, und nicht über Google Ads. Weitere Informationen zum Aktivieren der Abrechnung für das Google Cloud Platform-Projekt Ihres Scripts finden Sie in unserer Dokumentation.