Nesta página, descrevemos algumas mensagens de erro, problemas e ações possíveis comuns da API Google Classroom para os seguintes tipos de erros:
- HTTP 400:
FAILED_PRECONDITION - HTTP 403:
PERMISSION_DENIED - HTTP 429:
RESOURCE_EXHAUSTED - HTTP 500:
INTERNAL
HTTP 400: FAILED_PRECONDITION
Um FAILED_PRECONDITION é retornado quando o usuário tenta uma ação que não pode
ser permitida, seja porque o usuário atingiu um limite ou um estado de aplicativo,
como CourseNotModifiable. Para corrigir um FAILED_PRECONDITION, instrua o usuário a realizar alguma ação e tente de novo. Em alguns casos, você pode usar endpoints alternativos para corrigir o estado em nome do usuário.
AttachmentNotVisible
AttachmentNotVisible indica que um ou mais anexos especificados
não estão visíveis para o usuário, não são do tipo solicitado ou não existem. Por exemplo, itens do Drive que não foram compartilhados com o usuário retornariam esse erro.
Possível ação: descreva a causa da falha e sugira que o usuário verifique novamente os identificadores incluídos, como IDs de arquivos do Drive. Além disso, verifique se o usuário tem as permissões adequadas para acessar o anexo.
CannotRemoveCourseFolderOwner
CannotRemoveCourseFolderOwner indica que o proprietário da pasta do curso no Drive não pode ser removido.
Possível ação: descreva a causa da falha e sugira que o usuário transfira a propriedade da pasta do curso no Drive para outro usuário e tente de novo.
CannotRemoveCourseOwner
CannotRemoveCourseOwner indica que o proprietário do curso não pode ser removido.
Possível ação: descreva a causa da falha e sugira que o proprietário do curso não seja removido. Na maioria dos casos, o usuário está tentando se remover, o que não é permitido.
CannotRemoveCourseOwnerTransferIncomplete
CannotRemoveCourseOwnerTransferIncomplete indica que o proprietário do curso não pode ser removido porque a transferência de propriedade da turma ainda está em andamento.
Ação possível: descreva a causa da falha e sugira que o usuário aguarde alguns momentos para que a ação assíncrona de transferência da propriedade da turma seja concluída e tente de novo.
CannotRemoveTeacherWithNoCourseOwner
CannotRemoveTeacherWithNoCourseOwner indica que um professor não pode ser removido de um curso sem proprietário.
Possível ação: descreva a causa da falha e sugira que o professor não pode ser removido. Na maioria dos casos, a conta de usuário do proprietário do curso foi excluída, causando um estado inválido do curso.
CourseMemberLimitReached
CourseMemberLimitReached indica que a ação tentada excederia o número máximo permitido de participantes do curso. Esse código geralmente é retornado pelo
students.create()
Para mais informações, consulte a seção "Limites de tamanho da turma" do artigo da Central de Ajuda Convidar
estudantes para sua turma.
Possível ação: descreva a causa da falha e sugira que o usuário remova os participantes desnecessários do curso.
CourseNotModifiable
CourseNotModifiable indica que o curso relevante está em um estado que
não permite a modificação das propriedades (além do estado do curso
em si).
Ação possível: peça ao usuário para mudar o curso para um estado de curso
modificável. Para mudar
o estado, use
courses.patch(). O estado do curso pode ser alterado em uma solicitação que muda outras propriedades.
CourseTeacherLimitReached
CourseTeacherLimitReached indica que a ação solicitada excederia o número máximo permitido de professores do curso. Esse código normalmente é retornado pelo método teachers.create(). Para mais informações, consulte a seção "Limitações de tamanho da turma" do artigo da Central de Ajuda Adicionar um professor auxiliar a uma turma.
Possível ação: descreva a causa da falha e sugira que o usuário remova professores desnecessários do curso. Se aplicável ao seu app, use o método
teachers.delete()
para gerenciar as listas de professores em nome do usuário.
CourseTitleCannotContainUrl
CourseTitleCannotContainUrl indica que a ação solicitada não é permitida porque introduziria um URL no título do curso. Os padrões de URL não são aceitos em títulos de cursos.
Ação possível: descreva a causa da falha e sugira que o usuário remova o padrão do URL do campo title. URLs são permitidos no campo
description.
CourseTopicLimitReached
CourseTopicLimitReached indica que a ação solicitada excederia o número máximo permitido de tópicos em um curso. Esse código normalmente é retornado pelo método courses.topics.create().
Possível ação: descreva a causa da falha e sugira que o usuário remova tópicos desnecessários. Se aplicável ao seu app, use o método
courses.topics.delete()
para gerenciar temas em nome do usuário.
EmptyAssignees
EmptyAssignees indica que a ação solicitada removeria todos os estudantes
das atividades correspondentes. As atividades sem atribuições não são aceitas.
Ação possível: descreva a causa da falha e sugira que o proprietário do curso não pode remover todos os estudantes atribuídos.
InactiveCourseOwner
InactiveCourseOwner: indica que a ação solicitada não é permitida porque a conta do proprietário do curso foi excluída. O administrador do proprietário do curso precisa restaurar a conta dele antes de realizar a ação solicitada.
Possível ação: descreva a causa da falha e sugira que o administrador restaure a conta do proprietário do curso antes de tentar novamente a operação.
IneligibleOwner
IneligibleOwner indica que o usuário não pode ser adicionado como proprietário do curso porque não é um professor auxiliar.
Ação possível: descreva a causa da falha. Se o usuário solicitante não for um administrador, sugira que ele envie um convite para o usuário ser professor no curso antes de atualizar o proprietário. Se o usuário solicitante for um administrador, sugira que ele adicione o usuário como professor auxiliar do curso.
ListCoursesStudentAndTeacherFilter
ListCoursesStudentAndTeacherFilter ocorre ao fazer uma
solicitação courses.list() com os campos
teacherId e studentId preenchidos. Apenas um desses campos pode ser definido em uma única solicitação.
Você ainda pode receber uma lista de cursos com usuários específicos de estudantes e professores
fazendo duas solicitações separadas. Primeiro, recupere os cursos do usuário professor fazendo uma solicitação courses.list() com o campo teacherId preenchido e, em seguida, faça outra solicitação courses.list() com o campo studentId preenchido.
Calcule a interseção dos resultados para obter a lista de cursos que correspondem aos dois usuários.
PendingInvitationExists
PendingInvitationExists indica que alguém já foi convidado para assumir a propriedade do curso. Esse erro ocorre durante a transferência de propriedade do curso quando
uma transferência foi iniciada anteriormente, mas ainda não foi aceita pelo novo
proprietário.
UserCannotOwnCourse
UserCannotOwnCourse indica que o usuário não pode ser adicionado como proprietário do curso.
Ação possível: descreva a causa da falha e sugira que o curso não pode ser criado com o usuário como proprietário. Um usuário sem privilégios de administrador pode receber esse erro se tentar criar um curso com um usuário diferente dele como proprietário. Um administrador que solicita um usuário pode receber esse erro se a conta de usuário especificada como proprietário não existir ou se o usuário não estiver no domínio dele.
UserGroupsMembershipLimitReached
UserGroupsMembershipLimitReached indica que o usuário já é membro do número máximo permitido de grupos e não pode participar de nenhum curso. Esse código geralmente é retornado por students.create() ou teachers.create().
Para mais informações, consulte a seção "Limitações de tamanho da turma" do artigo da Central de Ajuda Convidar estudantes para uma turma.
Ação possível: descreva a causa da falha e sugira que o usuário
saia dos cursos em que não está participando. O usuário pode criar uma conta adicional se precisar participar de mais cursos. Se aplicável ao seu app, use students.create() ou teachers.delete() para gerenciar as listas em nome do usuário.
HTTP 403: PERMISSION_DENIED
Todos os métodos da API Classroom podem retornar um erro PERMISSION_DENIED (HTTP 403)
se um usuário final não atender aos pré-requisitos de acesso. A mensagem
que acompanha o erro contém uma mensagem de erro para ajudar você a identificar a
causa e orientar os usuários a realizar a ação adequada.
As seções a seguir descrevem mensagens de erro comuns da API Classroom.
CannotDirectAddUser
CannotDirectAddUser indica que um usuário não pode ser adicionado diretamente ao curso. Esse código aparece quando um administrador de domínio tenta adicionar um usuário a um
curso e esse usuário não tem um endereço de e-mail ou não pertence ao
domínio.
Ação possível: descreva a causa da falha e sugira que o administrador do domínio verifique se a conta de usuário existe e está no domínio do administrador do curso.
CannotInviteUserInUntrustedDomain
CannotInviteUserInUntrustedDomain indica que o usuário convidado ou criado não está no mesmo domínio ou em um domínio confiável do autor da chamada. Para quem tem uma licença do Google Workspace for Education Fundamentals, não é possível adicionar ou convidar diretamente usuários de fora do domínio que não são confiáveis para um curso.
Ação possível: descreva a causa da falha e sugira que o autor da chamada considere uma das seguintes opções:
- Inclua os domínios dos usuários que fazem e recebem chamadas na lista de domínios confiáveis uns dos outros e tente de novo.
- Sugira que o usuário compartilhe manualmente um link de convite do curso ou um código da turma. Observação: isso exige que um administrador configure convites fora do domínio. Consulte Convidar estudantes para sua turma para saber mais.
- Sugira que o usuário faça upgrade para uma licença paga do Google Workspace for Education, já que a limitação se aplica apenas à licença do Fundamentals.
ClassroomApiDisabled
ClassroomApiDisabled indica que o usuário solicitante não tem acesso
à API Classroom.
Possível ação: direcione o usuário para as instruções sobre como ativar o acesso aos dados do Google Sala de Aula. Consulte também ClassroomDisabled, já que o usuário pode estar usando a conta errada.
ClassroomDisabled
ClassroomDisabled indica que o usuário solicitante não tem acesso ao Google Sala de Aula.
Possível ação: direcione o usuário para as instruções sobre como ativar o acesso ao Google Sala de Aula. O usuário também pode estar usando a conta errada. Por isso, forneça um link para usar várias contas para que ele possa selecionar a conta correta.
ExpiredAddOnToken
ExpiredAddOnToken indica que o token do complemento usado para fazer chamadas para
a API expirou.
Ação possível: peça ao usuário para atualizar a página ou fazer login no complemento
de novo para que você possa receber o novo parâmetro de consulta addOnToken do
URL da solicitação.
InvalidAddOnToken
InvalidAddOnToken indica que o token de complemento transmitido em uma solicitação não tem autorização para criar um anexo de complemento na atividade.
Possível ação: esse erro pode ocorrer se o usuário fizer login no complemento com uma conta diferente da conta no Google Sala de Aula. Peça ao usuário para sair de todas as outras contas no navegador ou abrir o Google Sala de Aula em uma janela anônima do Chrome.
ProjectPermissionDenied
ProjectPermissionDenied indica que a solicitação tentou modificar um recurso associado a um projeto diferente do Developer Console.
Ação possível: indique que seu aplicativo não pode fazer a solicitação pretendida. Ela só pode ser feita pelo projeto do console de desenvolvedores do ID do cliente OAuth que criou o recurso.
UserIneligibleToUpdateGradingPeriodSettings
UserIneligibleToUpdateGradingPeriodSettings indica que a solicitação tentou modificar as configurações do período de avaliação em um curso em que o usuário solicitante ou o proprietário do curso não tem a licença adequada do Google Workspace for Education ou o usuário solicitante não é professor do curso nem administrador do domínio.
Ação possível: indique que seu aplicativo não pode fazer a solicitação pretendida para atualizar as configurações do período de avaliação devido ao status da função de licenciamento ou do curso. As licenças podem ser atribuídas no Google Admin Console.
HTTP 429: RESOURCE_EXHAUSTED
O RESOURCE_EXHAUSTED é retornado quando a ação solicitada não é permitida
porque algum recurso, como cota ou capacidade do servidor, está esgotado. Esses
tipos de erros de solicitação geralmente ocorrem porque o app gerou uma carga
excessiva.
Para evitar acionar esses limites e aumentar a confiabilidade do seu aplicativo, use mecanismos de nova tentativa. Os mecanismos de nova tentativa válidos incluem:
Use a espera exponencial truncada para repetir a solicitação e maximizar a capacidade de processamento de solicitações em ambientes simultâneos.
Para evitar colisões, considere a espera exponencial truncada com instabilidade. A introdução de jitter pode ajudar suas solicitações a serem concluídas mais rapidamente, introduzindo um atraso aleatório que distribui picos de solicitações.
Se o aplicativo retornar erros RESOURCE_EXHAUSTED devido a limitações de cota, envie um pedido de aumento. Para mais informações, consulte o artigo da Central de Ajuda Monitorar cotas de API.
UserCourseJoinRateLimitReached
UserCourseJoinRateLimitReached indica que o usuário já se inscreveu no
número máximo permitido de cursos em um dia. Para mais informações, consulte a seção "Convites e tamanho do grupo" do artigo da Central de Ajuda Entender as políticas e os limites do Grupos.
Possível ação: descreva a causa da falha e sugira que o usuário espere um dia antes de se inscrever no curso.
HTTP 500: INTERNAL
INTERNAL indica que ocorreu um erro inesperado ao processar a solicitação. Os erros de solicitação INTERNAL também podem ser resolvidos usando a espera exponencial para repetir a solicitação. Se um erro INTERNAL persistir, ele poderá ser
informado registrando um bug no Issue Tracker público da API Classroom.