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 und die Anzahl der Vorgänge und Anfragen, die täglich ausgeführt werden können, beeinflussen können. Anhand der zulässigen Nutzung werden die spezifischen Google Ads API-Funktionen bestimmt, für die das Entwicklertoken verwendet werden darf.

Zugriffsebenen

Es gibt drei verschiedene Zugriffsebenen, die in der Tabelle nach Umfang aufgelistet sind. Falls Sie noch keinen Zugriff auf die Google Ads API haben, registrieren Sie sich, um Zugriff auf das 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 Anwenden
Testkontozugriff Testkonten 15.000 Vorgänge / Tag Anleitung
Basiszugriff Test- und Produktionskonten 15.000 Vorgänge / Tag Anleitung
Standardzugriff Test- und Produktionskonten Unbegrenzte Vorgänge pro Tag Anleitung

1 „Pro Tag“ basiert auf einem fließenden 24-Stunden-Zeitraum, in dem API-Anfragen mit Ihrem Entwicklertoken gestellt wurden. Ihre Anwendung erhält eine Fehlermeldung, wenn sie das Anfragelimit für Ihre Zugriffsebene innerhalb der letzten 24 Stunden überschritten hat.

Testkontozugriff

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

Testkontozugriff beantragen

Schließen Sie die Google Ads API-Registrierung in der Google Ads-Weboberfläche ab, damit automatisch die Zugriffsebene für das Testkonto gewährt wird.

Basiszugriff

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

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

Basiszugriff beantragen

Wenn Sie derzeit ein Entwickler-Token für Testkonto-Zugriffsebene haben und den Zugriff auf das Produktionskonto beantragen möchten, füllen Sie dieses Formular zum Beantragen des Basiszugriffs aus. Führen Sie die folgenden Schritte aus:

  1. Prüfen Sie, ob Sie bereits ein Entwicklertoken mit Zugriffsebene für das Testkonto haben.
  2. Prüfen Sie, ob die Kontakt-E-Mail-Adresse für die API im API-Center auf dem neuesten Stand ist. Sie können den Bewerbungsprozess ohne gültige, regelmäßig überprüfte E-Mail-Adresse nicht abschließen. Alle aktiven Google Ads-Konten müssen mit dem Verwaltungskonto verknüpft werden, in dem sich das API-Token befindet.

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 mit vielen Nutzern.

Unabhängig von der Zugriffsebene unterliegen alle API-Vorgänge den Ratenbegrenzungen des Systems. Weitere Informationen zum Umgang mit Ratenbegrenzungsfehlern 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 es sich um ein externes Tool handelt, müssen Sie einen Demo-Anmeldezugriff für das Tool gewähren. Hinweis: Ihr Tool muss über die erforderlichen Mindestfunktionen verfügen.

Zulässige Nutzung

Die zulässige Nutzung gilt nur für Zugriffstokens mit Basiszugriff und Standardzugriff. Die zulässige Nutzung wird basierend auf dem vorgesehenen Einsatz der Google Ads API zugewiesen. Diese Berechtigungen bestimmen, für welche API-Funktionen ein Token verwendet werden kann, wie in der folgenden Tabelle erläutert:

Zulässige Nutzung Beschreibung
Anzeigen erstellen und verwalten Gewähren Sie Zugriff auf alle Dienste der API zum Erstellen und Verwalten von Google Ads-Kampagnen, -Anzeigengruppen, -Anzeigen und -Keywords.
Berichterstellung Senden Sie nur GoogleAdsService.Search- oder GoogleAdsService.SearchStream-Anfragen oder schreibgeschützte Aufrufe. Dies ist für Entwickler gedacht, die Statistiken ausschließlich über die API anfordern.
Keywords und Empfehlungen recherchieren Gewähren Sie dem Token Zugriff auf RecommendationService, KeywordPlanIdeaService und KeywordPlanService. Dieser wird nur für Tools verwendet, für die Vorschläge erforderlich sind, um die Erstellung und Verwaltung von Google Ads-Kampagnen zu erleichtern.

Zulässige Nutzung ändern

Wenn Ihnen die Basis- oder Standardzugriffsebene gewährt wurde, können Sie den Antrag zum Aktualisieren der zulässigen Nutzung ausfüllen. Füllen Sie den Antrag aus, wenn Sie die zulässige Nutzung aktualisieren oder Ihren Clients Zugriff auf das Tool gewähren möchten.