Es gibt viele Szenarien, in denen bei der Arbeit mit der Display & Video 360 API Fehler auftreten können. Diese können mit einem Fehler in Ihrem Code, einer ungültigen Nutzereingabe oder einem Problem mit der API selbst zusammenhängen. In jedem Fall ist es ein wichtiger Teil des Entwicklungsprozesses, Fehler zu beheben. Dieser Leitfaden enthält einige Best Practices für den Einstieg.
Grundlegendes wiederholen
- Lesen Sie den Leitfaden „Voraussetzungen“. Sie benötigen Zugriff auf Display & Video 360 und ein korrekt konfiguriertes API-Projekt.
- Wenn Ihre Antwort HTTP-Fehler enthält, sehen Sie sich diese sorgfältig an und achten Sie darauf, dass die Anfrage an die richtige API und den richtigen Dienst gesendet wird.
- Lesen Sie den Autorisierungsleitfaden. Prüfen Sie, ob Ihre Anfrage die erforderlichen OAuth 2.0-Anmeldedaten enthält.
Überprüfen Sie, ob Sie die richtigen Anmeldedaten verwenden. Weitere Informationen zum Generieren von Authentifizierungsanmeldedaten finden Sie im Leitfaden zum Einrichten der Anwendung. Sie können Ihr Zugriffstoken auch an den tokeninfo-Endpunkt der Google OAuth2 API übergeben, um zu überprüfen, ob es für das richtige API-Projekt ausgestellt und für die richtigen Bereiche autorisiert wurde:
POST https://www.googleapis.com/oauth2/v2/tokeninfo?access_token={YOUR_ACCESS_TOKEN} 200 OK { "issued_to": "{API_PROJECT_CLIENT_ID}", "audience": "...", "scope": "{API_SCOPES}", "expires_in": ... }
Fehler verstehen
Wenn die API einen Fehler feststellt, gibt sie normalerweise eine JSON-Antwort mit einem error-Objekt zurück. Dieses Objekt bietet zusätzlichen Kontext zu dem spezifischen Fehler, der aufgetreten ist.
{
"error": {
"code": 404,
"message": "Resource type LINE_ITEM does not exist: advertisers/1/lineItems/1",
"status": "NOT_FOUND"
}
}
Normalerweise enthält der Inhalt des error-Objekts genügend Informationen, damit Sie den Fehler identifizieren können. Ist dies nicht der Fall, müssen Sie eventuell weitere
Recherchen anstellen, um die Fehlerursache zu ermitteln.
Fehler recherchieren
Weitere Informationen finden Sie im Abschnitt Häufige Fehler.
Wenn der Fehler nicht im Abschnitt zu häufigen Fehlern aufgeführt wird, lesen Sie die Referenzdokumentation und suchen Sie nach dem Fehlercode, dem Status und der Meldung.
Wenn Sie auf Fehler stoßen, die nicht dokumentiert sind, teilen Sie uns dies bitte mit.
Die Grundursache identifizieren
Jetzt haben Sie den Fehler identifiziert und verstehen, was er bedeutet. Falls nicht, lesen Sie den Abschnitt Fehler verstehen. Wenn Sie der Meinung sind, dass Sie in der API auf einen Fehler gestoßen sind, den Sie nicht selbst beheben können, können Sie Hilfe erhalten.
Bevor Sie den Fehler beheben können, müssen Sie die Ursache ermitteln. Häufig liegt dies an einem Programmfehler in Ihrem Code oder einem ungültigen Eingabewert.
Um festzustellen, ob das Problem auf einen Fehler in Ihrem Code zurückzuführen ist, prüfen Sie zuerst, ob er wie vorgesehen funktioniert. Prüfen Sie zuerst den Codeabschnitt, der für die fehlgeschlagene Anfrage verantwortlich ist, um auf offensichtliche Probleme zu prüfen. In einigen Fällen kann es erforderlich sein, ein Debugging-Tool zu verwenden, um den Code Zeile für Zeile durchzugehen, um sicherzustellen, dass er ordnungsgemäß funktioniert.
Die Untersuchung von HTTP-Anfragen ist eine weitere nützliche Methode, um potenzielle Programmfehler sowie Fälle ungültiger Eingaben zu identifizieren. Viele der offiziellen Clientbibliotheken können so konfiguriert werden, dass sie HTTP-Anfragen und -Antworten protokollieren. Weitere Informationen finden Sie in der Dokumentation zur Bibliothek Ihrer Wahl. Ein HTTP-Proxy wie Charles, Squid oder Fiddler kann auch verwendet werden, um Anfrage- und Antwortlogs zu erfassen. Sobald Sie diese Logs erhalten haben, prüfen Sie, ob die von Ihrer Anwendung bereitgestellten Anfrageparameterwerte korrekt sind und Ihren Erwartungen entsprechen.
Sobald Sie den Fehler oder die ungültige Eingabe identifiziert haben, die den Fehler verursacht hat, ist die Fehlerbehebung hoffentlich offensichtlich. Wenn Sie jedoch nicht weiterkommen oder sich nicht sicher sind, wie Sie das Problem am besten lösen können, können Sie die bisher gesammelten Informationen verwenden, um Hilfe zu erhalten.
Unterstützung erhalten
Wenn Sie einen Fehler nicht selbst beheben können, wenden Sie sich über dieses Formular in der Display & Video 360-Hilfe an unser Supportteam.
Wenn Sie dieses Formular ausfüllen, sollten Sie so viele Informationen wie möglich zu Ihrem Problem und den bereits unternommenen Schritten zur Fehlerbehebung angeben. Hier einige hilfreiche Informationen:
- HTTP-Anfrage- und -Antwortlogs. Entfernen Sie vertrauliche Informationen wie OAuth 2.0-Zugriffstokens, E-Mail-Adressen usw.
- Code-Snippet Wenn Sie das Problem auf einen bestimmten Codeabschnitt eingrenzen oder vermuten, dass es sich um eine sprachspezifische Struktur handelt, fügen Sie ein kleines Snippet hinzu, um zu verdeutlichen, was Sie tun.
- Zusätzliche Informationen wie Laufzeit-/Interpreterversion und Plattform, die für andere nützlich sein können, die versuchen, das Problem zu reproduzieren.
Problem beheben
Sobald Sie die Ursache des Problems und eine Lösung gefunden haben, ist es an der Zeit, eine Lösung zu implementieren. Testen Sie Ihre Fehlerbehebung vor der Bereitstellung in der Produktion nach Möglichkeit in einer kontrollierten Umgebung (z. B. in einem speziell für Tests konfigurierten Partner oder Werbetreibenden) anhand einer Reihe guter und schlechter Eingaben.