Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Zugriffsebenen und zulässige Nutzung

Jedem Google Ads API-Entwicklertoken wird eine Zugriffsebene und eine „zulässige Nutzung“ 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 Nutzung 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 in der Reihenfolge aufgeführt. Wenn Sie noch keinen Zugriff auf die Google Ads API haben, können Sie sich zuerst registrieren, um ein Entwicklertoken mit der Zugriffsebene „Test kontozugriff“ zu erhalten. Sie können die Zugriffsebene erhöhen, indem Sie einige zusätzliche Schritte in der Anwendung ausführen.

Zugriffsebene	Hat Zugriff auf	Tägliches Limit für Vorgänge¹	So stellst du den Antrag	Wie lange dauert die Überprüfung in der Regel?
Zugriffsebene „Testkontozugriff“	Testkonten	15.000 Vorgänge pro Tag	Anleitung
Zugriffsebene „Explorer-Zugriff“	Test- und Produktionskonten	2.880 Vorgänge pro Tag für Produktionskonten 15.000 Vorgänge pro Tag für Testkonten	Anleitung
Zugriffsebene „Basiszugriff“	Test- und Produktionskonten	15.000 Vorgänge pro Tag für Test- und Produktionskonten	Anleitung	5 Werktage
Zugriffsebene „Standardzugriff“	Test- und Produktionskonten	Unbegrenzte Anzahl von Vorgängen pro Tag für Test- und Produktionskonten	Anleitung	10 Werktage

¹ „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 Limit für Anfragen für Ihre Zugriffsebene in den letzten 24 Stunden überschreitet.

Zugriffsebene „Testkontozugriff“

Nachdem Sie die erste Registrierung für die Google Ads API abgeschlossen haben, erhalten Sie ein Entwicklertoken mit der Zugriffsebene „Testkontozugriff“. Das bedeutet, dass über das Entwicklertoken nur Google Ads API-Anfragen an Testkonten gesendet werden können.

Zugriffsebene „Testkontozugriff“ beantragen

Schließen Sie die Registrierung für die Google Ads API über die Google Ads-Weboberfläche ab, um automatisch die Zugriffsebene „Testkontozugriff“ zu erhalten.

Zugriffsebene „Explorer-Zugriff“

Nachdem Sie die erste Registrierung für die Google Ads API abgeschlossen haben, kann Google Ihr Entwicklertoken in einigen Fällen automatisch von der Zugriffsebene Testkontozugriff auf „Explorer-Zugriff“ aktualisieren. Mit der Zugriffsebene „Explorer-Zugriff“ kann das Entwicklertoken Google Ads API-Anfragen sowohl an Testkonten als auch an Produktionskonten senden. Produktionskonten sind alle Konten, in denen echte Google-Anzeigen ausgeliefert werden. In Testkonten werden keine Anzeigen ausgeliefert.

Mit der Zugriffsebene „Explorer-Zugriff“ kann das Entwicklertoken bis zu 2.880 Vorgänge pro Tag für Produktionskonten ausführen. Das reicht für die meisten Entwickler aus, um mit der API zu beginnen und grundlegende Automatisierungen zu erstellen.

Die Zugriffsebene „Explorer-Zugriff“ beschränkt den Zugriff auf die folgenden Funktionen. Wenn Sie diese Funktionen verwenden möchten, müssen Sie die Zugriffsebene „Basiszugriff“ oder „Standardzugriff“ beantragen.

Eingeschränkte Funktionen	Eingeschränkte Dienste und Methoden
Kontoerstellung	`CustomerService.CreateCustomerClient`
Nutzerverwaltung	`CustomerUserAccessInvitationService` `CustomerUserAccessService`
Planung	`KeywordPlanService` `KeywordPlanIdeaService` `KeywordPlanCampaignService` `KeywordPlanCampaignKeywordService` `KeywordPlanAdGroupService` `KeywordPlanAdGroupKeywordService` `AudienceInsightsService` `KeywordPlanIdeaService` `ReachPlanService`
Abrechnung und Zahlung für Konten	`PaymentsAccountService` `BillingSetupService` `AccountBudgetProposalService` `InvoiceService`

Zugriffsebene „Explorer-Zugriff“ beantragen

Schließen Sie die Registrierung für die Google Ads API über die Google Ads-Weboberfläche ab. In einigen Fällen aktualisiert Google Ihr Entwicklertoken automatisch auf die Zugriffsebene „Explorer-Zugriff“, sobald Sie die Registrierung abgeschlossen haben.

Zugriffsebene „Basiszugriff“

Mit der Zugriffsebene „Basiszugriff“ kann das Entwicklertoken Google Ads API-Anfragen sowohl an Testkonten als auch an Produktionskonten senden. Produktionskonten sind alle Konten, in denen echte Google-Anzeigen ausgeliefert werden. In Testkonten werden keine Anzeigen ausgeliefert.

Mit der Zugriffsebene „Basiszugriff“ kann das Entwicklertoken bis zu 15.000 Vorgänge pro Tag ausführen. Das reicht für die meisten Entwickler aus.

Zugriffsebene „Basiszugriff“ beantragen

Wenn Sie ein Entwicklertoken mit der Zugriffsebene „Testkontozugriff“ oder „Explorer-Zugriff“ haben, können Sie die Zugriffsebene „Basiszugriff“ so beantragen:

Rufen Sie in Ihrem Webbrowser https://ads.google.com/aw/apicenter auf. Melden Sie sich bei Aufforderung in Ihrem Google Ads-Verwaltungskonto an.

Auf API Center zugreifen
Prüfen Sie, ob Ihre Zugriffsebene entweder Testkonto oder Explorer ist.
Achten Sie darauf, dass die E-Mail-Adresse für API-Kontakt im API Center auf dem neuesten Stand ist. Ohne eine gültige, regelmäßig überprüfte E-Mail-Adresse können Sie die Beantragung 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.
Klicken Sie auf den Drop-down-Pfeil neben der Zugriffsebene und dann auf den Link Basiszugriff beantragen.

Markenüberprüfung für Google Cloud-Projekte abschließen

Bei der Überprüfung der Anträge für die Zugriffsebene „Basiszugriff“ wird in der Google Ads API der Status der Markenüberprüfung von Google Cloud-Projekten verwendet, die mit einem Entwicklertoken verknüpft sind. Sie können die Markenüberprüfung in Ihrem Google Cloud-Projekt durchführen, um die Überprüfung Ihres Antrags für den Basiszugriff zu beschleunigen. In einigen Fällen werden Sie von Google möglicherweise auch aufgefordert, die Markenüberprüfung in Ihren Google Cloud-Projekten durchzuführen, bevor Ihr Antrag für den Basiszugriff bearbeitet werden kann. Weitere Informationen finden Sie im Leitfaden zur Markenüberprüfung.

Zugriffsebene „Standardzugriff“

Mit der Zugriffsebene „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 die Zugriffsebene „Standardzugriff“ finden Sie unter API Kontingente.

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

Zugriffsebene „Standardzugriff“ beantragen

Wenn Sie ein Entwicklertoken mit der Zugriffsebene „Basiszugriff“ haben, können Sie die Zugriffsebene „Standardzugriff“ so beantragen:

Rufen Sie in Ihrem Webbrowser https://ads.google.com/aw/apicenter auf. Melden Sie sich bei Aufforderung in Ihrem Google Ads-Verwaltungskonto an.

Auf API Center zugreifen
Prüfen Sie, ob Ihre Zugriffsebene Basiszugriff ist.
Achten Sie darauf, dass die E-Mail-Adresse für API-Kontakt im API Center auf dem neuesten Stand ist. Ohne eine gültige, regelmäßig überprüfte E-Mail-Adresse können Sie die Beantragung 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.
Klicken Sie auf den Drop-down-Pfeil neben der Zugriffsebene und dann auf den Link Standardzugriff beantragen.

Wenn Ihr Tool von externen Nutzern verwendet wird, müssen Sie einen Demo-Anmeldezugriff für Ihr Tool bereitstellen. Hinweis: Ihr Tool muss über die erforderlichen Mindest Funktionen 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 können, d. h. die Anzahl der Vorgänge pro Stunde. Weitere Informationen zum Beheben von Fehlern aufgrund von 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 Nutzung 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 bestimmen, für welche Funktionen der API ein Entwicklertoken verwendet werden kann, wie in der folgenden Tabelle erläutert:

Zulässige Nutzung	Beschreibung
Anzeigen erstellen und verwalten	Zugriff auf alle Dienste der API zum Erstellen und Verwalten von Google Ads-Kampagnen, ‑Anzeigengruppen, ‑Anzeigen und ‑Keywords.
Berichte	Nur `GoogleAdsService.Search` oder `GoogleAdsService.SearchStream` Anfragen oder Leseaufrufe stellen. Für Entwickler, die die API nur zum Anfordern von Statistiken verwenden.
Keywords und Empfehlungen recherchieren	Dem Entwicklertoken Zugriff auf `RecommendationService`, `KeywordPlanIdeaService`, und `KeywordPlanService` gewähren. Wird nur von Tools verwendet, die Vorschläge benötigen, um das Erstellen und Verwalten von Google Ads-Kampagnen zu erleichtern.

Zulässige Nutzung ändern

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