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, leia 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
Configurar a tela de consentimento do OAuth e escolher escopos para definir quais informações são exibidas para usuários e revisores de apps e registrar seu app para poder publicá-lo mais tarde.
Escopos da API Classroom
Para definir o nível de acesso concedido ao app, é necessário identificar e declarar os escopos de autorização. Um escopo de autorização é uma string de URI OAuth 2.0 que contém o nome do app do Google Workspace, o tipo de dados que ele acessa e o nível de acesso. Os escopos são as 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. Geralmente, escolha o escopo mais restrito possível e evite solicitar escopos que não são necessários para o app. Os usuários concedem mais acesso a escopos limitados e claramente descritos.
A API Classroom é compatível com os seguintes escopos:
| Escopos | Significado |
|---|---|
https://www.googleapis.com/auth/classroom.addons.teacher
|
Acessar, criar e atualizar os anexos do projeto do Google Cloud solicitante para transmitir itens nas aulas que você ministra no Google Sala de Aula. |
https://www.googleapis.com/auth/classroom.addons.student
|
Confira e atualize os anexos do projeto do Google Cloud que está solicitando para transmitir itens no Google Sala de Aula. |
https://www.googleapis.com/auth/classroom.announcements
|
Veja e gerencie avisos no Google Sala de Aula. |
https://www.googleapis.com/auth/classroom.announcements.readonly
|
Acessar avisos no Google Sala de Aula. |
https://www.googleapis.com/auth/classroom.courses
|
Acessar, editar, criar e excluir permanentemente suas turmas do Google Sala de Aula. |
https://www.googleapis.com/auth/classroom.courses.readonly
|
Acessar suas turmas do Google Sala de Aula. |
https://www.googleapis.com/auth/classroom.coursework.me
|
Ver, criar e editar itens do curso, incluindo atividades, perguntas e notas. |
https://www.googleapis.com/auth/classroom.coursework.me.readonly
|
Acessar as notas e atividades no Google Sala de Aula. |
https://www.googleapis.com/auth/classroom.coursework.students
|
Gerencie as atividades e notas dos alunos nas turmas do Google Sala de Aula que você ministra e confira as atividades e notas das turmas que você administra. |
https://www.googleapis.com/auth/classroom.coursework.students.readonly
|
Veja as atividades e notas dos alunos nos cursos do Google Sala de Aula ministrados ou administrados por você. |
https://www.googleapis.com/auth/classroom.courseworkmaterials
|
Acessar, editar e criar materiais de atividades no Google Sala de Aula. |
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly
|
Confira todos os materiais de atividades das suas turmas do Google Sala de Aula. |
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly
|
Acesse os responsáveis do Google Sala de Aula. |
https://www.googleapis.com/auth/classroom.guardianlinks.students
|
Acessar e gerenciar os responsáveis dos alunos nas suas turmas do Google Sala de Aula. |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
|
Acessar os responsáveis dos alunos nas suas turmas do Google Sala de Aula. |
https://www.googleapis.com/auth/classroom.profile.emails
|
Acessar 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 seus dados do Google Sala de Aula. |
https://www.googleapis.com/auth/classroom.rosters
|
Gerenciar as listas de estudantes das suas turmas do Google Sala de Aula. |
https://www.googleapis.com/auth/classroom.rosters.readonly
|
Acesse as listas de estudantes das suas turmas do Google Sala de Aula. |
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly
|
Confira suas atividades e notas no Google Sala de Aula. |
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
|
Acessar as tarefas e notas dos alunos nas aulas do Google Sala de Aula ministradas por você. |
https://www.googleapis.com/auth/classroom.topics
|
Acessar, 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 |