Google API Console-Projekt einrichten

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

Die Anmeldedaten werden für die Authentifizierung und Autorisierung von Google Ads-Nutzern durch Google-Server benötigt. Mit diesen Anmeldedaten können Sie OAuth-Tokens generieren, die in Aufrufen an die API verwendet werden.

Google API Console-Projekt auswählen oder erstellen

Wenn Sie bereits ein Google API Console-Projekt haben und damit Anmeldedaten erstellen möchten, können Sie mit Client-ID und Clientschlüssel erstellen fortfahren.

So erstellen Sie ein Projekt:

  • 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. Für die Nutzung der Google Ads API fallen keine Kosten an, 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 OAuth 2.0-Bereich der Google Ads API hinzufügen.

Wenn Sie OAuth 2.0 zur Autorisierung verwenden, zeigt Google dem Nutzer einen Zustimmungsbildschirm an, der eine Zusammenfassung Ihres Projekts, seiner Richtlinien und der angeforderten Autorisierungsbereiche enthält. Durch die Konfiguration des OAuth-Zustimmungsbildschirms wird festgelegt, was Nutzern und App-Prüfern angezeigt wird. Außerdem wird deine App registriert, damit du sie später veröffentlichen kannst.

  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 bearbeiten. Klicken Sie 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 Folgendes in das Feld unter Bereiche manuell hinzufügen ein:

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

  6. Klicken Sie auf ZU TABELLE HINZUFÜGEN.
  7. Fügen Sie alle anderen Bereiche hinzu, die Ihr Projekt möglicherweise benötigt, und klicken Sie dann auf AKTUALISIEREN.
  8. Klicken Sie auf SPEICHERN UND FORTFAHREN.
  9. Wenn Sie nicht vorhaben, das Projekt sofort zu veröffentlichen, 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. Überprüfen Sie die Übersichtsseite 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 Folgendes in das Feld unter Bereiche manuell hinzufügen ein:

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

  6. Klicken Sie auf ZU TABELLE HINZUFÜGEN.
  7. Klicken Sie auf SPEICHERN UND FORTFAHREN.
  8. Klicken Sie im Formular Testnutzer auf SPEICHERN UND FORTFAHREN.
  9. Überprüfen Sie die Übersichtsseite 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, das bereits eine generierte Client-ID und ein generiertes Secret hat.

Nachdem du deinen Anwendungstyp bestimmt hast, folge 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 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.

    • Wenn Sie für dieses Projekt bisher 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 erste Formular aus. Sie können dies später bei Bedarf bearbeiten. Klicken Sie abschließend auf Speichern.

    • Gehe zurück zu Anmeldedaten > ANMELDEDATEN ERSTELLEN > OAuth-Client-ID, um fortzufahren.

  3. Wählen Sie je nach Anwendungsfall entweder Desktop-App oder Webanwendung als App-Typ aus. In dieser Anleitung 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 Ihre Client-ID und Ihr Clientschlüssel in die Zwischenablage, um Ihre Clientbibliothek später zu konfigurieren. Laden Sie die Anmeldedaten im JSON-Format in eine Datei mit dem Namen credentials.json herunter.

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

  2. Falls die Google Ads API nicht in der Liste aufgeführt ist, verwenden Sie die Suche.

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