จัดการข้อผิดพลาด Classroom API

Classroom API จะแสดงข้อมูลข้อผิดพลาดที่จะช่วยให้นักพัฒนาซอฟต์แวร์แก้ไขข้อบกพร่องและให้ข้อมูลที่เป็นประโยชน์และนำไปใช้ได้แก่ผู้ใช้ปลายทาง คำแนะนำนี้จะอธิบายวิธีแยกวิเคราะห์ข้อมูลข้อผิดพลาดที่แสดงผลจาก API

Classroom API จะแสดงข้อมูลข้อผิดพลาด 2 ระดับดังนี้

  • รหัสข้อผิดพลาด HTTP ในส่วนหัว
  • ออบเจ็กต์ในส่วนเนื้อหาของการตอบกลับพร้อมรายละเอียดเพิ่มเติม

โครงสร้างข้อความแสดงข้อผิดพลาด

ข้อผิดพลาดที่แสดงผลในเนื้อหาการตอบกลับจะมีช่องต่อไปนี้

  • code: รหัสข้อผิดพลาด HTTP แบบตัวเลข เช่น 403
  • message: รายละเอียดเพิ่มเติมเกี่ยวกับข้อผิดพลาด ระบบจะใส่ @ และประเภทข้อผิดพลาดที่เฉพาะเจาะจงไว้หน้าข้อความแสดงข้อผิดพลาด (หากมี) เช่น @ClassroomApiDisabled
  • status: สถานะคำขอ HTTP เช่น PERMISSION_DENIED หรือ NOT_FOUND

หากคำขอไม่สำเร็จเนื่องจากมีข้อผิดพลาด ClassroomApiDisabled การตอบกลับจะมีลักษณะดังนี้

{
  "error": {
    "code": 403,
    "message": "@ClassroomApiDisabled The user is not permitted to access the Classroom API.",
    "status": "PERMISSION_DENIED"
  }
}

คุณสามารถใช้เนื้อหาของคำตอบเพื่อช่วยแก้ไขข้อผิดพลาดและแสดงข้อมูลที่เป็นประโยชน์แก่ผู้ใช้ ใส่เว้นวรรคต่อท้ายเมื่อตรวจสอบข้อความแสดงข้อผิดพลาดที่เฉพาะเจาะจงเพื่อหลีกเลี่ยงการจับคู่ค่าอื่นๆ ที่ขึ้นต้นด้วยสตริงเดียวกัน ในตัวอย่างข้อผิดพลาดที่มีให้ คุณตรวจสอบได้ว่าช่องข้อความขึ้นต้นด้วย "@ClassroomApiDisabled " เพื่อนำเสนอข้อมูลที่เหมาะสมแก่ผู้ใช้หรือไม่

โปรดดูหน้าข้อผิดพลาดในการเข้าถึง ข้อผิดพลาดคำขอ และข้อผิดพลาดของส่วนเสริมเพื่อดูข้อมูลเกี่ยวกับข้อผิดพลาดบางอย่างที่ Classroom API สามารถแสดงได้