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 Verwendung“ 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 für das Projekt verwendet werden dürfen.

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 zuerst 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	Tageslimit 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	Testzugriff beantragen
Explorer	Test- und Produktionskonten	2.880 Vorgänge pro Tag für Produktionskonten 15.000 Vorgänge pro Tag für Testkonten	Explorer-Zugriff beantragen
Einfach	Test- und Produktionskonten	15.000 Vorgänge pro Tag für Test- und Produktionskonten	Einfachen Zugriff 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 24-Stunden-Zeitraum, in dem API-Anfragen mit Ihrem Google Cloud-Projekt gestellt wurden. Ihre Anwendung erhält einen Fehler, wenn sie innerhalb der letzten 24 Stunden das Anfragelimit für Ihre Zugriffsebene überschreitet.

Zugriff testen

Nachdem Sie die Google Ads API aktiviert haben, erhält Ihr Google Cloud-Projekt Testzugriff. Das bedeutet, dass mit dem Projekt nur Google Ads API-Anfragen für Testkonten gestellt werden können.

Testzugriff beantragen

Wenn Sie die Google Ads API in Ihrem Google Cloud-Projekt aktivieren, wird Ihrem Projekt automatisch Testzugriff gewährt.

Zugriffsebene „Explorer“

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

Mit der Zugriffsebene „Explorer“ können in Ihrem Google Cloud-Projekt Google Ads API-Anfragen sowohl für Testkonten als auch für Produktionskonten gestellt werden. Produktionskonten sind alle Konten, in denen echte Google-Anzeigen ausgeliefert werden. In Testkonten werden keine Anzeigen ausgeliefert.

Mit der Zugriffsebene „Explorer“ können in Ihrem Google Cloud-Projekt bis zu 2.880 Vorgänge pro Tag für Produktionskonten ausgeführt werden. Das reicht für die meisten Entwickler aus, um mit der API zu beginnen und grundlegende Automatisierungen zu erstellen.

Mit der Zugriffsebene „Explorer“ wird der Zugriff auf die folgenden Funktionen eingeschränkt. Wenn Sie diese Funktionen verwenden möchten, müssen Sie die Zugriffsebene „Einfach“ oder die Zugriffsebene „Standard“ beantragen.

Eingeschränkte Funktionalität	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 zur 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 Explorer als Nächste Zugriffsebene angezeigt wird.
Klicken Sie auf den Button Zugriff beantragen, um die Zugriffsebene „Explorer“ zu beantragen.

Google kann das API-Zugriffsniveau Ihres Projekts nach dem Einreichen Ihres Antrags automatisch auf „Explorer“ upgraden.

Ebene „Grundlegender Zugriff“

Mit der Zugriffsebene „Basic“ können in Ihrem Google Cloud-Projekt Google Ads API-Anfragen sowohl für Testkonten als auch für Produktionskonten gestellt werden. Produktionskonten sind alle Konten, in denen echte Google-Anzeigen ausgeliefert werden. In Testkonten werden keine Anzeigen ausgeliefert.

Mit der Zugriffsebene „Einfach“ können in Ihrem Google Cloud-Projekt bis zu 15.000 Vorgänge pro Tag ausgeführt werden. Das ist für die meisten Entwickler ausreichend.

Antrag auf die Zugriffsebene „Basic“ stellen

Rufen Sie in Ihrem Google Cloud-Projekt die Übersichtsseite zur 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 Nächste Zugriffsebene als Basis angezeigt wird.
Prüfen Sie, ob Warnungen angezeigt werden, die darauf hinweisen, dass Sie die Markenüberprüfung für Ihr Projekt nicht abgeschlossen haben. Folgen Sie der Anleitung, um die Markenbestätigung abzuschließen, bevor Sie fortfahren.
Klicken Sie auf die Schaltfläche Zugriff beantragen, um die Zugriffsebene „Einfach“ zu beantragen.

Google kann das API-Zugriffsniveau Ihres Projekts nach dem Einreichen Ihres Antrags automatisch auf „Basic“ upgraden.

Ebene „Standardzugriff“

Mit der Standardzugriffsebene 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 Ratenbeschränkungen und Einschränkungen, die für diese Funktionen spezifisch sind. Diese gelten auch dann, wenn Ihr Projekt die Zugriffsebene „Standard“ hat.

Der Standardzugriff wird nur Entwicklern gewährt, die unbegrenzte Google Ads API-Vorgänge benötigen, z. B. große Unternehmen oder Tools, die von vielen Nutzern verwendet werden.

Standardzugriff beantragen

Rufen Sie in Ihrem Google Cloud-Projekt die Übersichtsseite zur Google Ads API auf.
Prüfen Sie, ob auf der Seite Ihre aktuelle Zugriffsebene als Basic angezeigt wird.
Klicken Sie, um den Abschnitt Zugriffsebene aktualisieren zu maximieren.
Prüfen Sie, ob 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.

Die Standardzugriffsanfrage umfasst eine detaillierte manuelle Prüfung Ihrer Anwendung. Halten Sie sich bereit, Fragen zur Funktionalität Ihres Tools und zur Zielgruppe zu beantworten. Wenn Ihr Tool von externen Nutzern verwendet wird, müssen Sie einen Demo-Anmeldezugriff für Ihr Tool bereitstellen. Ihr Tool muss den erforderlichen Mindestfunktionen entsprechen.

Während des Überprüfungsprozesses kommuniziert das Google-Compliance-Team über Ihre E-Mail-Adresse mit Ihnen. Reagieren Sie umgehend auf Anfragen des Compliance-Teams, damit Ihr Antrag auf Standardzugriff bearbeitet werden kann. Sobald die Überprüfung abgeschlossen ist, erhalten Sie von Google eine E‑Mail mit dem endgültigen Ergebnis.

API-Kontingente und Systemratenbegrenzungen

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 dürfen, d. h. die Anzahl der Vorgänge pro Stunde. Weitere Informationen zum Beheben von Fehlern bei Ratenlimits

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 dem Zugriffslevel „Standardzugriff“. Die zulässige Verwendung 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	Führen Sie nur `GoogleAdsService.Search`- oder `GoogleAdsService.SearchStream`-Anfragen oder schreibgeschützte Aufrufe aus. Dieser Abschnitt ist für Entwickler gedacht, die die API nur zum Anfordern von Statistiken verwenden.
Keywords und Empfehlungen recherchieren	Erlauben Sie dem Google Cloud-Projekt den Zugriff auf `RecommendationService`, `KeywordPlanIdeaService` und `KeywordPlanService`. Diese Informationen werden 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 „Standardzugriff“ genehmigt wurde, 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.