Jedem Google Ads API-Entwickler-Token wird eine Zugriffsebene und eine sogenannte zulässige Nutzung zugewiesen. Die Zugriffsebene bestimmt, ob Sie die Produktionskonten und die Anzahl der Vorgänge und Anfragen beeinflussen können, die Sie täglich ausführen können. Anhand der zulässigen Nutzung werden die spezifischen Google Ads API-Funktionen bestimmt, die das Entwickler-Token verwenden darf.
Zugriffsebenen
Es gibt drei verschiedene Zugriffsebenen, die in der Tabelle nach Umfang aufgelistet sind. Wenn Sie noch keinen Zugriff auf die Google Ads API haben, können Sie sich registrieren, um Zugriff auf das Testkonto 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 Vorgangslimit1 | Übernehmen |
|---|---|---|---|
| Testkontozugriff | Testkonten | 15.000 Vorgänge / Tag | Anleitung |
| Basiszugriff | Test- und Produktionskonten | 15.000 Vorgänge / Tag | Anleitung |
| Standardzugriff | Test- und Produktionskonten | Unbegrenzte Vorgänge pro Tag | Anleitung |
1 „Pro Tag“ basiert auf einem gleitenden Zeitraum von 24 Stunden, in dem API-Anfragen mit Ihrem Entwickler-Token gestellt wurden. Ihre Anwendung erhält eine Fehlermeldung, wenn sie das Anfragelimit für Ihre Zugriffsebene innerhalb der letzten 24 Stunden überschreitet.
Testkontozugriff
Nachdem Sie sich für die Google Ads API registriert haben, erhalten Sie ein Entwickler-Token mit der Zugriffsebene für das Testkonto. Das bedeutet, dass über das Entwickler-Token nur Google Ads API-Anfragen an Testkonten gesendet werden können.
Testkontozugriff beantragen
Schließen Sie die Google Ads API-Registrierung auf der Google Ads-Weboberfläche ab, um automatisch die Zugriffsebene für das Testkonto zu erhalten.
Basiszugriff
Mit dem Basiszugriff können über das Entwickler-Token Google Ads API-Anfragen an Test- und Produktionskonten gestellt werden. Produktionskonten sind alle Konten, über die echte Google Anzeigen live geschaltet werden. Mit Testkonten werden keine Anzeigen ausgeliefert.
Mit der grundlegenden Zugriffsebene können mit dem Entwickler-Token bis zu 15.000 Vorgänge pro Tag ausgeführt werden. Für die meisten Entwickler ist dies ausreichend.
Basiszugriff beantragen
Wenn Sie derzeit ein Entwickler-Token auf Testkonto-Zugriffsebene haben und den Zugriff auf das Produktionskonto beantragen möchten, füllen Sie das Antragsformular für den Basiszugriff aus. Führe die folgenden Schritte aus:
- Prüfen Sie, ob Sie bereits ein Entwickler-Token mit Testkonto-Zugriffsebene haben.
- Überprüfen Sie, ob die Kontakt-E-Mail-Adresse für API im API-Center auf dem neuesten Stand ist. Ohne gültige, regelmäßig überprüfte E-Mail-Adresse können Sie den Bewerbungsprozess nicht abschließen. Alle aktiven Google Ads-Konten müssen mit dem Verwaltungskonto verknüpft sein, für das das API-Token verwendet wird.
Standardzugriff
Mit dem Standardzugriff kann über das Entwickler-Token für die meisten Dienste eine unbegrenzte Anzahl von Vorgängen pro Tag ausgeführt werden. Dazu gehören unter anderem GoogleAdsService Search und SearchStream. Weitere Informationen zu Limits und Ausnahmen vom Standardzugriff finden Sie unter API-Kontingente.
Die Standardzugriffsebene wird nur Entwicklern gewährt, die unbegrenzte Google Ads API-Vorgänge benötigen, z. B. große Unternehmen oder Tools, die viele Nutzer bedienen.
Unabhängig von der Zugriffsebene gelten für alle API-Vorgänge die Ratenbegrenzungen des Systems. Weitere Informationen zum Umgang mit Ratenbegrenzungsfehlern finden Sie unter Fehlertypen.
Standardzugriff beantragen
Wenn Sie derzeit eine Basiszugriffsebene haben und unbegrenzte Google Ads API-Vorgänge beantragen möchten, füllen Sie dieses Formular zum Beantragen des Standardzugriffs aus.
Wenn Ihr Tool extern ist, bereiten Sie sich darauf vor, eine Demo-Anmeldung für Ihr Tool zu ermöglichen. Hinweis: Ihr Tool muss über die erforderlichen Mindestfunktionen verfügen.
Zulässige Nutzung
Die zulässige Nutzung gilt nur für Tokens mit Basiszugriff und Standardzugriff. Die zulässige Nutzung wird auf Grundlage der beabsichtigten Nutzung der Google Ads API zugewiesen. Diese Berechtigungen bestimmen, für welche Funktionen der API ein Token verwendet werden kann, wie in der folgenden Tabelle erläutert:
| Zulässige Nutzung | Beschreibung |
|---|---|
| Anzeigen erstellen und verwalten | Zugriff auf alle API-Dienste zum Erstellen und Verwalten von Google Ads-Kampagnen, -Anzeigengruppen, -Anzeigen und -Keywords. |
| Berichterstellung | Senden Sie nur GoogleAdsService.Search- oder GoogleAdsService.SearchStream-Anfragen oder schreibgeschützte Aufrufe. Diese Option ist für Entwickler gedacht, die die API nur zum Anfordern von Statistiken verwenden.
|
| Keywords und Empfehlungen recherchieren | Erlauben Sie dem Token den Zugriff auf RecommendationService, KeywordPlanIdeaService und KeywordPlanService. Dies wird nur von Tools verwendet, die Vorschläge benötigen, um das Erstellen und Verwalten von Google Ads-Kampagnen zu vereinfachen. |
Zulässige Nutzung ändern
Wenn Ihnen die Basis- oder Standardzugriffsebene gewährt 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 Clients Zugriff auf das Tool gewähren möchten.