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. Anhand dieser Anmeldedaten wird Ihre App bei Google identifiziert, sodass Sie OAuth-Tokens zum Verwalten von Google Ads-Nutzern generieren können. Der Zugriff auf Google OAuth2-Anmeldedaten wird über die Google API Console verwaltet.

Best Practices für Cloud-Projekte

Google OAuth-Überprüfung

Alle Google Cloud-Apps, mit denen Anmeldedaten für den Google Ads API-Bereich abgerufen werden, müssen über Google OAuth überprüft werden, damit Nutzer nicht auf einen nicht bestätigten UI-Bildschirm geleitet werden. Eine App wird in diesem Zusammenhang als eindeutige OAuth 2.0-Client-ID in Google Cloud definiert.

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

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

Wir empfehlen, alle Apps so schnell wie möglich durch den Google OAuth-Bestätigungsprozess zu führen, um Unterbrechungen des Geschäftsbetriebs 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.

Wichtig :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 registrieren, das ein kostenloses Projektkontingent enthält.

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. Wählen Sie ein Projekt aus oder erstellen Sie ein neues, wenn Sie dazu aufgefordert werden. In der API-Bibliothek finden Sie alle verfügbaren APIs nach Produktfamilie und Beliebtheit gruppiert.

2. Wenn die Google Ads API nicht in der Liste angezeigt wird, können Sie die Suchfunktion verwenden.

3. Wählen Sie die Google Ads API aus und klicken Sie dann 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 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 Google Cloud-Dokumentation.

Nutzertyp	Veröffentlichungsstatus	Beschränkungen
Intern	Test	Nur für Projekte verfügbar, die mit einer Google Cloud-Organisation verknüpft sind. Begrenzt auf bis zu 100 Testnutzer, die auf dem OAuth-Zustimmungsbildschirm aufgeführt sind. Testnutzer müssen interne Nutzer in der mit dem Projekt verknüpften Google Cloud-Organisation sein. Autorisierungen laufen sieben Tage nach der Einwilligung ab.
Extern	Test	Verfügbar für alle Projekte. Begrenzt auf bis zu 100 Testnutzer, die auf dem OAuth-Zustimmungsbildschirm aufgeführt sind. Testnutzer können alle 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. Hiermit können Sie jedem Nutzer in der mit dem Projekt verknüpften Google Cloud-Organisation eine Berechtigung erteilen.
Extern	In Produktion	Verfügbar für alle Projekte. Hiermit können alle Nutzer mit einem Google-Konto autorisiert werden.

Wenn Sie die Google OAuth-Bestätigung nicht abschließen, hat das unabhängig vom Nutzertyp oder Veröffentlichungsstatus Ihres Projekts folgende Auswirkungen:

• Während des Autorisierungsprozesses wird Nutzern ein Bildschirm mit nicht überprüfter Benutzeroberfläche angezeigt.

• Sie können maximal 100 Nutzer autorisieren.

OAuth-Zustimmungsbildschirm konfigurieren

1. Öffnen Sie die Seite 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 Einwilligungsbildschirm aus. Sie können diese Angabe später bei Bedarf ändern. Klicken Sie abschließend auf SPEICHERN UND WEITER.

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

   • Scrollen Sie nach unten und geben Sie Folgendes in das Feld unter Umfange 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 für Ihr 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-Adresse jedes Nutzerkontos hinzu, das Sie für Tests verwenden möchten, und klicken Sie dann auf SPEICHERN UND WEITER.

6. Prüfen Sie die Zusammenfassungsseite 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 APP VERÖFFENTLICHEN klicken, um den Veröffentlichungsstatus von Wird getestet in In Produktion zu ändern.

App-Typ auswählen

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

Diesen Anwendungstyp auswählen	Wenn…
Desktop-App	Sie verwalten alle Ihre Google Ads-Konten über ein einziges Verwaltungskonto auf oberster Ebene. Sie sind ein neuer Nutzer oder möchten schnell mit der einfachsten Einrichtung beginnen. Ihre App authentifiziert Google-Nutzer nur von einem Computer aus.
Web-App	Sie möchten sich als Nutzer authentifizieren, der Ihrer App die Berechtigung zum Zugriff auf seine Google Ads-Kontodaten erteilen kann. Sie möchten ganz einfach mehrere Autorisierungs-Anmeldedaten generieren, um beispielsweise Drittanbieterkonten zu verwalten. Für Ihre App sind Callback-URLs erforderlich. Callback-URLs werden im Ablauf für Desktop-Apps nicht unterstützt.

Wichtiger Hinweis :Sie können den Ablauf für Desktop-Apps auch dann auswählen, wenn Sie eine App entwickeln, die auf einem Server ausgeführt werden soll. Der Unterschied besteht darin, ob die OAuth-Autorisierung lokal oder remote durchgeführt wird. Bei einem Desktop-Ablauf muss die Autorisierung auf dem lokalen Computer erfolgen, während sie beim Web-Ablauf auf dem Autorisierungsserver von Google erfolgen kann.

Weitere Informationen finden Sie in der OAuth-Dokumentation der Google Identity Platform für Desktop-Apps oder Web-Apps.

Client-ID und Clientschlüssel erstellen

Nachdem Sie den App-Typ ermittelt haben, folgen Sie der Anleitung unten, um die OAuth2-Client-ID und das Client-Secret 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 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 erste Formular aus. Sie können diese Angabe später bei Bedarf ändern. Klicken Sie abschließend auf Speichern.

   2. Kehren Sie zu ANMELDEDATEN > ANMELDEDATEN ERSTEMMEN > OAuth-Client-ID zurück, um fortzufahren.

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

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

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

   Verwenden Sie für lokale Tests, die mit der Standardkonfiguration in unseren Beispielen für Clientbibliotheken kompatibel sind, 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 an jeden Port weiterleiten.

   Für Desktop-App-Clients wird weiterhin eine Loopback-IP-Weiterleitung verwendet, der URI wird jedoch nicht explizit in der Cloud Console konfiguriert.

6. Kopieren Sie auf der Bestätigungsseite die Client-ID und das Client-Secret in die Zwischenablage. Sie benötigen sie, wenn Sie die Clientbibliothek konfigurieren. Sie können diese Details auch später auf der Seite mit den Anmeldedaten abrufen.