Zugriffsebenen und zulässige Nutzung

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

Zugriffsebenen

Es gibt drei verschiedene Zugriffsebenen, die in der Tabelle nach Umfang aufgelistet sind. Wenn Sie noch keinen Zugriff auf die Google Ads API haben, können Sie sich registrieren, um Zugriff auf ein Testkonto zu erhalten. Sie können die Zugriffsebene erhöhen, indem Sie einige zusätzliche Schritte in der Anwendung ausführen.

Zugriffsebene Hat Zugriff auf Tageslimit für Vorgänge1 Übernehmen
Testkontozugriff Testkonten 15.000 Vorgänge pro Tag Anleitung
Basiszugriff Test- und Produktionskonten 15.000 Vorgänge pro Tag Anleitung
Standardzugriff Test- und Produktionskonten Unbegrenzte Vorgänge pro Tag Anleitung

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

Testkontozugriff

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.

Testkontozugriff beantragen

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

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.

Basiszugriff beantragen

Wenn Sie ein Entwicklertoken mit der Zugriffsebene „Zugriff auf das Testkonto“ haben und den Zugriff auf das Produktionskonto beantragen möchten, füllen Sie das Antragsformular für den 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 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 Sie alle Ihre aktiven Google Ads-Konten mit dem Verwaltungskonto mit dem API-Token verknüpft haben.

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.

Unabhängig von der Zugriffsebene unterliegen alle API-Vorgänge Systemratenbeschränkungen. Weitere Informationen zum Beheben von Fehlern aufgrund von Ratenbegrenzungen finden Sie unter Fehlertypen.

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 „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.

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 Nutzung Beschreibung
Anzeigen erstellen und verwalten Bietet Zugriff auf alle Dienste der API zum Erstellen und Verwalten von Google Ads-Kampagnen, Anzeigengruppen, Anzeigen und Keywords.
Berichte Führen Sie nur GoogleAdsService.Search- oder GoogleAdsService.SearchStream-Anfragen oder schreibgeschützte Aufrufe aus. Dies gilt für Entwickler, die die API nur zum Anfordern von Statistiken verwenden.
Keywords und Empfehlungen recherchieren Gewähren Sie dem Token Zugriff auf RecommendationService, KeywordPlanIdeaService und KeywordPlanService. Diese Informationen werden nur von Tools verwendet, die Vorschläge benötigen, um das Erstellen und Verwalten von Google Ads-Kampagnen zu erleichtern.

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.