Escolher os escopos da API Google Classroom

Este documento contém informações de autorização e autenticação específicas da API Google Classroom. 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

Configure a tela de permissão OAuth e escolha escopos para definir quais informações serão exibidas aos usuários e revisores de apps e registre seu app para 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 do 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 os dados do Google Workspace, incluindo os dados da Conta do Google dos usuários.

Quando seu app é instalado, o usuário precisa validar os escopos usados pelo app. Em geral, é preciso escolher o escopo mais restrito possível e evitar a solicitação de escopos que seu app não exige. Os usuários concedem acesso a escopos limitados e claramente descritos.

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

Escopos Significado
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 Ver 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 Ver as atividades e notas no Google Sala de Aula.
https://www.googleapis.com/auth/classroom.coursework.students Gerenciar as atividades e notas dos alunos nas aulas do Google Sala de Aula ministradas por você e ver as atividades e notas das aulas que você administra.
https://www.googleapis.com/auth/classroom.coursework.students.readonly Ver as atividades e notas dos alunos nas aulas do Google Sala de Aula que você ministra ou administra.
https://www.googleapis.com/auth/classroom.courseworkmaterials Acesse, edite e crie 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 Veja seus responsáveis no Google Sala de Aula.
https://www.googleapis.com/auth/classroom.guardianlinks.students Ver e gerenciar os responsáveis dos alunos nas suas aulas do Google Sala de Aula.
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly Ver os responsáveis dos alunos 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 de perfil das pessoas nas suas turmas.
https://www.googleapis.com/auth/classroom.push-notifications Receba notificações sobre seus dados do Google Sala de Aula.
https://www.googleapis.com/auth/classroom.rosters Gerencie as listas de nomes das suas turmas do Google Sala de Aula.
https://www.googleapis.com/auth/classroom.rosters.readonly Ver as listas de nomes das suas turmas do Google Sala de Aula
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly Ver 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 alunos nas aulas 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