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

Crie um Google Apps Script que faça solicitações à API Google Slides.

Os guias de início rápido explicam como configurar e executar um app que chama uma API do Google Workspace. Este guia usa uma abordagem de autenticação simplificada adequada para um ambiente de teste. Para um ambiente de produção, recomendamos aprender sobre autenticação e autorização antes de escolher as credenciais de acesso adequadas para seu app.

No Apps Script, os guias de início rápido do Google Workspace usam os serviços avançados do Google para chamar as APIs do Google Workspace e processar alguns detalhes do fluxo de autenticação e autorização.

Objetivos

  • Configurar o ambiente.
  • Criar e configurar o script.
  • Executar o script.

Pré-requisitos

  • Uma Conta do Google
  • Acesso ao Google Drive

Criar o script

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

slides/quickstart/quickstart.gs
/**
 * Creates a Slides API service object and logs the number of slides and
 * elements in a sample presentation:
 * https://docs.google.com/presentation/d/1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc/edit
 */
function logSlidesAndElements() {
  const presentationId = "1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc";
  try {
    // Gets the specified presentation using presentationId
    const presentation = Slides.Presentations.get(presentationId);
    const slides = presentation.slides;
    // Print the number of slides and elements in presentation
    console.log("The presentation contains %s slides:", slides.length);
    for (let i = 0; i < slides.length; i++) {
      console.log(
        "- Slide # %s contains %s elements.",
        i + 1,
        slides[i].pageElements.length,
      );
    }
  } catch (err) {
    // TODO (developer) - Handle  Presentation.get() exception from Slides API
    console.log("Failed to found Presentation with error %s", err.message);
  }
}

  1. Clique em Salvar .
  2. Clique em Projeto sem título, digite Quickstart e clique em Renomear.

Configurar o script

Ativar a API Google Slides

Abra o projeto do Apps Script.

  1. Clique em Editor .
  2. Ao lado de Serviços, clique em Adicionar um serviço .
  3. Selecione a API Google Slides e clique em Adicionar.

Executar a amostra

No editor de script do Apps Script, clique em Executar.

Na primeira vez que você executar a amostra, será solicitado que você autorize o acesso:

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

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

Próximas etapas