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, 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 an die API verwendet werden.
Sie können zwar ein einzelnes Entwicklertoken für mehrere Projekte verwenden, aber jedes Projekt kann nur ein einzelnes Entwicklertoken verwenden.
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. 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 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.
OAuth-Zustimmungsbildschirm konfigurieren
Wenn Sie für die Autorisierung OAuth 2.0 verwenden, zeigt Google einen Zustimmungsbildschirm an, der eine Zusammenfassung 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 Zielgruppe, die durch den Nutzertyp definiert wird, 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
Es ist wichtig, diese Einstellungen zu verstehen, damit Ihre Anwendung für die beabsichtigten 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.