Menangani Error API

Classroom API menampilkan dua tingkat informasi error:

  • Kode dan pesan error HTTP di header
  • Objek JSON dalam isi respons dengan detail tambahan

Anda dapat menggunakan objek respons untuk proses debug. Dalam beberapa kasus, respons mungkin berisi detail error tambahan. Anda dapat menggunakan detail ini untuk memperjelas penyebab error dan memberikan informasi kepada pengguna atau mengarahkan mereka untuk mengambil tindakan yang tepat.

Struktur Pesan Error

Jika tersedia, detail error tambahan akan disertakan dalam kolom message error yang diformat sebagai @, diikuti dengan kode error.

Misalnya, jika permintaan gagal dengan error ClassroomApiDisabled, respons JSON akan menjadi:

{
  "error": {
    "code": 403,
      "message": "@ClassroomApiDisabled The user is not permitted to access the Classroom API.",
      "errors": [
        {
          "message": "@ClassroomApiDisabled The user is not permitted to access the Classroom API.",
          "domain": "global",
          "reason": "forbidden"
        }
      ],
      "status": "PERMISSION_DENIED"
  }
}

Anda dapat memeriksa apakah kolom pesan dimulai dengan "@ClassroomApiDisabled " dan menampilkan perintah yang sesuai kepada pengguna. Sertakan spasi di akhir saat memeriksa kode error untuk menghindari pencocokan nilai lain yang dimulai dengan string yang sama.