Die Schritte zum Erstellen und Konfigurieren eines Google API Console-Projekts hängen vom Typ des OAuth 2.0-Autorisierungsszenarios ab, das Sie in Ihrer Anwendung erstellen. Wählen Sie das Autorisierungsszenario aus, für das Sie die App entwickeln. Diese Anleitung wird dann entsprechend angepasst.
Sie benötigen ein Google API Console-Projekt, um OAuth 2.0-Anmeldedaten zu erstellen und die Google Ads API für Ihre App zu aktivieren.
Die Anmeldedaten sind für die Authentifizierung und Autorisierung von Google Ads-Nutzern durch Google-Server erforderlich. Mit diesen Anmeldedaten können Sie OAuth-Tokens generieren, die in API-Aufrufen verwendet werden.
Google API Console-Projekt auswählen oder erstellen
Folgen Sie der Anleitung, um ein Projekt zu erstellen. Die Abrechnung für Ihr Projekt aktivieren ist optional. Wenn die Abrechnung aktiviert ist, wählen Sie ein Rechnungskonto für das neue Projekt aus. Für die Verwendung der Google Ads API fallen keine Gebühren an, aber es gibt ein Kontingent für die Gesamtzahl der Cloud-Projekte.
Google Ads API in Ihrem Projekt aktivieren
So aktivieren Sie die Google Ads API in Ihrem Projekt:
Ö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.
Wenn die Google Ads API nicht in der Liste angezeigt wird, können Sie die Suchfunktion verwenden.
Wählen Sie die Google Ads API aus und klicken Sie dann auf den Button Aktivieren.
API-Zugriff beantragen
Rufen Sie als Nächstes die Übersichtsseite zur Google Ads API auf. Auf der Seite wird Ihre aktuelle API-Zugriffsebene angezeigt. Wenn Ihre aktuelle API-Zugriffsebene Testzugriff ist, maximieren Sie den Bereich Nächste Zugriffsebene beantragen. Folgen Sie der Anleitung, um die Zugriffsebene „Entdecker“ zu beantragen.
Nachdem Sie Ihren Antrag eingereicht haben, prüft Google ihn automatisch und stuft ihn in den meisten Fällen auf Explorer-Zugriff hoch.
OAuth-Zustimmungsbildschirm konfigurieren
Wenn Sie für die Autorisierung OAuth 2.0 verwenden, zeigt Google Nutzern einen Zustimmungsbildschirm an, der eine Übersicht Ihres Projekts, seiner Richtlinien und der angeforderten Autorisierungsbereiche enthält. Wenn Sie den OAuth-Zustimmungsbildschirm Ihrer App konfigurieren, legen Sie fest, was Nutzern und App-Prüfern angezeigt wird. Außerdem wird Ihre App registriert, damit Sie sie später veröffentlichen können.
Folgen Sie der Anleitung, um einen OAuth-Zustimmungsbildschirm für Ihre Anwendung zu konfigurieren und https://www.googleapis.com/auth/adwords als OAuth-Bereich hinzuzufügen.
Wichtige Hinweise zu Nutzertyp und Veröffentlichungsstatus
Achten Sie beim Konfigurieren des OAuth-Zustimmungsbildschirms auf die Einstellungen für Nutzertyp und Veröffentlichungsstatus.
- Nutzertyp:Gibt an, ob Ihre App auf Nutzer in Ihrer Organisation beschränkt ist („Intern“) oder für alle Google-Nutzer verfügbar ist („Extern“). Hinweis: „Intern“ ist nur eine Option, wenn Ihr Projekt Teil einer Google Workspace-Organisation ist.
- Veröffentlichungsstatus:Legt fest, ob sich die App im Testmodus befindet (beschränkt auf bestimmte Testnutzer, die Sie hinzufügen) oder in der Produktion ist (für die von „Nutzertyp“ definierte Zielgruppe verfügbar, möglicherweise ist eine App-Überprüfung durch Google erforderlich).
Um die besten Entscheidungen für Ihre Anwendung zu treffen, sollten Sie sich die detaillierten Erläuterungen und Auswirkungen dieser Einstellungen in der offiziellen Google Cloud-Supportdokumentation ansehen:
- Optionen für Nutzertypen für den OAuth-Zustimmungsbildschirm
- Optionen für den Veröffentlichungsstatus des OAuth-Zustimmungsbildschirms
Es ist wichtig, dass Sie sich mit diesen Einstellungen vertraut machen, damit Ihre Anwendung für die gewünschten Nutzer zugänglich ist.
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 Client-Secret generiert wurden. Erstellen Sie andernfalls eine Client-ID und einen Clientschlüssel. Folgen Sie dazu dieser Anleitung. Sie können entweder Desktop-App oder Webanwendung als Anwendungstyp auswählen. Nachdem Sie den OAuth 2.0-Client erstellt haben, laden Sie die JSON-Datei des Clients herunter. Klicken Sie dazu zuerst auf das Symbol OAuth-Client herunterladen und dann auf dem folgenden Bildschirm auf die Schaltfläche JSON HERUNTERLADEN.