Entwicklertoken

Das Entwicklertoken ist ein 22 Zeichen langer alphanumerischer String, der verwendet wurde, um Ihre App mit der Google Ads API zu verbinden. Entwicklertokens wurden am 9. September 2026 eingestellt. In diesem Leitfaden werden die Änderungen zusammengefasst und die häufig gestellten Fragen zur Migration aufgeführt, um bestehenden Entwicklern zu helfen.

Was ändert sich?

Im Rahmen der Einstellung des Entwicklertokens haben wir einige Änderungen am Onboarding-Prozess für die Google Ads API und an der API-Zugriffsverwaltung vorgenommen. In diesem Abschnitt werden die wichtigsten Änderungen hervorgehoben.

API-Zugriffsebenen sind Google Cloud-Projekten zugeordnet

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

Neuer Registrierungsvorgang 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 dass ein Google Ads-Verwaltungskonto erforderlich ist. Registrieren Sie sich nicht über die Seite „API Center“ für ein Entwicklertoken und beantragen Sie keinen API-Zugriff über die Seite „API Center“ in Ihrem Google Ads-Verwaltungskonto. Diese Prozesse wurden in die Google Cloud Console verlagert und werden nicht bearbeitet, wenn sie über die Seite „API Center“ initiiert werden.

Neue Oberfläche für die API-Zugriffsverwaltung

Wir haben alle neuen Funktionen für die Registrierung und die Verwaltung des API-Zugriffs eingestellt, z. B. die Beantragung des API-Zugriffs und die Verwaltung von API-Zugriffsebenen auf der Seite API-Center in Google Ads-Verwaltungskonten. Diese Funktionen sind jetzt stattdessen in der Übersicht zur Google Ads API in der Google Cloud Console verfügbar.

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

Neue Fehlercodes

In Version v25 der Google Ads API wird der Fehler CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION ausgegeben, wenn Sie versuchen, mit einem Google Cloud-Projekt mit Testzugriff Aufrufe an ein Produktionskonto zu senden. Bei älteren API-Versionen wird stattdessen der Fehler ACTION_NOT_PERMITTED ausgegeben. Wenn dieser Fehler auftritt, rufen Sie die Übersichtsseite der Google Ads API für Ihr Google Cloud-Projekt auf und beantragen Sie den Explorer-Zugriff.

Für den grundlegenden und den Standardzugriff ist eine Markenüberprüfung erforderlich

Bei neuen Anwendungen mit grundlegendem und Standardzugriff müssen Sie die Markenüberprüfung für Ihr Google Cloud-Projekt abschließen. Inhaber von bestehendem Zugriff müssen die Markenüberprüfung nicht durchlaufen, es wird jedoch empfohlen.

Anträge auf Basiszugriff werden jetzt automatisiert und innerhalb von Minuten nach der Markenbestätigung und dem Einreichen geprüft.

Aufgrund dieser Prozessaktualisierungen werden alle ausstehenden Anträge auf Basiszugriff im Rahmen dieser Umstellung geschlossen. Betroffene Antragsteller erhalten eine E-Mail mit Details und sollten den Antrag für den Basiszugriff über die Übersichtsseite zur Google Ads API noch einmal stellen.

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

Im Rahmen der Vorbereitung auf die Einstellung der API Center-Seite werden wir die Liste der Inhaber- und Bearbeiternutzer in Ihrem Google Cloud-Projekt als einzigen Kanal für administrative und obligatorische Compliance-Mitteilungen verwenden. Für einen reibungslosen Übergang senden wir vorübergehend weiterhin Servicemitteilungen (MSAs, Mandatory Service Announcements) an die in Ihrem API-Center aufgeführte E-Mail-Adresse. Wir halten Sie auf dem Laufenden, sobald wir die Umstellung unserer Kommunikationskanäle abgeschlossen haben.

Vorgehensweise für bestehende Entwickler

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

API-Kontakt-E-Mail-Adresse prüfen:Rufen Sie die IAM-Seite (Identity and Access Management) für Ihr Google Cloud-Projekt auf. Prüfen Sie, ob Ihren aktiven Ads-Entwicklern und ‑Kundenbetreuern die entsprechenden Inhaber- oder Bearbeiterrollen in Ihrem Google Cloud-Projekt zugewiesen sind. Wir senden Ihnen künftig Servicemitteilungen an diese E-Mail-Adressen, um Sie über Änderungen an der Google Ads API zu informieren. Wir senden weiterhin für einen vorübergehenden Zeitraum MSAs an die in Ihrem API-Center aufgeführte Kontakt-E-Mail-Adresse. Sie werden benachrichtigt, sobald sich dieser Prozess ändert.

App-Code korrigieren:Wir empfehlen Ihnen, Ihre App so zu aktualisieren, dass das Entwicklertoken nicht mehr als Teil der API-Aufrufe gesendet wird. Wir haben aktualisierte Versionen der Clientbibliotheken, des Google Ads MCP-Servers und des Google Ads API Developer Assistant veröffentlicht, mit denen Sie API-Aufrufe ohne Entwicklertoken ausführen können. 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.

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

Häufig gestellte Fragen

Was passiert mit API-Zugriffsebenen?

API-Zugriffsebenen werden weiterhin in der Google Ads API erzwungen. Diese werden jetzt jedoch Ihrem Google Cloud Console-Projekt anstelle Ihres Entwicklertokens gewährt. Wenn Sie API-Aufrufe ausführen, werden Ihre API-Zugriffsebenen jetzt durch das Google Cloud-Projekt bestimmt, das Sie zum Generieren Ihrer OAuth-Anmeldedaten verwendet haben.

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

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

  • Wir haben die API-Aufrufprotokolle der letzten 90 Tage geprüft, um herauszufinden, mit welchen Cloud-Projekten API-Aufrufe mit Ihrem genehmigten Entwicklertoken erfolgt sind.
  • 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 Basic-Zugriff und ein anderes Google Cloud-Projekt mit Standard-Zugriff haben.

Beispiel

Angenommen, Sie haben 4 Entwicklertokens und 6 Cloud-Projekte mit den folgenden Details:

  • Entwicklertoken 1: abcdefghijkl1234567890 hat Standardzugriff. Sie wurde mit den Projekt-IDs 1234567890, 5678912345 und 45678912345 verwendet.
  • Entwicklertoken 2: xyzabcdefghi6789012345 hat den Basiszugriff. Sie wurde mit den Projekt-IDs 1231235678 verwendet.
  • Entwicklertoken 3: asdfgflkjhjz7654321012 hat den Basiszugriff, wurde aber noch nie für einen API-Aufruf verwendet. Sie wurde vor Kurzem 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: 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:

Entwickler-Token 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 Grundlegender Zugriff Das Entwicklertoken und die Projekt-ID sind miteinander verknüpft.
asdfgflkjhjz7654321012 -- -- Der API-Zugriff des Entwicklertokens wurde auf kein Projekt übertragen, da es nie für einen API-Aufruf verwendet wurde.
qwertypoiuyu6543298790 9876564900 Zugriff testen Der API-Zugriff des Entwicklertokens wurde aufgrund von Inaktivität in den letzten 90 Tagen widerrufen. Die API-Zugriffsebene des Projekts ist standardmäßig auf „Testzugriff“ festgelegt.
-- 7171234567 Zugriff testen Dies ist ein neues Projekt, das noch nicht mit einem Entwicklertoken verwendet wurde. Die API-Zugriffsebene des Projekts ist standardmäßig auf „Testzugriff“ festgelegt.

Ich habe mehrere genehmigte Entwicklertokens. Für welches Projekt möchten Sie API-Zugriffsebenen übertragen?

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

Ich verwende mehrere Google Cloud-Projekte. Für welches Projekt möchten Sie 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

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

Wenn der Google Ads API-Zugriff einem Google Cloud-Projekt zugewiesen ist, das Sie nicht mehr verwenden, müssen Sie nichts weiter tun. Google entzieht den API-Zugriff für das ungenutzte Projekt nach 90 Tagen Inaktivität.

Meinem Google Cloud-Projekt wurden keine API-Zugriffsebenen zugewiesen. Wie behebe ich das Problem?

Ihr Google Cloud-Projekt hat die Zugriffsebene Ihres Entwicklertokens nicht übernommen. Das liegt wahrscheinlich daran, dass Sie Ihr Entwicklertoken und das Cloud-Projekt noch nie für einen API-Aufruf verwendet haben oder der API-Zugriff Ihres Entwicklertokens vor Kurzem aufgrund von Inaktivität abgelaufen ist. Um das Problem zu beheben, müssen Sie auf der Übersichtsseite zur Google Ads API den entsprechenden API-Zugriffslevel für dieses Projekt beantragen. Beispiel ansehen

Wo kann ich die API-Zugriffsebenen meines Projekts sehen?

Das API-Zugriffsniveau Ihres Google Cloud-Projekts finden Sie auf der Übersichtsseite zur Google Ads API.

Wie beantrage ich höhere API-Zugriffsebenen?

Sie können auf der Übersichtsseite 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 über das API Center Ihres Google Ads-Verwaltungskontos gestellt haben, werden geschlossen. Sie sollten den Basiszugriff über die Übersichtsseite zur Google Ads API Ihres Google Cloud-Projekts noch einmal 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 bis zum 9. September 2026 über das API Center Ihres Google Ads-Verwaltungskontos gestellt haben, werden wie gewohnt geprüft. Wenn Ihr Antrag genehmigt wird, erhält das mit Ihrem Entwicklertoken verknüpfte Google Cloud-Projekt Standardzugriff.

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

Bisher hat das Google Ads API-Team die erneute Verknüpfung eines Entwicklertokens mit einem neuen Google Cloud-Projekt von Fall zu Fall unterstützt. Diese Funktion wird seit dem 9. September 2026 nicht mehr unterstützt, da Entwicklertokens eingestellt wurden. Wenn Sie ein neues Google Cloud-Projekt verwenden müssen, sollten Sie den entsprechenden API-Zugriff über die Übersichtsseite zur Google Ads API Ihres Google Cloud-Projekts beantragen.

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

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

  1. Ihr Entwicklertokenzugriff kann aufgrund von Inaktivität widerrufen werden:Gemäß den Google-Richtlinien kann Google Ihr API-Token widerrufen, wenn es 90 Tage lang nicht verwendet wird. Wenn Sie Ihr Entwicklertoken längere Zeit nicht verwendet haben, wurden die Zugriffsebenen wahrscheinlich aufgrund von Inaktivität widerrufen. Wenn dies der Fall ist, beantragen Sie den API-Zugriff für Ihr Google Cloud-Projekt noch einmal über die Übersichtsseite zur Google Ads API. Beispiel ansehen

  2. Ihr Entwicklertoken wurde vor Kurzem genehmigt, Sie haben es aber 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. Wenn Sie versuchen, mit diesem Entwicklertoken einen API-Aufruf an ein Produktionskonto zu senden, wird der Fehler CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION ausgegeben. Um den Fehler zu beheben, beantragen Sie den entsprechenden API-Zugriff über die Übersichtsseite zur Google Ads API Ihres Google Cloud-Projekts. Beispiel ansehen

In beiden Fällen können Sie den Explorer-Zugriff und die Zugriffsebene „Basic“ beantragen und automatisch überprüfen lassen. Sie müssen nicht mehr mit dem Compliance-Team von Google zusammenarbeiten, um den Überprüfungsprozess 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 den Standardzugriff beantragen, damit das Compliance-Team Ihren neuen Antrag auf Standardzugriff entsprechend prüfen kann.

Kann ich das Senden von Entwicklertokens als Teil meiner API-Anfragen beenden?

Ja, Sie können das Senden von Entwicklertokens als Teil Ihrer API-Anfragen beenden. Wenn Sie eine Clientbibliothek verwenden, müssen Sie möglicherweise auf die neueste Version aktualisieren. Prüfen Sie in den Änderungsprotokollen der Bibliothek, ob API-Aufrufe ohne Angabe eines Entwicklertokens unterstützt werden.

Ich habe am Pilotprogramm für die Cloud-Zugriffsebene „Verwaltet“ teilgenommen. Inwiefern bin ich betroffen?

Das Pilotprogramm für die von der Cloud verwaltete Zugriffsebene wurde eingeführt, damit Google Cloud-Entwickler API-Aufrufe ausführen können, ohne ein Entwicklertoken als Teil der API-Anfrage zu senden. Da wir Entwicklertokens eingestellt haben, wird dieses Programm nicht mehr fortgeführt.

Die Zugriffsebenen Ihres aktiven Entwicklertokens wurden auf Ihr Google Cloud-Projekt übertragen. Ihr vorhandener Code sollte also ohne Änderungen weiterhin funktionieren. Wenn Sie ein neues Google Cloud-Projekt verwenden müssen, sollten Sie den API-Zugriff über die Übersichtsseite zur Google Ads API Ihres Google Cloud-Projekts beantragen.

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

Google führt möglicherweise Pilotprogramme durch, in denen einige Entwickler Zugriff auf experimentelle Funktionen erhalten. Der Zugriff auf diese Funktionen wird manchmal durch Hinzufügen Ihres Entwicklertokens zu einer Zulassungsliste ermöglicht. Wenn Sie an einem solchen Pilotprogramm teilgenommen haben, müssen Sie nichts weiter tun.

Wir haben alle Pilotprogramme so aktualisiert, dass Google Cloud-Projekte anstelle von Entwicklertokens als Zulassungslistenmechanismus verwendet werden. Außerdem haben wir den Zulassungslistenstatus des Entwicklertokens auf die zugehörigen Google Cloud-Projekte übertragen. Ihr vorhandener Code sollte ohne Änderungen weiterhin funktionieren. Sollten 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. Wenn Sie versuchen, einen API-Aufruf mit diesem Entwicklertoken zu starten, wird ein CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION-Fehler ausgegeben, da Entwicklertokens nicht mehr verwendet werden, um Ihre API-Zugriffsebenen zu bestimmen. Um den Fehler zu beheben, beantragen Sie den entsprechenden API-Zugriff über die Übersichtsseite zur Google Ads API Ihres Google Cloud-Projekts. Beispiel ansehen

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

Nein, in diesem Fall müssen Sie das Entwicklertoken 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.

Was passiert mit dem API Center?

Die vorhandene Seite „API Center“ im Google Ads-Verwaltungskonto ist veraltet und wird in naher Zukunft entfernt. Wenn Sie bereits ein Entwickler-Token haben, können Sie sich weiterhin in Ihrem Google Ads-Verwaltungskonto anmelden und die Details aufrufen. Diese Informationen dienen jedoch nur zu Referenzzwecken. 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 über die Übersichtsseite zur 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. Sie benötigen ein Verwaltungskonto nur, wenn Sie mehrere Konten über die 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 Startleitfaden, um sich für die Google Ads API zu registrieren. Melden Sie sich nicht über das API Center Ihres Google Ads-Verwaltungskontos für ein Entwickler-Token an. Diese Anträge werden nicht bearbeitet. Das API Center wird in naher Zukunft eingestellt.

Weiter
Zugriffsebenen und zulässige Nutzung