Tests sind ein wichtiger Schritt beim Erstellen einer erfolgreichen Google Ads API-Integration. Das gilt sowohl für den Einstieg als auch für die Wartung einer App oder das Hinzufügen neuer Funktionen zu einer bestehenden Integration. In diesem Leitfaden finden Sie einige Best Practices für das Testen Ihrer Google Ads API-Integration.
Testkonten und Produktionskonten
Testkonten sind für Entwicklungszwecke verfügbar. Mit Testkonten können Sie prüfen, ob Ihr Anwendungscode und Ihre Konfiguration wie vorgesehen funktionieren.
Allerdings können nicht alle Funktionen in einem Test Konto getestet werden.
Wenn Sie aufgrund von Einschränkungen bei Testkonten einige Funktionen in Ihrer Integration nicht testen können, können Sie stattdessen ein Produktionskonto für die Entwicklung verwenden. Ihr
Google Cloud-Projekt muss mindestens die
Zugriffsebene „Explorer“ (Explorer, Basic oder Standard) haben, um
ein Produktionskonto aufrufen zu können. Beachten Sie, dass der Explorer-Zugriff bestimmte
Dienste einschränkt, darunter Abrechnung (BillingSetupService
und AccountBudgetProposalService),
Planung, Kontoerstellung und Nutzereinladungen (siehe Einschränkungen der Explorer-Funktionen). Für diese Dienste ist der Zugriff „Basic“ oder „Standard“ erforderlich.
Wenn Sie versuchen, ein Produktionskonto über ein
Projekt mit der Zugriffsebene „Test“ aufzurufen, wird
AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
ab Version v25 die Fehlermeldung
AuthorizationError.ACTION_NOT_PERMITTED und in Version v24 und
früher die Fehlermeldung zurückgegeben.
Produktionskonten für die Entwicklung unterscheiden sich in folgenden Punkten von Testkonten:
- Anzeigen werden ausgeliefert, die für Nutzer sichtbar sind.
- Gültige URLs sind erforderlich.
- Die Werberichtlinien müssen eingehalten werden.
Da in Produktionskonten Anzeigen ausgeliefert werden, werden Messwerte generiert, mit denen Sie Leistungsberichte testen können. Außerdem werden alle anderen Funktionen der Google Ads API freigeschaltet. Die Verwendung für die Entwicklung erfordert jedoch besondere Vorsicht. Wir empfehlen Folgendes:
- Gewähren Sie nur Nutzern Zugriff, die ihn für Entwicklungszwecke benötigen.
- Legen Sie ein festes, niedriges Tagesbudget für das Konto fest.
- Verwenden Sie Produktionskonten für die Entwicklung nur, wenn Testkonten nicht verwendet werden können.
Für umfassende Tests Ihrer Integration benötigen Sie daher wahrscheinlich sowohl Test- als auch Produktionsanmeldedaten.
Test-Anmeldedaten
Um das Risiko zu minimieren, dass Sie versehentlich Produktionskonten ändern, wenn Sie versuchen, Entwicklungskonten zu ändern, empfehlen wir, Test-Anmeldedaten zu verwenden, die von Ihren Produktionsanmeldedaten getrennt sind.
So erstellen Sie Test-Anmeldedaten:
- Erstellen Sie ein E‑Mail-Konto (z. B.
api.test@example.com) oder ein Dienstkonto, das nur für Testzwecke verwendet wird. - Fügen Sie diesen Nutzer oder dieses Dienstkonto als gültigen Nutzer in den Google Ads-Konten hinzu, in denen Sie Ihre Tests ausführen. Gewähren Sie diesem Nutzer oder Dienstkonto die entsprechenden Zugriffs ebenen. Gewähren Sie diesem Nutzer oder Dienstkonto keinen Zugriff auf Produktionskonten.
- Wenn Sie den OAuth 2.0-Nutzerauthentifizierungsablauf anstelle des Dienstkontoablaufs verwenden, generieren Sie ein Aktualisierungstoken für Ihr Testnutzerkonto.
- Verwenden Sie diese neuen Anmeldedaten, wenn Sie Ihre Anwendung testen. Die Client-ID und der Clientschlüssel können für Testzwecke wiederverwendet werden, da sie keinen Einfluss darauf haben, auf welche Google Ads-Konten zugegriffen werden kann. Bewahren Sie alle Anmeldedaten und Aktualisierungstokens sicher auf und übertragen Sie sie niemals in die Quellcodeverwaltung.
Bestätigung anfordern
Wenn Sie nur testen möchten, ob eine Anfrage gültig ist, z. B. um zu prüfen, ob sie korrekt strukturiert ist und keine Richtlinien verletzt, können Sie das validate_only Feld verwenden. Es ist für GoogleAdsService.Search Anfragen verfügbar (für GoogleAdsService.SearchStream wird validate_only nicht unterstützt) und für die meisten Mutationsanfragen. In der
Referenzdokumentation können Sie nachsehen, ob dieses Feld für eine bestimmte Methode
verfügbar ist.
REST API
Für Ad-hoc-Tests, z. B. um zu prüfen, ob eine Anfrage die erwartete Ausgabe liefert, ist die Verwendung der REST API oft die einfachste Option. In den REST Beispielen erfahren Sie, wie Sie mit „curl“ Anfragen an die REST API senden. Sie können auch Tests im REST Explorer durchführen.