Processar erros da API Classroom

A API Classroom retorna informações de erro que podem ajudar os desenvolvedores a depurar problemas e fornecer informações úteis e acionáveis aos usuários finais. Este guia explica como analisar as informações de erro retornadas pela API.

A API Classroom retorna dois níveis de informações de erro:

• Código de erro HTTP no cabeçalho.
• Um objeto no corpo da resposta com detalhes adicionais.

Estrutura da mensagem de erro

Os erros retornados no corpo da resposta incluem os seguintes campos:

• code: o código de erro HTTP numérico. Por exemplo, 403.
• message: detalhes adicionais sobre o erro. Quando disponível, a mensagem de erro é precedida por @ e um tipo de erro específico. Por exemplo, @ClassroomApiDisabled.
• status: o status da solicitação HTTP. Por exemplo, PERMISSION_DENIED ou NOT_FOUND.

Se uma solicitação falhar com um erro ClassroomApiDisabled, a resposta será esta:

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

Você pode usar o corpo da resposta para depurar a causa do erro e fornecer informações úteis aos usuários. Inclua um espaço final ao verificar uma mensagem de erro específica para evitar a correspondência de outros valores que começam com a mesma string. No exemplo de erro fornecido, você pode verificar se o campo de mensagem começa com "@ClassroomApiDisabled " para apresentar informações adequadas aos usuários.

Consulte as páginas Erros de acesso, Erros de solicitação e Erros de complementos para informações sobre alguns erros que podem ser retornados pela API Classroom.