Wie Sie ein Google API Console-Projekt erstellen und konfigurieren, hängt vom OAuth 2.0-Autorisierungsszenario Ihrer Anwendung ab. Wählen Sie ein Autorisierungsszenario aus, um diese Anleitung anzupassen.
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.
Mit diesen Anmeldedaten wird Ihre App oder werden Google Ads-Nutzer auf Google-Servern authentifiziert und autorisiert. Außerdem können Sie damit OAuth-Tokens generieren, die in API-Aufrufen verwendet werden.
Google API Console-Projekt auswählen oder erstellen
Folgen Sie der Anleitung zum Erstellen eines Google API Console-Projekts, um ein neues Projekt einzurichten. Die Abrechnung für Ihr Projekt zu aktivieren ist optional. Wenn die Abrechnung aktiviert ist, wählen Sie ein Rechnungskonto für das neue Projekt aus. Die Verwendung der Google Ads API ist kostenlos. Für Cloud-Projekte gelten jedoch die Standardkontingentlimits für 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 Ihr 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, um Ihre aktuelle API-Zugriffsebene zu prüfen. Wenn Ihre aktuelle API-Zugriffsebene Test ist, maximieren Sie den Bereich Zugriffsebene upgraden. Folgen Sie der Anleitung, um die Zugriffsebene Explorer zu beantragen.
Nachdem Sie den Antrag ausgefüllt haben, wird er in den meisten Fällen automatisch von Google geprüft und auf Explorer-Zugriff hochgestuft.
OAuth-Zustimmungsbildschirm konfigurieren
Wenn Sie für die Autorisierung OAuth 2.0 verwenden, zeigt Google Nutzern einen Zustimmungsbildschirm an, der eine Übersicht Ihres Projekts und dessen Richtlinien sowie die 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.
Konfigurieren Sie einen OAuth-Zustimmungsbildschirm für Ihre Anwendung und fügen Sie https://www.googleapis.com/auth/adwords als OAuth-Bereich hinzu.
Wichtige Hinweise zu Nutzertyp und Veröffentlichungsstatus
Achten Sie beim Konfigurieren des OAuth-Zustimmungsbildschirms auf die Einstellungen 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). Intern ist nur verfügbar, 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 (verfügbar für die Zielgruppe, die durch Nutzertyp definiert wird, was möglicherweise eine App-Überprüfung durch Google erfordert).
Um die besten Entscheidungen für Ihre Anwendung zu treffen, sollten Sie sich die detaillierten Erklärungen und Auswirkungen dieser Einstellungen in der offiziellen Google Cloud-Supportdokumentation ansehen:
- Optionen für den Nutzertyp des OAuth-Zustimmungsbildschirms
- Veröffentlichungsstatus des OAuth-Zustimmungsbildschirms Optionen
Es ist wichtig, dass Sie sich mit diesen Einstellungen vertraut machen, damit Ihre Anwendung für die vorgesehenen Nutzer zugänglich ist.
Client-ID und Clientschlüssel erstellen
Client-ID und Clientschlüssel erstellen. 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 im Bestätigungsdialogfeld auf den Button JSON herunterladen.