Classroom API menampilkan informasi error yang dapat membantu developer men-debug masalah dan memberikan informasi yang bermanfaat dan dapat ditindaklanjuti kepada pengguna akhir. Panduan ini menjelaskan cara mengurai informasi error yang ditampilkan dari API.
Classroom API menampilkan dua tingkat informasi error:
- Kode error HTTP di header.
- Objek dalam isi respons dengan detail tambahan.
Struktur pesan error
Error yang ditampilkan dalam isi respons mencakup kolom berikut:
code: Kode error HTTP numerik. Misalnya,403.message: Detail tambahan tentang error. Jika tersedia, pesan error akan diawali dengan@dan jenis error tertentu. Contohnya,@ClassroomApiDisabled.status: Status permintaan HTTP. Misalnya,PERMISSION_DENIEDatauNOT_FOUND.
Jika permintaan gagal dengan error ClassroomApiDisabled, responsnya akan
berbunyi:
{
"error": {
"code": 403,
"message": "@ClassroomApiDisabled The user is not permitted to access the Classroom API.",
"status": "PERMISSION_DENIED"
}
}
Anda dapat menggunakan isi respons untuk membantu men-debug penyebab error dan
memberikan informasi yang bermanfaat kepada pengguna. Sertakan spasi di akhir saat memeriksa
pesan error tertentu untuk menghindari pencocokan nilai lain yang dimulai dengan
string yang sama. Dalam contoh error yang diberikan, Anda dapat memeriksa apakah kolom pesan diawali dengan "@ClassroomApiDisabled " untuk menampilkan informasi yang sesuai kepada pengguna.
Lihat halaman error akses, error permintaan, dan error add-on untuk mengetahui informasi tentang beberapa error yang dapat ditampilkan oleh Classroom API.