Escolher os escopos da API Google Classroom

Este documento contém informações de autorização e autenticação específicas da API Google Sala de Aula. Antes de ler este documento, confira as informações gerais de autenticação e autorização do Google Workspace em Saiba mais sobre autenticação e autorização.

Configurar o OAuth 2.0 para autorização

Configure a tela de permissão do OAuth e escolha escopos para definir quais informações são mostradas aos usuários e revisores de apps e registre o app para poder publicá-lo mais tarde.

Escopos da API Classroom

Para definir o nível de acesso concedido ao seu app, é necessário identificar e declarar escopos de autorização. Um escopo de autorização é uma string URI do OAuth 2.0 que contém o nome do app do Google Workspace, o tipo de dados acessados e o nível de acesso. Os escopos são solicitações do app para trabalhar com dados do Google Workspace, incluindo dados da Conta do Google dos usuários.

Quando o app é instalado, o usuário precisa validar os escopos usados por ele. Em geral, escolha o escopo mais restrito possível e evite solicitar escopos que o app não precisa. Os usuários concedem acesso mais facilmente a escopos limitados e claramente descritos.

Se o aplicativo público usar escopos que permitem o acesso a determinados dados do usuário, ele precisará concluir um processo de verificação. Se você vir app não verificado na tela ao testar o aplicativo, envie uma solicitação de verificação para remover essa mensagem. Saiba mais sobre apps não verificados e encontre respostas para perguntas frequentes sobre a verificação de apps na Central de Ajuda.

A API Classroom é compatível com os seguintes escopos:

Escopos	Significado
https://www.googleapis.com/auth/classroom.addons.teacher	Ver, criar e atualizar os anexos do projeto do Google Cloud solicitante para transmitir itens nas aulas ministradas por você no Google Sala de Aula.
https://www.googleapis.com/auth/classroom.addons.student	Ver e atualizar os anexos do projeto do Google Cloud solicitante nos itens do stream no Google Sala de Aula.
https://www.googleapis.com/auth/classroom.announcements	Ver e gerenciar avisos no Google Sala de Aula.
https://www.googleapis.com/auth/classroom.announcements.readonly	Ver avisos no Google Sala de Aula.
https://www.googleapis.com/auth/classroom.courses	Ver, editar, criar e excluir permanentemente suas turmas do Google Sala de Aula.
https://www.googleapis.com/auth/classroom.courses.readonly	Acesse suas turmas do Google Sala de Aula.
https://www.googleapis.com/auth/classroom.coursework.me	Ver, criar e editar itens relacionados ao curso, incluindo atividades, perguntas e notas.
https://www.googleapis.com/auth/classroom.coursework.me.readonly	Confira as atividades e notas no Google Sala de Aula.
https://www.googleapis.com/auth/classroom.coursework.students	Gerencie as atividades e notas dos estudantes nas turmas do Google Sala de Aula que você ministra e veja as atividades e notas das turmas que você administra.
https://www.googleapis.com/auth/classroom.coursework.students.readonly	Ver as atividades e notas dos estudantes nas turmas do Google Sala de Aula que você ministra ou administra.
https://www.googleapis.com/auth/classroom.courseworkmaterials	Ver, editar e criar materiais de atividades no Google Sala de Aula.
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly	Ver todos os materiais de atividades das suas aulas do Google Sala de Aula.
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly	Ver os responsáveis do Google Sala de Aula.
https://www.googleapis.com/auth/classroom.guardianlinks.students	Ver e gerenciar os responsáveis dos estudantes nas suas aulas do Google Sala de Aula.
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly	Ver os responsáveis dos estudantes nas suas turmas do Google Sala de Aula.
https://www.googleapis.com/auth/classroom.profile.emails	Ver os endereços de e-mail das pessoas nas suas turmas.
https://www.googleapis.com/auth/classroom.profile.photos	Ver as fotos do perfil das pessoas nas suas turmas.
https://www.googleapis.com/auth/classroom.push-notifications	Receber notificações sobre os seus dados do Google Sala de Aula.
https://www.googleapis.com/auth/classroom.rosters	Gerenciar as listas das suas turmas do Google Sala de Aula.
https://www.googleapis.com/auth/classroom.rosters.readonly	Confira as listas das suas turmas do Google Sala de Aula.
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly	Confira as atividades e notas no Google Sala de Aula.
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly	Ver as atividades e notas dos estudantes nas turmas do Google Sala de Aula que você ministra ou administra.
https://www.googleapis.com/auth/classroom.topics	Ver, criar e editar tópicos no Google Sala de Aula.
https://www.googleapis.com/auth/classroom.topics.readonly	Ver tópicos no Google Sala de Aula.