Tests sind ein wichtiger Schritt beim Erstellen einer erfolgreichen Google Ads API-Integration, unabhängig davon, ob Sie gerade erst anfangen, eine App verwalten oder einer bestehenden Integration neue Funktionen hinzufügen. In diesem Leitfaden finden Sie einige Best Practices zum 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.
Nicht alle Funktionen können jedoch in einem Testkonto getestet werden.
Wenn Sie aufgrund von Einschränkungen bei Testkonten bestimmte 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 aufzurufen. Beachten Sie, dass der Explorer-Zugriff weiterhin bestimmte Dienste einschränkt, darunter die Abrechnung (BillingSetupService und AccountBudgetProposalService), die Planung, die Kontoerstellung und Einladungen für Nutzer (siehe Einschränkungen der Explorer-Funktion). Für diese Dienste ist ein Basic- oder Standard-Zugriff erforderlich. Wenn Sie versuchen, ein Produktionskonto über ein Projekt mit der Zugriffsebene „Test“ aufzurufen, wird ab v25 der Fehler AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION zurückgegeben. In v24 und früher wird der Fehler AuthorizationError.ACTION_NOT_PERMITTED zurückgegeben.
Produktionskonten für die Entwicklung unterscheiden sich in folgenden Punkten von Testkonten:
- Anzeigen ausliefern, die von Nutzern gesehen werden können
- Gültige URLs sind erforderlich
- Sie müssen den Werberichtlinien entsprechen.
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 vollständige Tests Ihrer Integration benötigen Sie daher wahrscheinlich sowohl Test- als auch Produktionsanmeldedaten.
Test-Anmeldedaten
Um das Risiko zu minimieren, dass Produktionskonten versehentlich geändert werden, wenn Sie versuchen, Entwicklungskonten zu ändern, empfehlen wir, Testanmeldedaten zu verwenden, die von den Anmeldedaten Ihrer Produktionsanwendung getrennt sind.
So erstellen Sie Testanmeldedaten:
- 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, für die Sie Ihre Tests ausführen. Achten Sie darauf, dass Sie diesem Nutzer oder Dienstkonto die entsprechenden Zugriffsebenen gewähren. Gewähren Sie diesem Nutzer oder Dienstkonto keinen Zugriff auf Produktionskonten.
- Wenn Sie den OAuth 2.0-Nutzerauthentifizierungs-Workflow anstelle des Dienstkonto-Workflows verwenden, generieren Sie ein Aktualisierungstoken für Ihr Testnutzerkonto.
- Verwenden Sie diese neuen Anmeldedaten, wenn Sie Ihre Anwendung testen. Die Client-ID und das Client-Secret können für Testzwecke wiederverwendet werden, da sie keinen Einfluss darauf haben, auf welche Google Ads-Konten zugegriffen werden kann. Speichern Sie alle Anmeldedaten und Aktualisierungstokens sicher und übertragen Sie sie niemals in die Quellcodeverwaltung.
Bestätigung anfordern
Wenn Sie nur testen müssen, ob eine Anfrage gültig ist, z. B. um zu prüfen, ob die Anfrage richtig strukturiert ist und nicht gegen Richtlinien verstößt, können Sie das Feld validate_only verwenden. Es ist für GoogleAdsService.Search-Anfragen verfügbar. GoogleAdsService.SearchStream unterstützt validate_only nicht. Das Feld ist auch für die meisten Mutate-Anfragen verfügbar. 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 den REST Explorer verwenden.