Das Entwicklertoken ist ein 22-stelliger alphanumerischer String, mit dem Ihre App eine Verbindung zur Google Ads API herstellen kann. Sie erhalten es, wenn Sie sich auf der Seite API-Center Ihres Google Ads-Verwaltungskontos registrieren. Bei jedem API-Aufruf senden Sie das Entwicklertoken als Teil der Anfrage, indem Sie den HTTP- oder gRPC-Header developer-token festlegen.
Jedem Entwicklertoken ist eine Zugriffsebene zugewiesen, die die Anzahl der API-Aufrufe pro Tag mit dem Token sowie die Umgebung steuert, an die Sie Aufrufe senden können.
Wenn Sie sich für ein Entwicklertoken registrieren, wird Ihnen möglicherweise standardmäßig die Zugriffsebene Explorer-Zugriff gewährt. Damit können Sie Aufrufe an Produktionskonten senden, jedoch mit bestimmten Einschränkungen. In bestimmten Fällen, in denen wir Ihre Bewerbung für ein Entwicklertoken nicht automatisch überprüfen können, gewähren wir Ihrem Entwicklertoken stattdessen die Zugriffsebene Zugriff auf Testkonto. Damit können Sie nur API-Aufrufe an Testkonten senden. Wenn Sie die Einschränkungen der Zugriffsebenen „Explorer-Zugriff“ und „Zugriff auf Testkonto“ aufheben möchten, müssen Sie für Ihr Entwicklertoken die Zugriffsebene Basiszugriff oder Standardzugriff beantragen. Sobald Ihre Bewerbung für ein Entwicklertoken überprüft und genehmigt wurde, wird Ihrem Entwicklertoken die entsprechende Zugriffsebene gewährt.
Benötigen Sie ein neues Entwicklertoken?
Ob Sie sich für ein neues Entwicklertoken registrieren sollten, hängt von einigen Faktoren ab. Im Folgenden werden einige Szenarien aufgeführt:
Szenario |
Nächste Schritte |
| Ihr Unternehmen hat die Google Ads API noch nie verwendet und Sie möchten eigene Apps entwickeln. | Registrieren Sie sich für ein neues Entwicklertoken. Weitere Informationen |
| Ihr Unternehmen verwendet die Google Ads API aktiv oder hat sie in der Vergangenheit verwendet. | Google gewährt in der Regel ein Entwicklertoken pro Unternehmen. Wenn Ihr Unternehmen die Google Ads API also bereits verwendet, sollten Sie Ihr vorhandenes Entwicklertoken wiederverwenden. Weitere Informationen |
| Ihr Unternehmen verwendet die Google Ads API bereits, entwickelt aber auch ein neues Produkt oder Tool. | Wenn Sie sicher sind, dass Sie Ihr vorhandenes Entwicklertoken nicht verwenden können, dann können Sie ein neues beantragen und in der Bewerbung Ihren Anwendungsfall erläutern. Für den Rest dieser Anleitung können Sie Ihr vorhandenes Entwickler Token verwenden. Weitere Informationen |
| Ihr Unternehmen verwendet eine Drittanbieter-App. | Sie benötigen nur dann ein Entwicklertoken, wenn Sie eine eigene App entwickeln. Wenn Sie eine Drittanbieter-App oder einen Drittanbieterdienst verwenden, muss der Entwickler dieser App ein Entwicklertoken für die App beantragen. Wenn Sie sich nicht sicher sind, wie Sie vorgehen sollen, wenden Sie sich an das API-Compliance-Team. |
Wer kann ein Entwicklertoken beantragen?
Sowohl Unternehmen als auch einzelne Entwickler können ein Entwicklertoken beantragen. In der folgenden Tabelle sind die Details zusammengefasst, die Sie bei der Registrierung für das Entwicklertoken angeben müssen.
| Wenn Sie | geben Sie die folgenden Entwicklerdetails an | Zusätzliche Hinweise |
|---|---|---|
| ein Entwickler sind, der Ihr Unternehmen oder ein Produktteam vertritt | den Namen und die URL Ihres Unternehmens | Google gewährt in der Regel ein Entwicklertoken pro Unternehmen, genehmigt aber separate Entwicklertokens für separate Tools von Fall zu Fall. |
| ein einzelner Entwickler sind, der kein Unternehmen vertritt | geben Sie als Unternehmensnamen Individual an. Anstelle einer Unternehmens-URL können Sie alternative URLs angeben, z. B. die URL Ihres GitHub- oder LinkedIn-Profils.
|
Sie müssen online präsent sein und Google eine URL
zur Verfügung stellen, mit der wir beurteilen können, was Sie mit der Google Ads API vorhaben. Allgemeine URLs
wie test.com und example.com werden nicht
akzeptiert. |
Entwicklertoken beantragen
Die Beantragung eines Entwicklertokens erfolgt in zwei Schritten.
Schritt 1: Google Ads-Verwaltungskonto auswählen oder erstellen
Wenn Sie bereits ein Google Ads-Verwaltungskonto haben, wählen Sie es bei der Beantragung des Entwicklertokens aus. Wenn dieses Verwaltungskonto noch nicht mit Ihren anderen Konten verknüpft ist, empfehlen wir, es an den Anfang Ihrer Kontohierarchie zu setzen, um die Überprüfung des Tokens zu erleichtern und die Kontoverwaltung später zu vereinfachen.
Wenn Sie kein Verwaltungskonto haben, können Sie der Anleitung in der Google Ads-Hilfe folgen, um eines zu erstellen.
Schritt 2: Zugriff auf die Google Ads API beantragen
Die Überprüfung des Entwicklertokens kann einige Zeit in Anspruch nehmen. Weitere Informationen.
Rufen Sie in Ihrem Webbrowser https://ads.google.com/aw/apicenter auf. Melden Sie sich bei Aufforderung in Ihrem Google Ads-Verwaltungskonto an.
Füllen Sie das Formular für den API-Zugriff aus und akzeptieren Sie die Nutzungsbedingungen.
Achten Sie darauf, dass Ihre Angaben korrekt sind und die Website-URL Ihres Unternehmens funktioniert. Wenn die Website nicht aktiv ist, kann Google Ihre Bewerbung möglicherweise nicht bearbeiten und lehnt sie ab.
Achten Sie darauf, dass die von Ihnen angegebene E-Mail-Adresse für den API-Kontakt zu einem Posteingang führt, der regelmäßig überprüft wird. Das API-Compliance-Team von Google wendet sich während der Überprüfung möglicherweise an diese E-Mail-Adresse, um Fragen zu klären. Wenn Sie nicht erreichbar sind, wird Google Ihre Bewerbung möglicherweise nicht weiter bearbeiten.
Sie können die E-Mail-Adresse für den API-Kontakt im API-Center bearbeiten. Halten Sie diese Informationen auch nach der Bewerbung auf dem neuesten Stand, damit Google Ihnen wichtige Servicemitteilungen senden kann.
Nachdem Sie die Bewerbung abgeschlossen haben, wird das Entwicklertoken mit einem der folgenden Ergebnisse im API-Center angezeigt:
- Ihr Entwicklertoken hat die Zugriffsebene Explorer-Zugriff mit dem Status Genehmigt. Das bedeutet, dass Google Ihre Bewerbung für ein Entwicklertoken für die Zugriffsebene „Explorer-Zugriff“ automatisch überprüfen und genehmigen konnte. Sie können API-Aufrufe an Ihr Produktionskonto oder Testkontosenden.
- Ihr Entwicklertoken hat die Zugriffsebene Zugriff auf Testkonto mit dem Status Genehmigung ausstehend. Das bedeutet, dass Google Ihre Bewerbung für ein Entwicklertoken für die Zugriffsebene „Explorer-Zugriff“ nicht automatisch überprüfen und genehmigen konnte. Sie können API-Aufrufe an Testkontensenden. Nachdem Sie diese Anleitung durchgearbeitet haben, empfehlen wir Ihnen, sich anzusehen, wie Sie die Zugriffsebene „Basiszugriff“ beantragen
Prüfen, ob Sie in einem Google Ads-Verwaltungskonto angemeldet sind
Sie müssen sich in Ihrem Google Ads-Verwaltungskonto anmelden, um auf Ihr Entwicklertoken zuzugreifen. Es darf sich dabei nicht um ein Google Ads-Testverwaltungskonto handeln.
So prüfen Sie, ob Sie in einem Google Ads-Verwaltungskonto angemeldet sind:
Rufen Sie in Ihrem Webbrowser https://ads.google.com/aw/apicenter auf.
Wenn Sie in einem Kundenkonto angemeldet sind, wird auf der Seite Nur Nutzer von Verwaltungskonten haben Zugriff auf das API-Center angezeigt.
Wenn oben rechts Testkonto rot angezeigt wird, handelt es sich bei Ihrem Konto entweder um ein Testverwaltungskonto oder ein Test werbekonto.
Entwicklertoken finden
Das Entwicklertoken finden Sie, falls vorhanden, auf der Seite API-Center Ihres Google Ads-Verwaltungskontos.