Das Entwicklertoken ist eine 22 Zeichen lange alphanumerische Zeichenfolge, die verwendet wurde, um Ihre App mit der Google Ads API zu verbinden. Entwicklertokens wurden am 9. September 2026 eingestellt. In dieser Anleitung werden die Änderungen zusammengefasst und die häufig gestellten Fragen zu dieser Migration aufgeführt, um bestehenden Entwicklern zu helfen.

Was ändert sich?

Im Rahmen der Einstellung von Entwicklertokens haben wir mehrere Änderungen an der Einführung der Google Ads API und der API-Zugriffsverwaltung vorgenommen. In diesem Abschnitt werden die wichtigsten Änderungen hervorgehoben.

API-Zugriffsebenen sind mit Google Cloud-Projekten verknüpft

Wir haben Entwicklertokens am 9. September 2026 eingestellt. Ihre aktuelle und aktive Zugriffsebene für Entwicklertokens wurde basierend auf den letzten API-Aktivitäten automatisch auf Ihre Google Cloud-Projekte übertragen. Sie können weiterhin Entwicklertokens in Ihren API-Aufrufkopfzeilen senden. Dies ist jedoch optional und wird von den API-Servern ignoriert. Ihr vorhandener Code funktioniert ohne Änderungen. Ihre API-Zugriffsebenen werden jetzt durch das Google Cloud-Projekt bestimmt, mit dem Sie Ihre OAuth-Anmeldedaten generiert haben.

• Wenn Ihre App den Nutzerauthentifizierungs-Workflow verwendet, ist dies das Projekt, das Ihre OAuth-Client-ID und Ihren OAuth-Clientschlüssel enthält.
• Wenn Sie den Dienstkonto-Workflow verwenden, ist dies das Projekt, das Ihr Dienstkonto enthält.

Neue Registrierung für die Google Ads API

Sie können sich jetzt direkt in der Google Cloud Console für den Zugriff auf die Google Ads API registrieren, ohne ein Google Ads-Verwaltungskonto zu benötigen. Registrieren Sie sich nicht auf der Seite „API-Center“ für ein Entwicklertoken und versuchen Sie nicht, auf der Seite „API-Center“ in Ihrem Google Ads-Verwaltungskonto Zugriff auf die API zu beantragen. Diese Prozesse wurden in die Google Cloud Console verlagert und werden nicht verarbeitet, wenn sie auf der Seite „API-Center“ initiiert werden.

Neue API-Zugriffsverwaltung

Wir haben alle neuen Registrierungs- und API-Zugriffsverwaltungsfunktionen eingestellt, z. B. das Beantragen von API-Zugriff und das Verwalten von API-Zugriffsebenen auf der Seite „API-Center“ in Google Ads-Verwaltungskonten. Diese Funktionen sind jetzt auf der Seite „Übersicht der Google Ads API“ in der Google Cloud Console stattdessen verfügbar.

Sie können weiterhin auf die Seite „API-Center“ zugreifen, um Ihre bisherigen Entwicklerdetails zu sehen. Diese Seite wird in Zukunft vollständig eingestellt.

Neue Fehlercodes

In Version 25 der Google Ads API wird der Fehler CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION ausgelöst, wenn Sie versuchen, mit einem Google Cloud-Projekt mit der Zugriffsebene „Testkontozugriff“ Aufrufe an ein Produktionskonto zu senden. In älteren API-Versionen wird stattdessen der ACTION_NOT_PERMITTED ausgelöst. Wenn dieser Fehler auftritt, rufen Sie die Seite „Übersicht der Google Ads API“ für Ihr Google Cloud-Projekt auf und beantragen Sie den Explorer-Zugriff.

Markenüberprüfung für Basis- und Standardzugriff erforderlich

Für neue Anwendungen mit Basis- und Standardzugriff müssen Sie die Marken überprüfung für Ihr Google Cloud-Projekt durchführen. Bestehende Zugriffsinhaber müssen die Markenüberprüfung nicht durchführen, es wird jedoch empfohlen.

Anwendungen mit Basiszugriff werden jetzt automatisiert und innerhalb weniger Minuten nach der Markenüberprüfung und Einreichung überprüft.

Aufgrund dieser Prozessaktualisierungen werden alle ausstehenden Anträge auf Basis-API-Zugriff im Rahmen dieser Umstellung geschlossen. Betroffene Antragsteller erhalten eine E‑Mail mit Details und sollten den API-Zugriff auf der Seite „Übersicht der Google Ads API “ neu beantragen.

Neue E‑Mail-Adressen für API-Kontakte

Im Rahmen der Vorbereitung auf die Einstellung der Seite „API-Center“ verwenden wir die Liste der Inhaber und Bearbeiter in Ihrem Google Cloud-Projekt als einzigen Kanal für administrative und obligatorische Compliance-Mitteilungen. Um einen reibungslosen Übergang zu gewährleisten, senden wir obligatorische Servicemitteilungen vorübergehend weiterhin an die E‑Mail-Adresse, die in Ihrem API-Center aufgeführt ist. Wir informieren Sie, sobald wir die Umstellung unserer Kommunikationskanäle abgeschlossen haben.

Was müssen bestehende Entwickler tun?

API-Zugriffsebenen Ihres Google Cloud-Projekts überprüfen:Wenn Sie bereits Entwickler sind, empfehlen wir Ihnen, die Seite „Übersicht der Google Ads API“ Ihrer Google Cloud-Projekte zu überprüfen, um sicherzustellen, dass sie dieselbe API-Zugriffsebene wie Ihr vorhandenes Entwicklertoken haben. Folgen Sie der Anleitung in diesem Leitfaden, um eventuelle Abweichungen zu beheben.

E‑Mail-Adresse für API-Kontakte überprüfen:Rufen Sie die Seite „IAM (Identity and Access Management)“ für Ihr Google Cloud-Projekt auf. Prüfen Sie, ob Ihren aktiven Google Ads-Entwicklern und Account Managern die entsprechenden Rollen „Inhaber“ oder „Bearbeiter“ in Ihrem Google Cloud-Projekt zugewiesen sind. Wir senden obligatorische Servicemitteilungen an diese E‑Mail-Adressen, um Sie über zukünftige Änderungen an der Google Ads API zu informieren. Wir senden obligatorische Servicemitteilungen vorübergehend weiterhin an die E‑Mail-Adresse, die in Ihrem API-Center aufgeführt ist. Wir informieren Sie, wenn sich dieser Prozess ändert.

App-Code korrigieren:Wir empfehlen Ihnen, Ihre App zu aktualisieren, damit das Entwicklertoken nicht mehr als Teil der API-Aufrufe gesendet wird. Wir haben aktualisierte Versionen von den Clientbibliotheken, dem Google Ads MCP-Server und dem Google Ads API Developer Assistant veröffentlicht, mit denen Sie API-Aufrufe senden können , ohne ein Entwicklertoken festzulegen. In einer zukünftigen Hauptversion der Google Ads API werden wir Entwicklertokens in API-Aufrufen ablehnen. Wenn Ihre App diese Bibliotheken verwendet, aktualisieren Sie die App-Abhängigkeiten auf die neueste Version.

Wenden Sie sich an den Google Ads API-Support, wenn Sie weitere Unterstützung benötigen oder Fragen haben.

Häufig gestellte Fragen

Was passiert mit den API-Zugriffsebenen?

API-Zugriffsebenen werden weiterhin in der Google Ads API erzwungen. Sie werden jetzt jedoch Ihrem Google Cloud Console-Projekt anstelle Ihres Entwicklertokens gewährt. Wenn Sie API-Aufrufe senden, werden Ihre API-Zugriffsebenen jetzt durch das Google Cloud Projekt bestimmt, mit dem Sie Ihre OAuth-Anmeldedaten generiert haben.

• Wenn Ihre App den Nutzerauthentifizierungs-Workflow verwendet, ist dies das Projekt, das Ihre OAuth-Client-ID und Ihren OAuth-Clientschlüssel enthält.
• Wenn Sie den Dienstkonto-Workflow verwenden, ist dies das Projekt, das Ihr Dienstkonto enthält.

Wie wurden die Projekte für die Übertragung von API-Zugriffsebenen ermittelt?

Wenn Sie vor dem 9. September 2026 bereits ein genehmigtes Entwicklertoken hatten, wurden die Zugriffsebenen wie folgt auf Ihre Google Cloud-Projekte übertragen:

• Wir haben die API-Aufrufprotokolle der letzten 90 Tage geprüft, um zu ermitteln, welche Cloud-Projekte verwendet wurden, um API-Aufrufe mit Ihrem genehmigten Entwicklertoken zu senden.
• Wir haben allen ermittelten Cloud-Projekten die API-Zugriffsebenen des Entwicklertokens zugewiesen.

Kann ich nach dieser Änderung mehrere Cloud-Projekte mit verschiedenen Zugriffsebenen haben?

Ja, Sie können mehrere Google Cloud-Projekte mit unterschiedlichen API-Zugriffsebenen haben. Sie können beispielsweise ein Google Cloud-Projekt mit Basiszugriff und ein anderes Google Cloud-Projekt mit Standardzugriff haben.

Beispiel

Angenommen, Sie haben vier Entwicklertokens und sechs Cloud-Projekte mit den folgenden Details:

• Entwicklertoken 1: abcdefghijkl1234567890 hat Standardzugriff. Es wurde mit den Projekt-IDs 1234567890, 5678912345 und 45678912345 verwendet.
• Entwicklertoken 2: xyzabcdefghi6789012345 hat Basiszugriff. Es wurde mit der Projekt-ID 1231235678 verwendet.
• Entwicklertoken 3: asdfgflkjhjz7654321012 hat Basiszugriff, wurde aber noch nie für einen API-Aufruf verwendet. Es wurde kürzlich genehmigt.
• Entwicklertoken 4: qwertypoiuyu6543298790 hatte Standardzugriff, wurde aber in den letzten 90 Tagen nicht verwendet. Die Projekt-ID 9876564900 wurde in der Vergangenheit mit diesem Entwicklertoken verwendet.
• Cloud-Projekt: Die Cloud-Projekt-ID 7171234567 wurde noch nie mit einem der Entwicklertokens für einen API-Aufruf verwendet.

Die API-Zugriffsebenen werden wie folgt von den Entwicklertokens auf die Google Cloud-Projekte übertragen:

Entwicklertoken	Projekt-ID	Zugriffsebene	Erklärung
abcdefghijkl1234567890	1234567890	Standardzugriff	Das Entwicklertoken und die Projekt-ID sind miteinander verknüpft.
abcdefghijkl1234567890	5678912345	Standardzugriff	Das Entwicklertoken und die Projekt-ID sind miteinander verknüpft.
abcdefghijkl1234567890	45678912345	Standardzugriff	Das Entwicklertoken und die Projekt-ID sind miteinander verknüpft.
xyzabcdefghi6789012345	1231235678	Basiszugriff	Das Entwicklertoken und die Projekt-ID sind miteinander verknüpft.
asdfgflkjhjz7654321012	--	--	Der API-Zugriff des Entwicklertokens wurde nicht auf ein Projekt übertragen da es nie für einen API-Aufruf verwendet wurde.
qwertypoiuyu6543298790	9876564900	Testkontozugriff	Der API-Zugriff des Entwicklertokens wurde aufgrund von Inaktivität für 90 Tage widerrufen. Die API-Zugriffsebene des Projekts ist standardmäßig „Testkontozugriff“.
--	7171234567	Testkontozugriff	Dies ist ein neues Projekt, das noch nie mit einem Entwicklertoken verwendet wurde. Die API-Zugriffsebene des Projekts ist standardmäßig „Testkontozugriff“.

Ich habe mehrere genehmigte Entwicklertokens. Auf welches Projekt werden die API-Zugriffsebenen übertragen?

Die Zugriffsebenen jedes genehmigten Entwicklertokens werden auf die Google Cloud-Projekte übertragen, die mit diesem Entwicklertoken verknüpft sind. Beispiel an sehen.

Ich verwende mehrere Google Cloud-Projekte. Auf welches Projekt werden die API-Zugriffsebenen übertragen?

Wenn Sie in den letzten 90 Tagen mehrere Google Cloud-Projekte mit Ihrem genehmigten Entwicklertoken verwendet haben, erhalten alle diese Projekte dieselben API-Zugriffsebenen wie Ihr Entwicklertoken. Beispiel ansehen.

API-Zugriffsebenen wurden einem Projekt zugewiesen, das ich nicht mehr verwende. Wie behebe ich dieses Problem?

Wenn der Google Ads API-Zugriff einem Google Cloud-Projekt zugewiesen ist, das Sie nicht mehr verwenden, sind keine weiteren Maßnahmen erforderlich. Google widerruft den API Zugriff für das nicht verwendete Projekt nach 90 Tagen Inaktivität.

API-Zugriffsebenen wurden meinem Google Cloud-Projekt nicht zugewiesen. Wie behebe ich dieses Problem?

Ihr Google Cloud-Projekt hat die Zugriffsebene Ihres Entwicklertokens wahrscheinlich nicht übernommen, weil Sie Ihr Entwicklertoken und das Cloud-Projekt nie für einen API-Aufruf verwendet haben oder der API-Zugriff Ihres Entwicklertokens aufgrund von Inaktivität kürzlich abgelaufen ist. Um das Problem zu beheben, beantragen Sie auf der Seite „Übersicht der Google Ads API “ die entsprechende API-Zugriffsebene für dieses Projekt. Beispiel ansehen.

Wo kann ich die API-Zugriffsebenen meines Projekts sehen?

Die API-Zugriffsebene Ihres Google Cloud-Projekts finden Sie auf der Seite „Übersicht der Google Ads API“.

Wie beantrage ich höhere API-Zugriffsebenen?

Sie können auf der Seite „Übersicht der Google Ads API“ höhere API-Zugriffsebenen für Ihr Google Cloud-Projekt beantragen.

Was passiert mit meinem ausstehenden Antrag auf API-Zugriff?

Alle ausstehenden Anträge auf Basiszugriff, die Sie vor dem 9. September 2026 im API-Center Ihres Google Ads-Verwaltungskontos gestellt haben, werden geschlossen. Sie sollten den Basiszugriff auf der Seite „Übersicht der Google Ads API “ Ihres Google Cloud-Projekts neu beantragen. Wenn Sie von dieser Änderung betroffen sind, erhalten Sie eine E‑Mail mit den erforderlichen Anweisungen.

Alle ausstehenden Anträge auf Standardzugriff, die Sie ab dem 9. September 2026 im API-Center Ihres Google Ads-Verwaltungskontos gestellt haben, werden wie gewohnt überprüft. Wenn der Antrag genehmigt wird, erhält das Google Cloud-Projekt, das mit Ihrem Entwicklertoken verknüpft ist, Standardzugriff.

Kann ich mein genehmigtes Entwicklertoken mit einem neuen Google Cloud-Projekt verknüpfen?

In der Vergangenheit hat das Google Ads API-Team die Verknüpfung eines Entwicklertokens mit einem neuen Google Cloud-Projekt im Einzelfall unterstützt. Dies wird seit dem 9. September 2026 nicht mehr unterstützt, da wir Entwicklertokens eingestellt haben. Wenn Sie ein neues Google Cloud-Projekt verwenden möchten, sollten Sie auf der Seite „Übersicht der Google Ads API“ Ihres Google Cloud-Projekts den entsprechenden API Zugriff beantragen.

Ich habe ein genehmigtes Entwicklertoken, aber es noch nie verwendet. Kann ich dieses Entwicklertoken verwenden?

Nein, Sie können dieses Entwicklertoken nicht verwenden. Es gibt zwei Möglichkeiten:

1. Der Zugriff auf Ihr Entwicklertoken wurde möglicherweise aufgrund von Inaktivität widerrufen: Gemäß den Google-Richtlinien kann Google Ihr API-Token widerrufen, wenn es an 90 aufeinanderfolgenden Tagen nicht verwendet wird. Wenn Sie Ihr Entwicklertoken schon länger nicht mehr verwendet haben, wurden die Zugriffsebenen wahrscheinlich aufgrund von Inaktivität widerrufen. In diesem Fall beantragen Sie auf der Seite „Übersicht der Google Ads API“ den API-Zugriff für Ihr Google Cloud-Projekt neu. Beispiel ansehen.

2. Ihr Entwicklertoken wurde kürzlich genehmigt, aber Sie haben es vor dem 9. September 2026 nie verwendet:Da Sie Ihr genehmigtes Entwicklertoken vor dem 9. September 2026 nie mit einem Google Cloud-Projekt verwendet haben, wurden die Zugriffsebenen nicht auf das Cloud-Projekt übertragen. Daher können Sie Ihr Entwicklertoken nicht mehr verwenden. Wir lösen den CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION Fehler aus, wenn Sie versuchen, mit diesem Entwickler token einen API-Aufruf an ein Produktionskonto zu senden. Um den Fehler zu beheben, beantragen Sie auf der Seite Übersicht der Google Ads API Ihres Google Cloud-Projekts den entsprechenden API-Zugriff. Beispiel an sehen.

In beiden Fällen können Sie den Explorer-Zugriff und den Basiszugriff beantragen und die Anträge automatisch überprüfen lassen. Sie müssen nicht mehr mit dem Compliance-Team von Google zusammenarbeiten, um die Überprüfung abzuschließen. Wenn Sie Standardzugriff benötigen, ist eine manuelle Überprüfung erforderlich. Sie können jedoch die Details Ihres genehmigten Entwicklertokens angeben, wenn Sie Standardzugriff beantragen, damit das Compliance-Team Ihren neuen Antrag auf Standardzugriff entsprechend überprüfen kann.

Kann ich Entwicklertokens nicht mehr als Teil meiner API-Anfragen senden?

Ja, Sie können Entwicklertokens nicht mehr als Teil Ihrer API-Anfragen senden. Wenn Sie eine Clientbibliothek verwenden, müssen Sie möglicherweise ein Upgrade auf die neueste Version durchführen. Prüfen Sie in den Änderungsprotokollen der Bibliothek, ob sie API-Aufrufe ohne Angabe eines Entwicklertokens unterstützt.

Ich habe am Pilotprogramm für verwaltete Zugriffsebenen in der Cloud teilgenommen. Inwiefern bin ich betroffen?

Das Pilotprogramm für verwaltete Zugriffsebenen in der Cloud wurde eingeführt, damit Google Cloud-Entwickler API-Aufrufe senden können, ohne ein Entwicklertoken als Teil der API-Anfrage zu senden. Da wir Entwicklertokens eingestellt haben, wird dieses Programm eingestellt.

Die Zugriffsebenen Ihres aktiven Entwicklertokens wurden auf Ihr Google Cloud-Projekt übertragen. Ihr vorhandener Code sollte also ohne Änderungen funktionieren. Wenn Sie ein neues Google Cloud-Projekt verwenden möchten, sollten Sie auf der Seite „Übersicht der Google Ads API“ Ihres Google Cloud-Projekts den API Zugriff beantragen.

Mein Entwicklertoken war auf einer Zulassungsliste. Inwiefern bin ich betroffen?

Google führt möglicherweise Pilotprogramme durch, die einigen Entwicklern Zugriff auf experimentelle Funktionen gewähren. Der Zugriff auf diese Funktionen wird manchmal gewährt, indem Ihr Entwicklertoken einer Zulassungsliste hinzugefügt wird. Wenn Sie an einem solchen Pilotprogramm teilgenommen haben, sind keine Maßnahmen erforderlich.

Wir haben alle Pilotprogramme aktualisiert, sodass Google Cloud-Projekte anstelle von Entwicklertokens als Zulassungsmechanismus verwendet werden. Außerdem haben wir den Zulassungsstatus des Entwicklertokens auf die zugehörigen Google Cloud-Projekte übertragen. Ihr vorhandener Code sollte ohne Änderungen funktionieren. Wenn weiterhin Probleme auftreten, wenden Sie sich an Ihren Google Account Manager, der Sie für das Pilotprogramm registriert hat.

Ich habe ein genehmigtes Entwicklertoken und möchte es mit einem neuen Google Cloud-Projekt verwenden. Ist das erlaubt?

Nein, Sie können kein neues Google Cloud-Projekt mit Ihrem genehmigten Entwicklertoken verwenden. Da Sie Ihr genehmigtes Entwicklertoken vor dem 9. September 2026 nie mit dem neuen Google Cloud-Projekt verwendet haben, wurden die Zugriffsebenen nicht auf das Cloud-Projekt übertragen. Wir lösen den Fehler CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION aus, wenn Sie versuchen mit diesem Entwicklertoken einen API-Aufruf zu senden, da Entwicklertokens nicht mehr verwendet werden, um Ihre API-Zugriffsebenen zu bestimmen. Um den Fehler zu beheben, beantragen Sie auf der Seite „Übersicht der Google Ads API“ Ihres Google Cloud-Projekts den entsprechenden API-Zugriff. Beispiel ansehen.

Mein Entwicklertoken wurde extern weitergegeben. Muss ich mein Entwicklertoken zurücksetzen?

Nein, Sie müssen das Entwicklertoken in diesem Fall nicht zurücksetzen. Da wir die API-Zugriffsebenen Ihres Entwicklertokens auf Ihr Google Cloud-Projekt übertragen haben, kann ein nicht autorisierter Nutzer Ihr Entwicklertoken nicht mehr mit seinem eigenen Google Cloud-Projekt verwenden. Sie können das Entwicklertoken jedoch im API-Center zurücksetzen, wenn Sie dies bevorzugen.

Was passiert mit dem API-Center?

Die vorhandene Seite „API-Center“ im Google Ads-Verwaltungskonto ist veraltet und wird in Kürze entfernt. Wenn Sie bereits ein Entwicklertoken haben, können Sie sich weiterhin in Ihrem Google Ads-Verwaltungskonto anmelden und die Details ansehen. Diese werden jedoch nur zu Referenzzwecken bereitgestellt. Führen Sie auf dieser Seite keine Aufgaben im Zusammenhang mit Zugriffsebenen für Entwicklertokens aus, z. B. das Beantragen höherer API-Zugriffsebenen.

Wenn Sie höhere API-Zugriffsebenen beantragen möchten, sollten Sie dies auf der Seite „Übersicht der Google Ads API“ Ihres Google Cloud-Projekts tun.

Benötige ich weiterhin ein Google Ads-Verwaltungskonto, um die Google Ads API zu verwenden?

Sie benötigen kein Google Ads-Verwaltungskonto mehr, um die Google Ads API zu verwenden. Ein Verwaltungskonto ist nur erforderlich, wenn Sie mehrere Konten mit der API verknüpfen und verwalten müssen.

Ich bin ein neuer Entwickler. Wie registriere ich mich für die Google Ads API?

Folgen Sie der Anleitung im Leitfaden „Erste Schritte“, um sich für die Google Ads API zu registrieren. Registrieren Sie sich nicht im API-Center Ihres Google Ads-Verwaltungskontos für ein Entwicklertoken. Diese Anträge werden nicht bearbeitet. Das API-Center wird in Kürze eingestellt.