Guia de início rápido do Google Apps Script

Os guias de início rápido explicam como configurar e executar um app que chama uma API do Google Workspace.

Os guias de início rápido do Google Workspace usam as bibliotecas de cliente da API para processar alguns detalhes do fluxo de autenticação e autorização. Recomendamos que você use as bibliotecas de cliente para seus próprios aplicativos. Neste guia de início rápido, usamos uma abordagem de autenticação simplificada, apropriada para um ambiente de teste. Para um ambiente de produção, recomendamos que você aprenda sobre autenticação e autorização antes de escolher as credenciais de acesso apropriadas para seu aplicativo.

Crie um script do Google Apps que faça solicitações à Google Classroom API.

Objetivos

  • Crie o script.
  • Ative a API Google Classroom.
  • Execute a amostra.

Pré-requisitos

  • Uma conta do Google for Education com o Google Sala de Aula ativado.

  • Acesso ao Google Drive

Criar o script

  1. Acesse script.google.com/create e crie um novo script.
  2. Substitua o conteúdo do editor de script pelo seguinte código:

sala de aula/início rápido/início rápido.gs
/**
 * Lists 10 course names and ids.
 */
function listCourses() {
  /**  here pass pageSize Query parameter as argument to get maximum number of result
   * @see https://developers.google.com/classroom/reference/rest/v1/courses/list
   */
  const optionalArgs = {
    pageSize: 10
    // Use other parameter here if needed
  };
  try {
    // call courses.list() method to list the courses in classroom
    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 courses
    for (const course of courses) {
      console.log('%s (%s)', course.name, course.id);
    }
  } catch (err) {
    // TODO (developer)- Handle Courses.list() exception from Classroom API
    // get errors like PERMISSION_DENIED/INVALID_ARGUMENT/NOT_FOUND
    console.log('Failed with error %s', err.message);
  }
}

  1. Clique em Salvar .
  2. Clique em Untitled project, digite Quickstart e clique em Rename.

Ativar a Google Classroom API

  1. Abra o projeto do Apps Script.
  2. Clique em Editor .
  3. Ao lado de Serviços, clique em Adicionar um serviço .
  4. Selecione a API Google Classroom e clique em Adicionar.

Executar a amostra

No editor do Apps Script, clique em Executar.

Na primeira vez que você executar a amostra, ela solicitará que você autorize o acesso:

  1. Clique em Revisar permissões.
  2. Escolha uma conta.
  3. Clique em Permitir.

O registro de execução do script aparece na parte inferior da janela.

Próximas etapas