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

In diesem Video finden Sie einige Best Practices für Cloud-Projekte.

Google OAuth-Überprüfung

Für jede Google Cloud-App, die zum Abrufen von Anmeldedaten für den Google Ads API-Bereich verwendet wird, ist eine Google OAuth-Überprüfung erforderlich, um zu vermeiden, dass Nutzer einen nicht bestätigten UI-Bildschirm sehen. Eine App wird in diesem Kontext als eindeutige OAuth 2.0-Client-ID in Google Cloud definiert.

Diese Überprüfung erfolgt unabhängig von und zusätzlich zu allen Überprüfungen, die im Rahmen des Genehmigungsverfahrens für Entwicklertokens 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 Arbeitstage. Diese Richtlinie gilt für alle Apps.

Wir empfehlen, dass alle Apps so schnell wie möglich das Google OAuth-Bestätigungsverfahren 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 die Abrechnung aktiviert ist, 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 Gebühren 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. Wählen Sie Ihr 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.

Benutzertyp 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 Platform-Dokumentation.

Nutzertyp	Veröffentlichungsstatus	Beschränkungen
Intern	Test	Nur für Projekte verfügbar, die mit einer Google Cloud-Organisation verknüpft sind. Beschränkt auf bis zu 100 Testnutzer, die auf dem OAuth-Zustimmungsbildschirm aufgeführt sind. Testnutzer müssen interne Nutzer in der Google Cloud-Organisation sein, die dem Projekt zugeordnet ist. Autorisierungen laufen sieben Tage nach der Einwilligung ab.
Extern	Test	Für alle Projekte verfügbar. Beschränkt auf bis zu 100 Testnutzer, die auf dem 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 die Autorisierung aller Nutzer in der mit dem Projekt verknüpften Google Cloud-Organisation.
Extern	In Produktion	Für alle Projekte verfügbar. Ermöglicht die Autorisierung jedes Nutzers mit einem Google-Konto.

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 für nicht überprüfte Anwendungen angezeigt.

• Sie können maximal 100 Nutzer autorisieren.

OAuth-Zustimmungsbildschirm konfigurieren

1. Öffnen Sie die Seite „Zustimmungsbildschirm“ und wählen Sie Ihr Projekt im Drop-down-Menü oben auf der Seite 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 diese Angabe später bei Bedarf bearbeiten. Klicken Sie anschließ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 Folgendes in das Feld unter Bereiche manuell hinzufügen ein:

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

   • Klicken Sie auf DER TABELLE HINZUFÜGEN.

   • Fügen Sie alle anderen Bereiche hinzu, die für Ihr Projekt erforderlich sind, 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 zum Testen verwenden, und klicken Sie dann auf SPEICHERN UND FORTFAHREN.

6. Sehen Sie sich die Zusammenfassungsseite an 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-Typen: „Desktop“ und „Web“. Anhand der folgenden Tabelle können Sie entscheiden, 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 einzelnes Verwaltungskonto der obersten Ebene. Sie sind ein neuer Nutzer oder möchten schnell mit der einfachsten Einrichtung beginnen. Ihre App authentifiziert Google-Nutzer nur auf einem Gerät.
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 Autorisierungsanmeldedaten generieren, um beispielsweise Drittanbieterkonten zu verwalten. Ihre App erfordert Callback-URLs. Callback-URLs werden im Desktop-App-Ablauf nicht unterstützt.

Wichtiger Hinweis :Sie können den Desktop-App-Ablauf 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 erfolgt. Für einen Desktop-Ablauf muss die Autorisierung auf dem lokalen Computer abgeschlossen werden, während der Web-Ablauf die Autorisierung auf dem Autorisierungsserver von Google ermöglicht.

Weitere Informationen finden Sie in der Google Identity Platform-OAuth-Dokumentation 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 bearbeiten. Klicken Sie zum Schluss auf Speichern.

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

3. Wählen Sie je nach Anwendungsfall entweder 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 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 Ihrer Weiterleitungs-URI eine Portnummer hinzufügen, um die Verwendung auf einen bestimmten Port zu beschränken. Wenn der Port nicht festgelegt ist, kann ein OAuth-Client zu einem beliebigen Port weiterleiten.

   Bei Desktop-App-Clients verwenden Sie weiterhin eine Loopback-IP-Weiterleitung, der URI wird jedoch nicht explizit in der Cloud Console konfiguriert.

6. Kopieren Sie auf der Bestätigungsseite Ihre Client-ID und Ihr Client-Secret in die Zwischenablage, da Sie sie beim Konfigurieren Ihrer Clientbibliothek benötigen. Sie können auch später zur Seite mit den Anmeldedaten zurückkehren, um diese Details abzurufen.