Seien Sie am 15. Oktober um 16:00 Uhr live auf dem Discord-Server der Google Advertising and Measurement Community und auf YouTube dabei. Wir sprechen über die neuen Funktionen in Version 26 der Google Ads API.

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 Änderungen an Produktionskonten vornehmen 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 Zugriff auf die Google Ads API haben, können Sie die API aktivieren, um die Zugriffsebene „Test“ 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?
Test	Testkonten	15.000 Vorgänge pro Tag	Zugriffsebene „Test“ beantragen
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
Einfach	Test- und Produktionskonten	15.000 Vorgänge pro Tag für Test- und Produktionskonten	Zugriffsebene „Einfach“ beantragen
Standard	Test- und Produktionskonten	Unbegrenzte Anzahl von Vorgängen pro Tag für Test- und Produktionskonten	Standardzugriff beantragen	10 Werktage

¹ „Pro Tag“ basiert auf einem gleitenden Zeitraum von 24 Stunden, 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 „Test“

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

Zugriffsebene „Test“ beantragen

Aktivieren Sie die Google Ads API in Ihrem Google Cloud-Projekt, um automatisch die Zugriffsebene „Test“ 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, in denen echte Google-Anzeigen ausgeliefert werden. In 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“ schränkt den Zugriff auf die folgenden Funktionen ein. Wenn Sie diese Funktionen verwenden möchten, müssen Sie die Zugriffsebene „Einfach“ 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 Projekt die Übersichtsseite der Google Ads API auf.
Prüfen Sie, ob auf der Seite Ihre aktuelle Zugriffsebene als Test angezeigt wird.
Maximieren Sie den Abschnitt Zugriffsebene erhöhen.
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 kann die API-Zugriffsebene Ihres Projekts nach dem Einreichen Ihres Antrags automatisch auf „Explorer“ erhöhen.

Zugriffsebene „Einfach“

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

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

Zugriffsebene „Einfach“ beantragen

Rufen Sie in Ihrem Google Cloud Projekt die Übersichtsseite der Google Ads API auf.
Prüfen Sie, ob auf der Seite Ihre aktuelle Zugriffsebene als Explorer angezeigt wird.
Maximieren Sie den Abschnitt Zugriffsebene erhöhen.
Prüfen Sie, ob die nächste Zugriffsebene als Einfach 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 „Einfach“ zu beantragen.

Google kann die API-Zugriffsebene Ihres Projekts nach dem Einreichen Ihres Antrags automatisch auf „Einfach“ erhöhen.

Zugriffsebene „Standard“

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

Zugriffsebene „Standard“ beantragen

Rufen Sie in Ihrem Google Cloud Projekt die Übersichtsseite der Google Ads API auf.
Prüfen Sie, ob auf der Seite Ihre aktuelle Zugriffsebene als Einfach angezeigt wird.
Maximieren Sie den Abschnitt Zugriffsebene erhöhen.
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 den Standardzugriff 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 auf Ihr Tool gewähren. Ihr Tool muss die erforderlichen Mindestfunktionen erfüllen.

Während des Überprüfungsprozesses kommuniziert das Google-Compliance-Team mit Ihnen über Ihre E-Mail-Adresse. Reagieren Sie umgehend auf die Anfragen des Compliance-Teams, um mit Ihrem Antrag für den Standardzugriff voranzukommen. Nach Abschluss der Überprüfung sendet Google Ihnen eine E-Mail mit dem Endergebnis des Überprüfungsprozesses.

API-Kontingente und Systemratenlimits

Unabhängig von der Zugriffsebene unterliegen alle API-Vorgänge Systemratenlimits. Dadurch wird die Anzahl der Vorgänge begrenzt, 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 Google Cloud-Projekte mit der Zugriffsebene „Standardzugriff“. Die zulässige Nutzung wird basierend auf der beabsichtigten Nutzung 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 gewähren.
Berichte	Nur `GoogleAdsService.Search` oder `GoogleAdsService.SearchStream` Anfragen oder schreibgeschützte Aufrufe 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.