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 werden Ihre App oder Google Ads-Nutzer auf Google-Servern authentifiziert und autorisiert. Außerdem können Sie damit OAuth-Tokens generieren, die in Aufrufen der API verwendet werden.
Google API Console-Projekt auswählen oder erstellen
Wenn Sie ein neues Projekt einrichten möchten, folgen Sie der Anleitung zum Erstellen eines Google API Console-Projekts. 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. Die Nutzung der Google Ads API ist kostenlos, für Cloud-Projekte gelten jedoch die standardmäßigen Projektkontingentlimits.
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 der 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 du den Antrag ausgefüllt hast, wird er von Google automatisch überprüft und in den meisten Fällen auf Explorer-Zugriff hochgestuft.
OAuth-Zustimmungsbildschirm konfigurieren
Wenn Sie für die Autorisierung OAuth 2.0 verwenden, zeigt Google dem Nutzer einen Zustimmungsbildschirm an, der eine Zusammenfassung 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 registrieren Sie Ihre App, 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: Legt fest, ob Ihre App auf Nutzer innerhalb 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: Bestimmt, ob sich die App im Modus Test (beschränkt auf bestimmte von Ihnen hinzugefügte Testnutzer) oder In Produktion (verfügbar für die unter Nutzertyp definierte Zielgruppe, was möglicherweise eine App-Überprüfung durch Google erfordert) befindet.
Damit Sie die besten Entscheidungen für Ihre Anwendung treffen können, sollten Sie sich die detaillierten Erläuterungen und Auswirkungen dieser Einstellungen in der offiziellen Google Cloud-Supportdokumentation ansehen:
- Nutzertypoptionen für den OAuth-Zustimmungsbildschirm
- Optionen für den Veröffentlichungsstatus des OAuth-Zustimmungsbildschirms
Diese Einstellungen sind wichtig, damit Ihre Anwendung für die gewünschten Nutzer zugänglich ist.
Client-ID und Clientschlüssel erstellen
Client-ID und Clientschlüssel erstellen Sie können als Anwendungstyp entweder Desktop-Anwendung oder Webanwendung auswählen. Nachdem Sie den OAuth 2.0-Client erstellt haben, laden Sie die JSON-Datei des Clients herunter, indem Sie im Bestätigungsdialogfeld auf den Button JSON herunterladen klicken.