Tests sind ein wichtiger Schritt beim Erstellen einer erfolgreichen Google Ads API-Integration, egal 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.
In einem Testkonto können jedoch nicht alle Funktionen getestet werden.
Wenn Sie aufgrund von Einschränkungen des Testkontos 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 aufzurufen. Beachten Sie, dass der Explorer-Zugriff weiterhin bestimmte Dienste einschränkt, darunter die Abrechnung (BillingSetupService und AccountBudgetProposalService), die Planung, die Kontoerstellung und Nutzereinladungen (siehe Einschränkungen für Explorer-Funktionen). Für diese Dienste ist ein Basis- oder Standardzugriff erforderlich. Wenn Sie versuchen, ein Produktionskonto aus einem Projekt mit der Zugriffsebene „Test“ aufzurufen, wird ab v25 AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION oder in v24 und früheren Versionen AuthorizationError.ACTION_NOT_PERMITTED zurückgegeben.
Produktionskonten für die Entwicklung unterscheiden sich von Testkonten in folgenden Punkten:
- Anzeigen ausliefern, die für Nutzer sichtbar sind
- Gültige URLs erforderlich
- 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 nur dann für die Entwicklung, wenn keine Testkonten verwendet werden können.
Für einen vollständigen Test deiner Integration benötigst du daher wahrscheinlich sowohl Test- als auch Produktionsanmeldedaten.
Test-Anmeldedaten
Damit Sie nicht versehentlich Produktionskonten ändern, wenn Sie Entwicklungskonten ändern möchten, empfehlen wir, einen Satz von Testanmeldedaten zu verwenden, der von den Anmeldedaten Ihrer Produktionsanwendung getrennt ist.
So erstellen Sie Testanmeldedaten:
- Erstellen Sie ein E-Mail-Konto (z. B.
api.test@example.com) oder ein Dienstkonto, das nur zu Testzwecken verwendet wird. - Fügen Sie diesen Nutzer oder dieses Dienstkonto als gültigen Nutzer in den Google Ads-Konten hinzu, für die Sie die Tests ausführen. Achten Sie darauf, diesem Nutzer oder Dienstkonto die entsprechenden Zugriffsebenen zuzuweisen. 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 zu Testzwecken 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 Versionsverwaltung.
Bestätigung anfordern
Wenn Sie nur testen möchten, ob eine Anfrage gültig ist, also beispielsweise, ob sie richtig strukturiert ist und nicht gegen Richtlinien verstößt, können Sie das Feld validate_only verwenden. Es ist für GoogleAdsService.Search-Anfragen (GoogleAdsService.SearchStream unterstützt validate_only nicht) und die meisten Mutationsanfragen verfügbar. In der Referenzdokumentation können Sie prüfen, 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 im REST Explorer testen.