Am 20. August um 16:00 Uhr können Sie live auf dem Server der Google Advertising and Measurement Community auf Discord und auf YouTube dabei sein. Wir sprechen über die neuen Funktionen, die in Version 25.1 der Google Ads API hinzugefügt wurden.

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Zugriffsebenen und zulässige Nutzung

Ihrem Google Cloud-Projekt 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 das Projekt verwenden darf.

Zugriffsebenen

In der Tabelle sind vier verschiedene API-Zugriffsebenen in der Reihenfolge aufgeführt. Wenn Sie noch keinen Google Ads API-Zugriff haben, können Sie die API aktivieren, um die Zugriffsebene „Testkonto“ für Ihr Google Cloud-Projekt 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 „Testkonto“	Testkonten	15.000 Vorgänge pro Tag	Zugriffsebene „Testkonto“ beantragen
Zugriffsebene „Explorer“	Test- und Produktionskonten	2.880 Vorgänge pro Tag für Produktionskonten 15.000 Vorgänge pro Tag für Testkonten	Zugriffsebene „Explorer“ beantragen
Zugriffsebene „Grundlegend“	Test- und Produktionskonten	15.000 Vorgänge pro Tag für Test- und Produktionskonten	Zugriffsebene „Grundlegend“ beantragen
Zugriffsebene „Standard“	Test- und Produktionskonten	Unbegrenzte Vorgänge pro Tag für Test- und Produktionskonten	Zugriffsebene „Standard“ beantragen	10 Werktage

¹ „Pro Tag“ basiert auf einem gleitenden 24-Stunden-Zeitraum, in dem API Anfragen mit Ihrem Google Cloud-Projekt 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 „Testkonto“

Nachdem Sie die Google Ads API aktiviert haben, erhält Ihr Google Cloud-Projekt die Zugriffsebene „Testkonto“. Das bedeutet, dass das Projekt nur Google Ads API-Anfragen für Testkonten stellen kann.

Zugriffsebene „Testkonto“ beantragen

Aktivieren Sie die Google Ads API in Ihrem Google Cloud-Projekt, um automatisch die Zugriffsebene „Testkonto“ für Ihr Projekt zu erhalten.

Zugriffsebene „Explorer“

Nachdem Sie die erste Registrierung für die Google Ads API abgeschlossen haben, können Sie möglicherweise die Zugriffsebene „Explorer“ beantragen.

Mit der Zugriffsebene „Explorer“ kann Ihr Google Cloud-Projekt Google Ads API-Anfragen für Test- und Produktionskonten stellen. Produktionskonten sind alle Konten, über die echte Google-Anzeigen ausgeliefert werden. Über Testkonten werden keine Anzeigen ausgeliefert.

Mit der Zugriffsebene „Explorer“ kann Ihr Google Cloud-Projekt 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“ beschränkt den Zugriff auf die folgenden Funktionen. Wenn Sie diese Funktionen verwenden möchten, müssen Sie die Zugriffsebene „Grundlegend“ oder „Standard“ beantragen.

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

Zugriffsebene „Explorer“ beantragen

Rufen Sie in Ihrem Google Cloud project die Seite „Übersicht der Google Ads API“ auf.
Prüfen Sie, ob auf der Seite Ihre aktuelle Zugriffsebene als Test angezeigt wird.
Klicken Sie, um den Abschnitt Zugriffsebene aktualisieren zu maximieren.
Prüfen Sie, ob die nächste Zugriffsebene als Explorer angezeigt wird.
Klicken Sie auf die Schaltfläche Zugriff beantragen , um die Zugriffsebene „Explorer“ zu beantragen.

Google aktualisiert die API-Zugriffsebene Ihres Projekts möglicherweise automatisch auf „Explorer“, nachdem Sie Ihren Antrag eingereicht haben.

Zugriffsebene „Grundlegend“

Mit der Zugriffsebene „Grundlegend“ kann Ihr Google Cloud-Projekt Google Ads API-Anfragen für Test- und Produktionskonten stellen. Produktionskonten sind alle Konten, über die echte Google-Anzeigen ausgeliefert werden. Über Testkonten werden keine Anzeigen ausgeliefert.

Mit der Zugriffsebene „Grundlegend“ kann Ihr Google Cloud-Projekt bis zu 15.000 Vorgänge pro Tag ausführen. Das reicht für die meisten Entwickler aus.

Zugriffsebene „Grundlegend“ beantragen

Rufen Sie in Ihrem Google Cloud project die Seite „Übersicht der Google Ads API“ auf.
Prüfen Sie, ob auf der Seite Ihre aktuelle Zugriffsebene als Explorer angezeigt wird.
Klicken Sie, um den Abschnitt Zugriffsebene aktualisieren zu maximieren.
Prüfen Sie, ob die nächste Zugriffsebene als Grundlegend angezeigt wird.
Prüfen Sie, ob keine Warnungen angezeigt werden, die darauf hinweisen, dass Sie die Markenüberprüfung für Ihr Projekt noch nicht abgeschlossen haben. Wenn Warnungen angezeigt werden, folgen Sie der Anleitung um die Markenüberprüfung abzuschließen, bevor Sie fortfahren.
Klicken Sie auf die Schaltfläche Zugriff beantragen , um die Zugriffsebene „Grundlegend“ zu beantragen.

Google aktualisiert die API-Zugriffsebene Ihres Projekts möglicherweise automatisch auf „Grundlegend“, nachdem Sie Ihren Antrag eingereicht haben.

Standardzugriffsebene

Mit der Zugriffsebene „Standard“ kann Ihr Google Cloud-Projekt eine unbegrenzte Anzahl von Vorgängen pro Tag für alle Dienste ausführen. Für einzelne Dienste und Funktionen gelten möglicherweise weiterhin Ratenlimits und Einschränkungen, die spezifisch für diese Funktionen sind. Diese gelten auch dann, wenn Ihr Projekt die Zugriffsebene „Standard“ hat.

Die Zugriffsebene „Standard“ 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.

Standardzugriff beantragen

Rufen Sie in Ihrem Google Cloud project die Seite „Übersicht der Google Ads API“ auf.
Prüfen Sie, ob auf der Seite Ihre aktuelle Zugriffsebene als Grundlegend angezeigt wird.
Klicken Sie, um den Abschnitt Zugriffsebene aktualisieren zu maximieren.
Prüfen Sie, ob die nächste Zugriffsebene als Standard angezeigt wird.
Klicken Sie auf die Schaltfläche Antrag starten , um den Antrag für die Zugriffsebene „Standard“ zu starten.

Der Antrag für die Zugriffsebene „Standard“ umfasst eine detaillierte manuelle Überprüfung Ihrer Anwendung. Sie müssen Fragen zur Funktionalität Ihres Tools und zur Zielgruppe beantworten können. Wenn Ihr Tool von externen Nutzern verwendet wird, müssen Sie einen Demo-Anmeldezugriff für Ihr Tool bereitstellen. Ihr Tool muss die erforderliche Mindestfunktionalität erfüllen.

Während des Überprüfungsprozesses kommuniziert das Google-Compliance-Team mit Ihnen über Ihre E-Mail-Adresse. Antworten Sie umgehend auf die Anfragen des Compliance-Teams, um mit Ihrem Antrag für die Zugriffsebene „Standard“ voranzukommen. Sobald die Überprüfung abgeschlossen ist, erhalten Sie von Google eine E‑Mail mit dem Endergebnis des Überprüfungsprozesses.

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 gelten möglicherweise zusätzliche Limits und Kontingentbeschränkungen, z. B. aufgrund von Einschränkungen des Produktdesigns, Einschränkungen der Produktrichtlinien, Ü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 Google Cloud-Projekte mit der Zugriffsebene „Standard“. Die zulässige Nutzung wird basierend auf der beabsichtigten Verwendung der Google Ads API zugewiesen. Diese Berechtigungen bestimmen, welche Funktionen der API Ihr Tool verwenden kann. Weitere Informationen finden Sie in der folgenden Tabelle:

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. Dies ist für Entwickler gedacht, die die API nur zum Anfordern von Statistiken verwenden.
Keywords und Empfehlungen recherchieren	Dem Google Cloud-Projekt Zugriff auf `RecommendationService`, `KeywordPlanIdeaService` und `KeywordPlanService` gewähren. Dies 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 Google Cloud-Projekt für die Zugriffsebene „Standard“ 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.