Google API Console-Projekt einrichten

Sie benötigen ein Google API Console-Projekt, um OAuth 2.0-Anmeldedaten zu erstellen, einen Bildschirm für die Nutzereinwilligung zu konfigurieren und die Google Ads API für Ihre Anwendung zu aktivieren.

Die Anmeldedaten werden zur Authentifizierung und Autorisierung von Google Ads-Nutzern durch die Google-Server benötigt. Mit diesen Anmeldedaten kannst du OAuth-Tokens generieren, die in Aufrufen der API verwendet werden.

Google API Console-Projekt auswählen oder erstellen

Wenn Sie bereits ein Projekt in der Google API Console haben und es zum Erstellen von Anmeldedaten verwenden möchten, können Sie mit Client-ID und Clientschlüssel erstellen fortfahren.

Um ein Projekt zu erstellen,

  • Rufen Sie die Google API Console auf.
  • Klicken Sie auf Projekt erstellen.
  • Geben Sie einen Namen ein oder akzeptieren Sie den generierten Vorschlag
  • Verbleibende Felder bestätigen oder bearbeiten
  • Klicken Sie auf Erstellen.

Wenn Sie die Abrechnung aktiviert haben, wählen Sie ein Rechnungskonto für das neue Projekt aus. Die Nutzung der Google Ads API ist kostenlos, es gibt jedoch ein Kontingent für die Gesamtzahl der Cloud-Projekte.

Wenn Sie ein vorhandenes Google API Console-Projekt verwenden und zuvor einen OAuth-Zustimmungsbildschirm konfiguriert haben, können Sie diesen Schritt überspringen und stattdessen den Zustimmungsbildschirm ändern, indem Sie den Google Ads API-OAuth 2.0-Bereich hinzufügen.

Wenn Sie OAuth 2.0 für die Autorisierung verwenden, zeigt Google dem Nutzer einen Zustimmungsbildschirm an, der eine Zusammenfassung Ihres Projekts, dessen Richtlinien und die angeforderten Autorisierungsbereiche für den Zugriff enthält. Wenn Sie den OAuth-Zustimmungsbildschirm Ihrer Anwendung konfigurieren, wird festgelegt, was Nutzern und Prüfern angezeigt wird. Außerdem wird Ihre Anwendung registriert, damit Sie sie später veröffentlichen können.

  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.
  5. Scrollen Sie nach unten und geben Sie in das Feld unter Bereiche manuell hinzufügen Folgendes ein:

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

  6. Klicken Sie auf ZUM TABELLE HINZUFÜGEN.
  7. Fügen Sie alle weiteren Bereiche hinzu, die das Projekt möglicherweise benötigt, und klicken Sie dann auf AKTUALISIEREN.
  8. Klicken Sie auf SPEICHERN UND FORTFAHREN.
  9. 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.
  10. Rufen Sie die Übersichtsseite auf und klicken Sie auf ZURÜCK ZUM DASHBOARD.
  1. Öffnen Sie die Seite Zustimmungsbildschirm und wählen Sie im Drop-down-Menü oben auf der Seite Ihr Projekt aus.
  2. Klicken Sie auf APP BEARBEITEN.
  3. Klicken Sie im Formular OAuth-Zustimmungsbildschirm auf SPEICHERN UND FORTFAHREN.
  4. Klicken Sie auf der nächsten Seite auf BEREICHE HINZUFÜGEN ODER ENTFERNEN.
  5. Scrollen Sie nach unten und geben Sie in das Feld unter Bereiche manuell hinzufügen Folgendes ein:

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

  6. Klicken Sie auf ZUM TABELLE HINZUFÜGEN.
  7. Klicken Sie auf SPEICHERN UND FORTFAHREN.
  8. Klicken Sie im Formular Testnutzer auf SPEICHERN UND FORTFAHREN.
  9. Rufen Sie die Übersichtsseite auf und klicken Sie auf ZURÜCK ZUM DASHBOARD.

Client-ID und Clientschlüssel erstellen

Sie können diesen Schritt überspringen, wenn Sie ein vorhandenes Google API Console-Projekt verwenden, für das bereits eine Client-ID und ein Secret generiert wurden.

Nachdem Sie den Anwendungstyp ermittelt haben, folgen Sie der Anleitung unten, um die OAuth 2.0-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.

    • Wenn Sie für dieses Projekt noch keinen OAuth-Zustimmungsbildschirm konfiguriert haben, klicken Sie auf ZUSTIMMUNGSBILDSCHIRM KONFIGURIEREN.

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

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

    • 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. In diesem Leitfaden wird als Anwendungstyp Desktop-App verwendet.

  4. Geben Sie einen Namen für die App ein und klicken Sie auf Erstellen.

  5. Kopieren Sie auf der Bestätigungsseite Your Client ID (Meine Client-ID) und Your Client Secret (Clientschlüssel) in die Zwischenablage, um die Clientbibliothek später zu konfigurieren. Laden Sie außerdem die Anmeldedaten im JSON-Format in eine Datei mit dem Namen credentials.json herunter.

Google Ads API in Ihrem Projekt aktivieren

So aktivieren Sie die Google Ads API in Ihrem 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.