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 Verwendung bestimmt die spezifischen Google Ads API-Funktionen, die im Projekt verwendet werden dürfen.
Zur Google Ads API-Übersicht in der Cloud Console
Zugriffsebenen
In der Tabelle sind vier verschiedene API-Zugriffsebenen 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. Anschließend können Sie auf der Übersichtsseite der Google Ads API den Zugriffstyp „Explorer“ beantragen, um auf Produktionskonten zuzugreifen.
| Zugriffsebene | Hat Zugriff auf | Tägliches Vorgangslimit 1 | 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 | Standardzugriff beantragen | |
| Standard | Test- und Produktionskonten | Unbegrenzte Anzahl von Vorgängen pro Tag für Test- und Produktionskonten | Standardzugriff beantragen | 10 Werktage |
1 „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 das Anfragelimit für Ihre Zugriffsebene innerhalb der letzten 24 Stunden überschreitet.
Zugriff testen
Nachdem Sie die Google Ads API aktiviert haben, erhält Ihr Google Cloud-Projekt Testzugriff. Das bedeutet, dass das Projekt nur Google Ads API-Anfragen für Testkonten stellen kann.
Testzugriff beantragen
Aktivieren Sie die Google Ads API in Ihrem Google Cloud-Projekt, um automatisch Testzugriff für Ihr Projekt zu erhalten.
Explorer-Zugriffsebene
Nachdem Sie sich für die Google Ads API registriert haben, können Sie möglicherweise die Zugriffsebene „Explorer“ beantragen.
Mit der Zugriffsebene „Explorer“ kann Ihr Google Cloud-Projekt Google Ads API-Anfragen sowohl an Testkonten als auch an Produktionskonten senden. Produktionskonten sind alle Konten, über die echte, aktive Google Anzeigen ausgeliefert werden. Über 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 einfache 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 „Basic“ oder die Zugriffsebene „Standard“ beantragen.
| Eingeschränkte Funktionalität | Eingeschränkte Dienste und Methoden |
|---|---|
| Kontoerstellung | CustomerService.CreateCustomerClient |
| Nutzerverwaltung | CustomerUserAccessInvitationServiceCustomerUserAccessService |
| Planung | KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceReachPlanService |
| Kontoabrechnung und Zahlung | PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
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.
- Klicken Sie, um den Bereich Zugriffsebene upgraden zu maximieren.
- Prüfen Sie, ob die nächste Zugriffsebene als Explorer angezeigt wird.
- Klicken Sie auf den Button Zugriff beantragen, um Zugriff auf der „Explorer“-Zugriffsebene zu beantragen.
Google kann die API-Zugriffsebene Ihres Projekts nach dem Einreichen Ihres Antrags automatisch auf „Explorer“ upgraden.
Grundlegende Zugriffsebene
Mit der Zugriffsebene „Einfach“ können Sie in Ihrem Google Cloud-Projekt Google Ads API-Anfragen sowohl für Testkonten als auch für Produktionskonten stellen. Produktionskonten sind alle Konten, über die echte, aktive Google Anzeigen ausgeliefert werden. Über Testkonten werden keine Anzeigen ausgeliefert.
Mit der Zugriffsebene „Basic“ kann Ihr Google Cloud-Projekt bis zu 15.000 Vorgänge pro Tag ausführen. Dies ist für die meisten Entwickler ausreichend.
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.
- Klicken Sie, um den Bereich Zugriffsebene upgraden zu maximieren.
- Prüfen Sie, ob die nächste Zugriffsebene als Basic angezeigt wird.
- Prüfen Sie, ob es Warnungen gibt, die darauf hinweisen, dass Sie die Markenüberprüfung für Ihr Projekt nicht abgeschlossen haben. Wenn ja, folgen Sie der Anleitung, um die Markenbestätigung abzuschließen, bevor Sie fortfahren.
- Klicken Sie auf den Button Zugriff beantragen, um die Zugriffsebene „Einfach“ zu beantragen.
Google kann die API-Zugriffsebene Ihres Projekts automatisch auf „Basic“ heraufstufen, sobald Sie Ihren Antrag eingereicht haben.
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 Ratenbegrenzungen und Einschränkungen, die für diese Funktionen spezifisch sind. Diese gelten auch dann, wenn Ihr Projekt die Zugriffsebene „Standard“ hat.
Die Standardzugriffsebene wird nur Entwicklern gewährt, die unbegrenzte Google Ads API-Vorgänge benötigen, z. B. großen 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 Basic angezeigt wird.
- Klicken Sie, um den Bereich Zugriffsebene upgraden zu maximieren.
- Prüfen Sie, ob die Nächste Zugriffsebene als Standard angezeigt wird.
- Klicken Sie auf den Button Antrag starten, um den Antrag für die Standardzugriffsebene zu starten.
Der Antrag auf Standardzugriff umfasst eine detaillierte manuelle Prüfung Ihrer Anwendung. Seien Sie darauf vorbereitet, Fragen zur Funktionalität Ihres Tools und zur Zielgruppe zu beantworten. Wenn Ihr Tool von externen Nutzern verwendet wird, müssen Sie einen Demo-Zugang zu Ihrem Tool bereitstellen. Ihr Tool muss die erforderlichen Mindestfunktionen erfüllen.
Während des Überprüfungsprozesses kommuniziert das Google Compliance-Team über Ihre E-Mail-Adresse mit Ihnen. Beantworten Sie die Fragen des Compliance-Teams umgehend, damit Ihr Antrag auf Standardzugriff bearbeitet werden kann. Nach Abschluss der Überprüfung 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 den Systemratenbegrenzungen. Dadurch wird die Anzahl der Vorgänge, die Sie in einem bestimmten Zeitraum ausführen können, also die Anzahl der Vorgänge pro Stunde, eingeschränkt. Weitere Informationen zum Umgang mit Fehlern bei der Ratenbegrenzung finden Sie unter Fehlertypen.
Für einzelne Dienste können zusätzliche Limits und Kontingenteinschränkungen gelten, z. B. aufgrund von Einschränkungen beim Produktdesign, Einschränkungen der Produktrichtlinien, 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 Verwendung wird basierend auf der beabsichtigten Verwendung der Google Ads API zugewiesen. Diese Berechtigungen bestimmen, welche Funktionen der API Ihr Tool verwenden kann, wie in der folgenden Tabelle beschrieben:
| 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 | Stellen Sie nur GoogleAdsService.Search- oder GoogleAdsService.SearchStream-Anfragen oder schreibgeschützte Aufrufe. Diese Option ist für Entwickler gedacht, die die API nur zum Abrufen von Statistiken verwenden. |
| Keywords und Empfehlungen recherchieren | Gewähren Sie dem Google Cloud-Projekt Zugriff auf RecommendationService, KeywordPlanIdeaService und KeywordPlanService. Diese werden nur von Tools verwendet, die Vorschläge benötigen, um die Erstellung und Verwaltung von Google Ads-Kampagnen zu erleichtern. |
Zulässige Nutzung ändern
Wenn Ihr Google Cloud-Projekt für die Standard-Zugriffsebene 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.