Google API Console-Projekt für die Google Ads API konfigurieren

Für den Zugriff auf die OAuth2-Server von Google sind Anmeldedaten für die Authentifizierung und Autorisierung von Google Ads-Nutzern erforderlich. Mit diesen Anmeldedaten wird Ihre App für Google identifiziert und Sie können OAuth-Tokens für die Verwaltung von Google Ads-Nutzern generieren. Der Zugriff auf Google OAuth2-Anmeldedaten wird über die Google API Console verwaltet.

Video mit Best Practices für Cloud-Projekte ansehen

Google OAuth-Bestätigung

Alle Google Cloud-Apps, mit denen Anmeldedaten für den Google Ads API-Bereich abgerufen werden, müssen einer Google OAuth-Bestätigung unterzogen werden, um einen nicht bestätigten Bildschirm der Benutzeroberfläche für ihre Nutzer zu vermeiden. Eine Anwendung ist in diesem Kontext in Google Cloud als eindeutige OAuth 2.0-Client-ID definiert.

Diese Bestätigung ist unabhängig und zusätzlich zu allen Prüfungen, die im Rahmen des Genehmigungsverfahrens für Entwickler-Tokens durchgeführt werden. Sie ist erforderlich, da der Google Ads API-Bereich ein sensibler Bereich ist.

Die Google-Bestätigung ist kostenlos und dauert in der Regel drei bis fünf Werktage. Diese Richtlinie gilt für alle Apps.

Wir empfehlen, für alle Apps so bald wie möglich den Google OAuth-Bestätigungsprozess zu durchlaufen, um Unterbrechungen 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.

Für die Nutzung der Google Ads API fallen keine Kosten an. Es gibt jedoch ein Kontingent für die Gesamtzahl der Cloud-Projekte. Alternativ können Sie sich für ein neues Google-Konto registrieren, das ein kostenloses Projektkontingent umfasst.

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 Sie ein neues. In der API-Bibliothek sind alle verfügbaren APIs nach Produktfamilie und Beliebtheit gruppiert.

2. Verwenden Sie die Suchfunktion, um die Google Ads API zu finden, wenn diese nicht in der Liste angezeigt wird.

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

Nutzertyp und Veröffentlichungsstatus auswählen

Nachdem Sie die API aktiviert haben, müssen Sie den Nutzertyp und den Veröffentlichungsstatus für Ihr Projekt 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 ab dem Zeitpunkt der Einwilligung ab.
Äußeres Display	Testen	Für alle Projekte verfügbar. Beschränkt auf bis zu 100 Testnutzer, die im OAuth-Zustimmungsbildschirm aufgeführt sind. Testnutzer können alle Nutzer mit einem Google-Konto sein. Autorisierungen laufen sieben Tage ab dem Zeitpunkt der Einwilligung ab.
Intern	In Produktion	Nur für Projekte verfügbar, die mit einer Google Cloud-Organisation verknüpft sind. Ermöglicht die Autorisierung aller Nutzer in der Google Cloud-Organisation, die mit dem Projekt verknüpft ist.
Äußeres Display	In Produktion	Für alle Projekte verfügbar. Ermöglicht die Autorisierung aller Nutzer mit einem Google-Konto.

Wenn die Google-OAuth-Überprüfung nicht abgeschlossen wird, hat dies unabhängig vom Nutzertyp oder Veröffentlichungsstatus des Projekts folgende Auswirkungen:

• Während des Autorisierungsprozesses wird Nutzern ein nicht bestätigter UI-Bildschirm angezeigt.

• Sie können maximal 100 Nutzer autorisieren.

OAuth-Zustimmungsbildschirm konfigurieren

1. Öffnen Sie die Seite mit dem Zustimmungsbildschirm und wählen Sie oben auf der Seite im Drop-down-Menü 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 bei Bedarf später bearbeiten. Klicken Sie abschließend auf SPEICHERN UND FORTFAHREN.

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

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

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

   • Klicken Sie auf ZUR TABELLE HINZUFÜGEN.

   • Fügen Sie alle anderen Bereiche hinzu, die Ihr Projekt anfordern wird, 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. Lesen Sie die Zusammenfassung und klicken Sie auf ZU DASHBOARD.

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

App-Typ auswählen

Es gibt zwei App-Typ-Optionen für die Google Ads API: Computer oder Web. In der folgenden Tabelle sehen Sie, 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 einzelnen Verwaltungskonto der obersten Ebene. Sie sind ein neuer Nutzer oder möchten schnell mit der einfachsten Einrichtung beginnen. Ihre App authentifiziert nur Google-Nutzer von einem Computer aus.
Web-App	Sie möchten sich als Nutzer authentifizieren, der Ihrer App die Berechtigung erteilt, auf seine Google Ads-Kontodaten zuzugreifen. Sie möchten einfach mehrere Anmeldedaten für die Autorisierung generieren, um beispielsweise Konten von Drittanbietern zu verwalten. Ihre App erfordert Callback-URLs. Callback-URLs werden im Ablauf der Desktop-App nicht unterstützt.

Wichtiger Hinweis: Sie können weiterhin den Ablauf für Desktopanwendungen auswählen, auch wenn Sie eine Anwendung für die Ausführung auf einem Server entwickeln. Der Unterschied besteht darin, ob die OAuth-Autorisierung lokal oder remote abgeschlossen ist. Für einen Desktop-Vorgang ist eine Autorisierung auf dem lokalen Computer erforderlich, während der Web-Flow die Autorisierung auf dem Autorisierungsserver von Google zulässt.

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

Client-ID und Clientschlüssel erstellen

Nachdem Sie den Anwendungstyp bestimmt 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 zuvor 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 bisher noch keinen OAuth-Zustimmungsbildschirm für dieses Projekt 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 bei Bedarf später bearbeiten. Klicken Sie abschließend auf Speichern.

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

3. Wählen Sie als Anwendungstyp entweder Desktop-App oder Webanwendung 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.

   Verwenden Sie http://127.0.0.1 für lokale Tests, die mit der Standardkonfiguration in unseren Beispielen für Clientbibliotheken kompatibel sind.

   Hinweis: Sie können Ihrem 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 Desktop-App-Clients verwenden Sie weiterhin eine Loopback-IP-Weiterleitung, aber der URI ist in der Cloud Console nicht explizit konfiguriert.

6. Kopieren Sie auf der Bestätigungsseite Your Client ID und Your Client Secret in die Zwischenablage. Sie benötigen sie später beim Konfigurieren der Clientbibliothek. Sie können auch später zur Seite „Anmeldedaten“ zurückkehren, um diese Details abzurufen.