Serviço do Sala de Aula

gerenciar cursos e listas de nomes.

O serviço do Google Classroom permite usar a API Google Classroom no Google Apps Script. Essa API oferece aos administradores, professores e alunos a capacidade de visualizar e gerenciar cursos e listas de nomes.

Esse é um serviço avançado que precisa ser ativado antes do uso. Siga o início rápido para conferir instruções detalhadas sobre como começar.

Referência

Para informações detalhadas sobre esse serviço, consulte a documentação de referência para a API Classroom. Assim como todos os serviços avançados no Apps Script, o serviço do Classroom usa os mesmos objetos, métodos e parâmetros que a API pública. Para mais informações, consulte Como as assinaturas de método são determinadas.

Para informar problemas e encontrar outros tipos de suporte, consulte o guia de suporte do Classroom.

Exemplo de código

O exemplo de código a seguir usa a versão 1 da API.

Listar cursos

Este exemplo lista os dez primeiros cursos que o usuário tem acesso.

advanced/classroom.gs

Ver no GitHub

/**
 * Lists 10 course names and IDs.
 */
function listCourses() {
  /**
   * @see https://developers.google.com/classroom/reference/rest/v1/courses/list
   */
  const optionalArgs = {
    pageSize: 10,
    // Use other query parameters here if needed.
  };
  try {
    const response = Classroom.Courses.list(optionalArgs);
    const courses = response.courses;
    if (!courses || courses.length === 0) {
      console.log("No courses found.");
      return;
    }
    // Print the course names and IDs of the available courses.
    for (const course in courses) {
      console.log("%s (%s)", courses[course].name, courses[course].id);
    }
  } catch (err) {
    // TODO (developer)- Handle Courses.list() exception from Classroom API
    console.log("Failed with error %s", err.message);
  }
}