Zugriffsebenen und zulässige Nutzung

Jedem Google Ads API-Entwicklertoken wird eine Zugriffsebene und eine „zulässige Verwendung“ zugewiesen. Die Zugriffsebene bestimmt, ob Sie Produktionskonten beeinflussen können und wie viele Vorgänge und Anfragen Sie täglich ausführen können. Die zulässige Verwendung bestimmt die spezifischen Google Ads API-Funktionen, die mit dem Entwicklertoken verwendet werden dürfen.

Zugriffsebenen

In der Tabelle sind vier verschiedene Zugriffsebenen für Entwicklertokens aufgeführt. Wenn Sie noch keinen Zugriff auf die Google Ads API haben, können Sie sich registrieren, um ein Entwicklertoken mit der Zugriffsebene „Testkonto“ zu erhalten. Sie können die Zugriffsebene erhöhen, indem Sie einige zusätzliche Schritte in der Anwendung ausführen.

¹ „Pro Tag“ basiert auf einem gleitenden 24-Stunden-Zeitraum, in dem API-Anfragen mit Ihrem Entwicklertoken gestellt wurden. Ihre Anwendung erhält eine Fehlermeldung, wenn sie das Anfragekontingent für Ihre Zugriffsebene in den letzten 24 Stunden überschreitet.

Zugriffsebene des Testkontos

Nachdem Sie die Erstanmeldung für die Google Ads API abgeschlossen haben, erhalten Sie ein Entwickler-Token mit der Zugriffsebene „Zugriff auf das Testkonto“. Das bedeutet, dass über das Entwickler-Token nur Google Ads API-Anfragen an Testkonten gesendet werden können.

Zugriffsebene „Testkonto“ beantragen

Führen Sie die Google Ads API-Registrierung in der Google Ads-Weboberfläche durch, um automatisch die Zugriffsebene „Testkonto“ zu erhalten.

Zugriffsebene „Explorer“

Nachdem Sie die Erstanmeldung für die Google Ads API abgeschlossen haben, kann Google Ihr Entwicklertoken in einigen Fällen automatisch vom Zugriff auf das Testkonto auf die Zugriffsebene „Explorer“ upgraden. Mit der Zugriffsebene „Explorer“ können mit dem Entwicklertoken Google Ads API-Anfragen sowohl für Testkonten als auch für Produktionskonten gestellt werden. Produktionskonten sind alle Konten, in denen echte Google-Anzeigen ausgeliefert werden. In Testkonten werden keine Anzeigen ausgeliefert.

Mit der Zugriffsebene „Explorer“ können mit dem Entwicklertoken bis zu 2.880 Vorgänge pro Tag für Produktionskonten ausgeführt werden. Das reicht für die meisten Entwickler aus, um mit der API zu beginnen und grundlegende Automatisierungen zu erstellen.

Mit der Zugriffsebene „Explorer“ wird der Zugriff auf die folgenden Funktionen eingeschränkt. Wenn Sie diese Funktionen nutzen möchten, müssen Sie die Zugriffsebene „Basic“ oder die Zugriffsebene „Standard“ beantragen.

Zugriffsebene „Explorer“ beantragen

Registrieren Sie sich für die Google Ads API über die Google Ads-Weboberfläche. In einigen Fällen führt Google nach Abschluss der Registrierung automatisch ein Upgrade Ihres Entwicklertokens auf die Zugriffsebene „Explorer“ durch.

Zugriffsebene „Basiszugriff“

Mit der Zugriffsebene „Basiszugriff“ können mit dem Entwicklertoken Google Ads API-Anfragen für Testkonten und Produktionskonten gestellt werden. Produktionskonten sind alle Konten, in denen echte Google-Anzeigen ausgeliefert werden. In Testkonten werden keine Anzeigen ausgeliefert.

Mit der Zugriffsebene „Basic Access“ können mit dem Entwicklertoken bis zu 15.000 Vorgänge pro Tag ausgeführt werden. Das ist für die meisten Entwickler ausreichend.

Grundlegende Zugriffsebene beantragen

Wenn Sie ein Entwicklertoken mit der Zugriffsebene „Zugriff auf das Testkonto“ haben und Zugriff auf Produktionskonten beantragen möchten, füllen Sie das Antragsformular für die Zugriffsebene „Basiszugriff“ aus. So bereiten Sie sich vor:

1. Sie benötigen ein Entwicklertoken mit Zugriff auf das Testkonto.
2. Die E-Mail-Adresse des API-Kontakts im API-Center muss aktuell sein. Sie müssen in Ihrem Google Ads-Verwaltungskonto angemeldet sein, um das API-Center aufrufen zu können. Ohne eine gültige, regelmäßig überprüfte E‑Mail-Adresse können Sie den Antrag nicht abschließen. Achten Sie darauf, dass alle Ihre aktiven Google Ads-Konten mit dem Google Ads-Verwaltungskonto mit dem API-Token verknüpft sind.

Ebene „Standardzugriff“

Mit der Zugriffsebene „Standard“ kann das Entwicklertoken für die meisten Dienste eine unbegrenzte Anzahl von Vorgängen pro Tag ausführen. Dazu gehören unter anderem GoogleAdsService Search und SearchStream. Weitere Informationen zu Limits und Ausnahmen für die Zugriffsebene „Standard“ finden Sie unter API-Kontingente.

Die Zugriffsebene „Standardzugriff“ wird nur Entwicklern gewährt, die unbegrenzte Google Ads API-Vorgänge benötigen, z. B. große Unternehmen oder Tools, die von vielen Nutzern verwendet werden.

Standardzugriff beantragen

Wenn Sie ein Entwicklertoken mit der Zugriffsebene „Basic Access“ haben und unbegrenzte Google Ads API-Vorgänge beantragen möchten, füllen Sie das Antragsformular für die Zugriffsebene „Standard Access“ aus.

Wenn Ihr Tool extern ist, müssen Sie Demo-Anmeldedaten für den Zugriff auf Ihr Tool bereitstellen. Hinweis: Ihr Tool muss über die erforderlichen Mindestfunktionen verfügen.

API-Kontingente und Systemratenlimits

Unabhängig von der Zugriffsebene unterliegen alle API-Vorgänge Systemratenlimits, die die Anzahl der Vorgänge begrenzen, die Sie in einem bestimmten Zeitraum ausführen dürfen, d. h. die Anzahl der Vorgänge pro Stunde. Weitere Informationen zum Beheben von Fehlern bei Ratenlimits finden Sie unter Fehlertypen.

Für einzelne Dienste können zusätzliche Limits und Kontingentbeschränkungen gelten, z. B. aufgrund von Einschränkungen des Produktdesigns, Einschränkungen der Produktrichtlinien oder Überlegungen zur API-Leistung und ‑Latenz. Weitere Informationen zu diesen Einschränkungen finden Sie in der Dokumentation zu API-Kontingenten.

Zulässige Nutzung

Die zulässige Verwendung gilt nur für Entwicklertokens mit den Zugriffsebenen „Basiszugriff“ und „Standardzugriff“. Die zulässige Nutzung wird basierend auf der beabsichtigten Verwendung der Google Ads API zugewiesen. Diese Berechtigungen legen fest, für welche Funktionen der API ein Entwicklertoken verwendet werden kann. Weitere Informationen finden Sie in der folgenden Tabelle:

Zulässige Verwendung ändern

Wenn Ihr Entwicklertoken für die Zugriffsebene „Basiszugriff“ oder „Standardzugriff“ genehmigt wurde, können Sie den Antrag auf Aktualisierung der zulässigen Nutzung ausfüllen. Füllen Sie den Antrag aus, wenn Sie die zulässige Nutzung aktualisieren oder Ihren Kunden Zugriff auf Ihr Tool gewähren möchten.