Die Schritte zum Erstellen und Konfigurieren eines Google API Console-Projekts hängen von der Art des OAuth 2.0-Autorisierungsszenarios ab, das Sie in Ihrer Anwendung erstellen. Wählen Sie das Autorisierungsszenario aus, das Sie erstellen möchten. 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 Aufrufen der API 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 zu aktivieren ist optional. Wenn Sie die Abrechnung aktiviert haben, wählen Sie ein Abrechnungskonto für das neue Projekt aus. Die Verwendung der Google Ads API ist kostenlos, 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 bei Aufforderung Ihr Projekt aus oder erstellen Sie ein neues. In der API-Bibliothek finden Sie alle verfügbaren APIs nach Produktfamilie und Beliebtheit gruppiert.
Verwenden Sie die Suchfunktion, um die Google Ads API zu finden, wenn sie nicht in der Liste angezeigt wird.
Wählen Sie die Google Ads API aus und klicken Sie dann auf die Schaltfläche Aktivieren.
API-Zugriff beantragen
Rufen Sie als Nächstes die Seite Google Ads API – Übersicht auf. Auf der Seite wird Ihre aktuelle API-Zugriffsebene angezeigt. Wenn Ihre aktuelle API-Zugriffsebene Test Account Access level (Zugriffsebene für Testkonto) ist, maximieren Sie den Bereich Apply for next access level (Nächste Zugriffsebene beantragen). Folgen Sie der Anleitung, um die Explorer Access level (Zugriffsebene für Explorer) zu beantragen.
Nachdem Sie den Antrag eingereicht haben, prüft Google ihn automatisch und stuft ihn in den meisten Fällen auf die Zugriffsebene für Explorer hoch.
OAuth-Zustimmungsbildschirm konfigurieren
Wenn Sie für die Autorisierung OAuth 2.0 verwenden, zeigt Google einen Zustimmungsbildschirm an, der eine Übersicht Ihres Projekts, seiner Richtlinien und der angeforderten Autorisierungsbereiche für den Zugriff enthält. Wenn Sie den OAuth-Zustimmungsbildschirm Ihrer App konfigurieren, legen Sie fest, was Nutzern und App-Prüfern angezeigt wird, und registrieren Ihre App, damit Sie sie später veröffentlichen können.
Folgen Sie der Anleitung
um einen OAuth-Zustimmungsbildschirm für Ihre Anwendung zu konfigurieren und hinzuzufügen
https://www.googleapis.com/auth/adwords als OAuth-Bereich.
Wichtige Überlegungen zu Nutzertyp und Veröffentlichungsstatus
Achten Sie beim Konfigurieren des OAuth-Zustimmungsbildschirms auf die Einstellungen für Nutzertyp und Veröffentlichungsstatus.
- Nutzertyp:Definiert, ob Ihre App auf Nutzer in Ihrer Organisation beschränkt ist („Intern“) oder für alle Google-Nutzer verfügbar ist („Extern“). „Intern“ ist nur eine Option, wenn Ihr Projekt Teil einer Google Workspace-Organisation ist.
- Veröffentlichungsstatus:Bestimmt, ob sich die App im Modus „Testen“ befindet (beschränkt auf bestimmte Testnutzer, die Sie hinzufügen) oder „In Produktion“ ist (verfügbar für die durch den Nutzertyp definierte Zielgruppe, möglicherweise ist eine App-Überprüfung durch Google erforderlich).
Um die besten Entscheidungen für Ihre Anwendung zu treffen, lesen Sie die detaillierten Erklärungen und Auswirkungen dieser Einstellungen in der offiziellen Google Cloud-Supportdokumentation:
- Optionen für den Nutzertyp auf dem OAuth-Zustimmungsbildschirm
- Optionen für den Veröffentlichungsstatus auf dem OAuth-Zustimmungsbildschirm
Das Verständnis dieser Einstellungen ist entscheidend, 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 Clientschlüssel generiert wurden. Andernfalls erstellen Sie eine Client-ID und einen Clientschlüssel gemäß der 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.