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 beeinflussen können, und die Anzahl der Vorgänge und Anfragen, die Sie täglich ausführen können. Unter Zulässige Verwendung werden die Google Ads API-Funktionen angegeben, 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, melden Sie sich an, 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 den Betrieb1 Ü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“ bezieht sich auf einen gleitenden Zeitraum von 24 Stunden, in dem API-Anfragen mit Ihrem Entwicklertoken gesendet wurden. Ihre Anwendung erhält eine Fehlermeldung, wenn sie innerhalb der letzten 24 Stunden das Anfragelimit für Ihre Zugriffsebene überschreitet.

Testkontozugriff

Nach der Erstregistrierung für die Google Ads API erhalten Sie ein Entwickler-Token mit der Zugriffsebene für Testkonten. Das bedeutet, dass über das Entwickler-Token nur Google Ads API-Anfragen an Testkonten gesendet werden können.

Testkontozugriff beantragen

Melden Sie sich in der Google Ads-Weboberfläche für die Google Ads API an, um automatisch die Zugriffsebene für das Testkonto zu erhalten.

Basiszugriff

Mit dem Basiszugriff können über das Entwickler-Token Google Ads API-Anfragen an Test- und Produktionskonten gestellt werden. Produktionskonten sind Konten, über die echte, aktive Google-Anzeigen ausgeliefert werden. In Testkonten werden keine Anzeigen ausgeliefert.

Mit der grundlegenden Zugriffsebene kann das Entwicklertoken bis zu 15.000 Vorgänge pro Tag ausführen. Das ist für die meisten Entwickler ausreichend.

Basiszugriff beantragen

Wenn Sie ein Entwicklertoken für die Zugriffsebene „Testkonto“ haben und den Zugriff auf ein Produktionskonto beantragen möchten, füllen Sie dieses Antragsformular für den Basiszugriff aus. Führen Sie die folgenden Schritte aus:

  1. Sie benötigen bereits ein Entwicklertoken mit der Zugriffsebene „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 aufzurufen. Ohne gültige, regelmäßig geprüfte E-Mail-Adresse können Sie den Bewerbungsprozess nicht abschließen. Prüfen Sie, ob Sie alle aktiven Google Ads-Konten mit dem Verwaltungskonto mit dem API-Token verknüpft haben.

Standardzugriff

Mit dem Standardzugriff 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 den Standardzugriff finden Sie unter API-Kontingente.

Die Standardzugriffsebene wird nur Entwicklern gewährt, die unbegrenzte Google Ads API-Vorgänge benötigen, z. B. große Unternehmen oder Tools, die vielen Nutzern dienen.

Unabhängig von der Zugriffsebene unterliegen alle API-Vorgänge den Systemgrenzwerten für die Rate. Weitere Informationen zum Umgang mit Fehlern aufgrund von Ratenbegrenzungen finden Sie unter Fehlertypen.

Standardzugriff beantragen

Wenn Sie derzeit eine Basiszugriffsebene haben und unbegrenzte Google Ads API-Vorgänge beantragen möchten, füllen Sie dieses Formular zum Beantragen des Standardzugriffs aus.

Wenn Ihr Tool extern ist, müssen Sie einen Demo-Anmeldezugriff 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 Tokens mit grundlegendem und Standardzugriff. Die zulässige Nutzung richtet sich nach der beabsichtigten Verwendung der Google Ads API. Diese Berechtigungen bestimmen, für welche Funktionen der API ein Token verwendet werden kann, wie in der folgenden Tabelle erläutert:

Zulässige Nutzung Beschreibung
Anzeigen erstellen und verwalten Zugriff auf alle Dienste der API gewähren, um Google Ads-Kampagnen, -Anzeigengruppen, -Anzeigen und -Keywords zu erstellen und zu verwalten.
Berichte Führe nur GoogleAdsService.Search- oder GoogleAdsService.SearchStream-Anfragen oder schreibgeschützte Aufrufe aus. Diese Option ist für Entwickler gedacht, die die API nur zum Abrufen von Statistiken verwenden.
Keywords und Empfehlungen recherchieren Gewähren Sie dem Token Zugriff auf RecommendationService, KeywordPlanIdeaService und KeywordPlanService. Diese Funktion wird nur von Tools verwendet, die Vorschläge zum Erstellen und Verwalten von Google Ads-Kampagnen benötigen.

Zulässige Nutzung ändern

Wenn Sie die Genehmigung für die Ebene „Grundlegender Zugriff“ oder „Standardzugriff“ erhalten haben, 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.