Die Classroom API gibt Fehlerinformationen zurück, die Entwicklern bei der Fehlerbehebung helfen und Endnutzern hilfreiche Informationen liefern können. In diesem Leitfaden wird erläutert, wie Sie von der API zurückgegebene Fehlerinformationen parsen.
Die Classroom API gibt zwei Fehlerebenen zurück:
- HTTP-Fehlercode im Header.
- Ein Objekt im Antworttext mit zusätzlichen Details.
Struktur von Fehlermeldungen
Die im Antworttext zurückgegebenen Fehler enthalten die folgenden Felder:
code: Der numerische HTTP-Fehlercode. Beispiel:403.message: Zusätzliche Details zum Fehler. Sofern verfügbar, wird der Fehlermeldung@und ein bestimmter Fehlertyp vorangestellt. Beispiel:@ClassroomApiDisabled.status: Der HTTP-Anfragestatus. Beispiel:PERMISSION_DENIEDoderNOT_FOUND.
Wenn eine Anfrage mit dem Fehler ClassroomApiDisabled fehlgeschlagen ist, würde die Antwort so aussehen:
{
"error": {
"code": 403,
"message": "@ClassroomApiDisabled The user is not permitted to access the Classroom API.",
"status": "PERMISSION_DENIED"
}
}
Sie können den Antworttext verwenden, um die Fehlerursache zu beheben und Nutzern hilfreiche Informationen zur Verfügung zu stellen. Fügen Sie bei der Suche nach einer bestimmten Fehlermeldung einen abschließenden Leerraum ein, um Übereinstimmungen mit anderen Werten zu vermeiden, die mit demselben String beginnen. Im angegebenen Fehlerbeispiel können Sie prüfen, ob das Nachrichtenfeld mit "@ClassroomApiDisabled " beginnt, um Nutzern entsprechende Informationen zu präsentieren.
Auf den Seiten zu Zugriffsfehlern, Anfragefehlern und Add-on-Fehlern finden Sie Informationen zu einigen Fehlern, die von der Classroom API zurückgegeben werden können.