Google API-Konsolenprojekt für die Google Ads API konfigurieren

Anmeldedaten für den Zugriff auf die OAuth2-Server von Google sind erforderlich, um Google Ads-Nutzer zu authentifizieren und zu autorisieren. Diese Anmeldedaten identifizieren Ihre Anwendung bei Google, sodass Sie OAuth-Tokens für die Verwaltung von Google Ads-Nutzern generieren können. Der Zugriff auf Google OAuth2-Anmeldedaten wird über die Google API Console verwaltet.

Video mit Best Practices für Cloud-Projekte

Google OAuth-Überprüfung

Jede Google Cloud-Anwendung, die zum Abrufen von Anmeldedaten für den Google Ads API-Bereich verwendet wird, muss einer Google-OAuth-Überprüfung unterzogen werden, damit Nutzer keine nicht überprüften UI-Bildschirme sehen. Eine Anwendung ist in diesem Kontext als eindeutige OAuth 2.0-Client-ID in Google Cloud definiert.

Die Überprüfung ist unabhängig und zusätzlich zu allen Prüfungen erforderlich, die im Rahmen des Freigabeprozesses für Entwicklertokens durchgeführt werden. Sie ist erforderlich, da der Bereich der Google Ads API ein sensibler Bereich ist.

Für die Überprüfung durch Google fallen keine Kosten an. Sie erfolgt in der Regel innerhalb von 3 bis 5 Arbeitstagen. Diese Richtlinie gilt für alle Apps.

Wir empfehlen, für alle Anwendungen so schnell wie möglich den Google OAuth-Verifizierungsprozess zu durchlaufen, um Unterbrechungen des Betriebs zu vermeiden.

Projekt erstellen

Gehen Sie zur Google API Console. Klicken Sie auf Projekt erstellen, geben Sie einen Namen ein und klicken Sie auf Erstellen.

Wichtiger Hinweis: Wenn Sie die Abrechnung aktiviert haben, z. B. für Google Cloud, müssen Sie ein Rechnungskonto für das neue Projekt auswählen.

Die Nutzung der Google Ads API ist kostenlos, es gibt jedoch ein Kontingent für die Gesamtzahl der Cloud-Projekte. Alternativ können Sie sich für ein neues Google-Konto mit einem kostenlosen Projektkontingent registrieren.

Google Ads API in Ihrem Projekt aktivieren

So aktivieren Sie die Google Ads API für Ihr Projekt:

1. Öffnen Sie die API-Bibliothek in der Google API Console. Wenn Sie dazu aufgefordert werden, wählen Sie Ihr Projekt aus oder erstellen ein neues. In der API-Bibliothek finden Sie alle verfügbaren APIs, gruppiert nach Produktfamilie und Beliebtheit.

2. Wenn die Google Ads API nicht in der Liste aufgeführt ist, können Sie sie über die Suche finden.

3. Wählen Sie die Google Ads API aus und klicken Sie auf die Schaltfläche Aktivieren.

Nutzertyp und Veröffentlichungsstatus auswählen

Nach dem Aktivieren der API müssen Sie den Nutzertyp und den Veröffentlichungsstatus Ihres Projekts angeben. In der folgenden Tabelle sind einige wichtige Attribute und Einschränkungen der einzelnen Kombinationen dieser Einstellungen aufgeführt. Weitere Informationen finden Sie in der Dokumentation zur Google Cloud Platform.

Nutzertyp	Veröffentlichungsstatus	Beschränkungen
Intern	Testen	Nur für Projekte verfügbar, die mit einer Google Cloud-Organisation verknüpft sind. Beschränkt auf bis zu 100 Testnutzer, die im OAuth-Zustimmungsbildschirm aufgeführt sind. Testnutzer müssen interne Nutzer in der Google Cloud-Organisation sein, die mit dem Projekt verknüpft ist. Autorisierungen laufen sieben Tage nach der Einwilligung ab.
Extern	Testen	Verfügbar für alle Projekte. Beschränkt auf bis zu 100 Testnutzer, die im OAuth-Zustimmungsbildschirm aufgeführt sind. Testnutzer können beliebige Nutzer mit einem Google-Konto sein. Autorisierungen laufen sieben Tage nach der Einwilligung ab.
Intern	In Produktion	Nur für Projekte verfügbar, die mit einer Google Cloud-Organisation verknüpft sind. Ermöglicht das Autorisieren jedes Nutzers innerhalb der Google Cloud-Organisation, die dem Projekt zugeordnet ist.
Extern	In Produktion	Verfügbar für alle Projekte. Ermöglicht die Autorisierung jedes Nutzers mit einem Google-Konto.

Wenn Sie die Google OAuth-Überprüfung nicht durchlaufen, ergibt sich unabhängig vom Nutzertyp oder Veröffentlichungsstatus des Projekts Folgendes:

• Während des Autorisierungsvorgangs wird Nutzern ein nicht überprüfter UI-Bildschirm angezeigt.

• Sie können maximal 100 Nutzer autorisieren.

OAuth-Zustimmungsbildschirm konfigurieren

1. Öffnen Sie die Seite Zustimmungsbildschirm und wählen Sie im Drop-down-Menü oben auf der Seite Ihr Projekt aus.

2. Wählen Sie den Nutzertyp aus und klicken Sie auf ERSTELLEN.

3. Füllen Sie das Formular für den Zustimmungsbildschirm aus. Sie können dies später bei Bedarf ändern. Klicke abschließend auf SPEICHERN UND FORTFAHREN.

4. Klicken Sie auf der nächsten Seite auf BEREICHE HINZUFÜGEN ODER ENTFERNEN.

   • Scrollen Sie nach unten und geben Sie in das Feld unter Bereiche manuell hinzufügen Folgendes ein:

     https://www.googleapis.com/auth/adwords
     

   • Klicken Sie auf ZUM TABELLE HINZUFÜGEN.

   • Fügen Sie alle weiteren Bereiche hinzu, die vom Projekt angefordert werden, und klicken Sie dann auf AKTUALISIEREN.

   • Klicken Sie auf SPEICHERN UND FORTFAHREN.

5. Wenn Sie Ihr Projekt nicht sofort veröffentlichen möchten, fügen Sie die E-Mail-Adressen aller Nutzerkonten hinzu, die Sie zum Testen verwenden möchten, und klicken Sie dann auf SPEICHERN UND FORTFAHREN.

6. Rufen Sie die Übersichtsseite auf und klicken Sie auf ZURÜCK ZUM DASHBOARD.

Nachdem Sie Ihre Anwendung und den Autorisierungsprozess getestet haben, können Sie zum Dashboard zurückkehren und auf VERÖFFENTLICHEN APP klicken, um den Veröffentlichungsstatus von Test in In Produktion zu ändern.

App-Typ auswählen

Bei der Google Ads API gibt es zwei Optionen für App-Typen: Computer oder Web. Anhand der folgenden Tabelle können Sie ermitteln, welcher Typ für die Anwendung, die Sie erstellen möchten, am besten geeignet ist:

Diesen Anwendungstyp auswählen	Wenn…
Desktop-App	Sie verwalten alle Ihre Google Ads-Konten mit einem einzigen Verwaltungskonto der obersten Ebene. Sie sind ein neuer Nutzer oder möchten mit der einfachsten Einrichtung schnell beginnen. Ihre Anwendung authentifiziert Google-Nutzer nur auf einem Computer.
Web-App	Sie möchten sich als Nutzer authentifizieren, der Ihrer App die Berechtigung erteilen kann, auf seine Google Ads-Kontodaten zuzugreifen. Sie möchten auf einfache Weise mehrere Anmeldedaten für die Autorisierung generieren, um beispielsweise Drittanbieterkonten zu verwalten. Ihre Anwendung erfordert Callback-URLs. Callback-URLs werden im Ablauf von Desktop-Anwendungen nicht unterstützt.

Wichtiger Hinweis: Sie können den Ablauf für Desktop-Apps auch dann auswählen, wenn Sie eine Anwendung für die Ausführung auf einem Server entwickeln. Der Unterschied besteht darin, ob die OAuth-Autorisierung lokal oder per Fernzugriff erfolgt. Bei einem Desktopfluss muss die Autorisierung auf dem lokalen Computer abgeschlossen werden. Beim Webvorgang kann die Autorisierung hingegen auf dem Autorisierungsserver von Google durchgeführt werden.

Weitere Informationen finden Sie in der Google Identity Platform-OAuth-Dokumentation für Desktopanwendungen oder Webanwendungen.

Client-ID und Clientschlüssel erstellen

Nachdem Sie den Anwendungstyp ermittelt haben, folgen Sie der Anleitung unten, um die OAuth2-Client-ID und den Clientschlüssel zu generieren:

1. Öffnen Sie die Seite Anmeldedaten. Wählen Sie ein bereits erstelltes Projekt aus oder erstellen Sie ein neues.

2. Klicken Sie auf dem Bildschirm „Anmeldedaten“ auf ANMELDEDATEN ERSTELLEN und wählen Sie dann OAuth-Client-ID aus.

   1. Wenn Sie für dieses Projekt noch keinen OAuth-Zustimmungsbildschirm konfiguriert haben, werden Sie jetzt dazu aufgefordert. Klicken Sie auf ZUSTIMMUNGSBILDSCHIRM KONFIGURIEREN.

      1. Wählen Sie den Nutzertyp aus und klicken Sie auf ERSTELLEN.

      2. Füllen Sie das ursprüngliche Formular aus. Sie können dies später bei Bedarf ändern. Klicken Sie abschließend auf Speichern.

   2. Gehen Sie zurück zu Anmeldedaten > ANMELDEDATEN ERSTELLEN > OAuth-Client-ID, um fortzufahren.

3. Wählen Sie je nach Anwendungsfall Desktop-App oder Webanwendung als Anwendungstyp aus.

4. Geben Sie einen Namen ein und klicken Sie auf Erstellen.

5. Wenn Ihr Clienttyp Webanwendung ist, fügen Sie mindestens einen autorisierten Weiterleitungs-URI hinzu.

   Für lokale Tests, die mit der Standardkonfiguration in unseren Clientbibliotheksbeispielen kompatibel sind, verwenden Sie http://127.0.0.1.

   Hinweis: Sie können dem Weiterleitungs-URI eine Portnummer hinzufügen, um die Nutzung auf einen bestimmten Port zu beschränken. Wenn der Port nicht festgelegt ist, kann ein OAuth-Client zu einem beliebigen Port weiterleiten.

   Für Clients für Desktop-Apps verwenden Sie weiterhin eine Loopback-IP-Weiterleitung, der URI ist jedoch nicht explizit in der Cloud Console konfiguriert.

6. Kopieren Sie auf der Bestätigungsseite Your Client ID (Meine Client-ID) und Your Client Secret (Clientschlüssel) in die Zwischenablage, da Sie sie beim Konfigurieren der Clientbibliothek benötigen. Sie können diese Details auch später auf der Seite „Anmeldedaten“ abrufen.