Projetos do Google Cloud

Todos os projetos do Apps Script usam o Google Cloud para gerenciar autorizações, serviços avançados e outros detalhes. Para definir e gerenciar essas configurações, cada projeto do Apps Script tem um projeto do Google Cloud associado. Seu projeto de script pode usar um projeto padrão que o Apps Script cria automaticamente ou um projeto padrão que você mesmo cria. Em geral, os projetos padrão são bons para scripts simples ou diários, mas você deve usar um projeto padrão para qualquer aplicativo que seja complexo, de qualidade comercial ou que você pretenda publicar.

É possível alternar de um projeto padrão para um padrão a qualquer momento, mas não é possível voltar a usar um projeto padrão. É melhor selecionar o projeto do Cloud que seu script usa no início do desenvolvimento. Mudar isso mais tarde pode causar complicações, como exigir que os usuários autorizem novamente.

Projetos padrão do Cloud

Quando você cria um projeto do Apps Script, ele cria um projeto do Cloud padrão que opera em segundo plano.

  • Na maioria dos scripts, você não precisa conferir nem ajustar esse projeto padrão. O script do app processa as interações necessárias com o Google Cloud. Por exemplo, se você ativar um serviço avançado no editor do Apps Script, o Apps Script vai ativar o serviço avançado no projeto padrão do Cloud quando você salvar o projeto do script.
  • Para alguns scripts, é necessário interagir com o console do Google Cloud. Nesses casos, o script precisa usar um projeto padrão do Cloud. Por exemplo, para conferir os registros do Google Cloud no console do Google Cloud, seu script precisa usar um projeto padrão.

Por padrão, os projetos do Cloud têm uma política de gerenciamento de identidade e acesso (IAM) com uma entrada, uma conta de serviço do Google que atua como proprietário do projeto padrão. A conta de serviço do Google é appsdev-apps-dev-script-auth@system.gserviceaccount.com.

Acessar ou atualizar projetos padrão do Cloud

A maioria dos usuários não consegue localizar, visualizar ou editar projetos padrão no console do Google Cloud. Se você for administrador, consulte Acessar projetos padrão do Google Cloud.

Se você criou o projeto de script antes de 8 de abril de 2019, use um projeto padrão que pode ser acessado no console do Google Cloud. Para acessar o projeto padrão, acesse as configurações do projeto de script e clique no número do projeto.

Excluir projetos padrão do Cloud

Se você for administrador, poderá excluir projetos padrão do Cloud da mesma forma que faria com projetos padrão do Cloud. Consulte Excluir projetos do Apps Script no Cloud.

Se você não for um administrador, não poderá excluir projetos padrão. No entanto, o Apps Script exclui projetos padrão nos seguintes cenários:

  • Se você excluir o projeto do script ou mudar para um projeto padrão, o Apps Script vai excluir o projeto padrão anexado ao script e todas as configurações ou informações que ele contém.
  • Se um script não for executado por 180 dias ou mais, o projeto padrão associado será excluído pelo Apps Script. Se o script for executado depois que o Apps Script excluir o projeto padrão, ele vai criar um para o script.

Projetos padrão do Cloud

Os projetos padrão do Cloud são a melhor opção para a maioria dos projetos de script, a menos que você precise configurar o projeto manualmente. Nessas situações, é necessário alternar o projeto do script para usar um projeto padrão.

As seções a seguir descrevem quando o Apps Script exige um projeto padrão, as propriedades desses projetos e as tarefas comuns realizadas com eles. Só é possível realizar as tarefas abaixo com projetos padrão.

Quando o Apps Script exige projetos padrão do Cloud

Use um projeto padrão nas seguintes situações:

Propriedades padrão do projeto do Cloud

Projetos padrão têm as seguintes propriedades:

  • É possível acessar todas as configurações do Google Cloud para o projeto diretamente no console do Google Cloud. Assim, você pode ativar APIs, ajustar credenciais de autorização e configurar outros detalhes.
  • Quando você exclui um projeto de script ou muda para usar outro projeto padrão, o projeto padrão original permanece e pode ser reutilizado.
  • Ao ativar um serviço avançado em um projeto de script, é necessário ativar manualmente a API correspondente no projeto padrão.
  • Vários projetos de script e outros apps podem compartilhar o mesmo projeto padrão. Se você pretende publicar um projeto de script no Google Workspace Marketplace como um complemento, ele precisa ter o próprio projeto padrão. Apps publicados não podem compartilhar projetos do Cloud com outros apps.
  • Se você quiser executar funções em um projeto de script de outro app usando o método scripts.run da API do Apps Script, o projeto de script e o aplicativo de chamada precisam compartilhar o mesmo projeto padrão.
  • Quando o Apps Script solicita que um usuário autorize um script que usa um projeto padrão, o nome do projeto do Cloud é usado para identificar o script (não o nome do projeto do script). Por isso, defina um nome apropriado para o projeto do Cloud.

Acessar um projeto padrão do Cloud

Para acessar o projeto padrão associado ao seu projeto de script, faça o seguinte:

  1. Abra o projeto do Apps Script.
  2. À esquerda, clique em Configurações do projeto .
  3. Em Projeto do Google Cloud Platform (GCP), clique no número do projeto.

Também é possível encontrar um projeto padrão diretamente na página Gerenciar recursos do console do Google Cloud.

Ativar uma API em um projeto padrão do Cloud

Muitas vezes, um app do Apps Script precisa ter acesso a outra API do Google. Para fazer isso, ative a API no projeto correspondente do Cloud. Para ativar uma API, faça o seguinte:

  1. Abra o projeto do Cloud.
  2. Clique em Menu > APIs e serviços.
  3. Clique em Ativar APIs e serviços.
  4. Na caixa de pesquisa, digite a API que você quer ativar e pressione Enter.
  5. Clique na API nos resultados da pesquisa e, em seguida, em Ativar para ativar a API para este projeto do Cloud.

Talvez seja necessário aceitar os Termos de Serviço das APIs do Google ou do Google Cloud. Leia os Termos de Serviço com atenção antes de aceitá-los.

Dependendo do aplicativo, talvez seja necessário configurar a API selecionando-a no painel APIs e serviços.

Determinar o ID e o número de um projeto padrão do Cloud

Todos os projetos do Cloud têm um nome, ID e número de projeto. Às vezes, é necessário ter esses identificadores para configurar serviços ou concluir outras tarefas.

Para determinar o ID e o número do projeto padrão, faça o seguinte:

  1. Abra o projeto do Cloud.
  2. No canto superior direito, clique em Mais > Configurações do projeto.
  3. Confira o nome, o ID e o número do projeto no painel Configurações. O número do projeto consiste apenas de dígitos, enquanto o ID do projeto é alfanumérico. É possível editar o nome do projeto, que aparece para os usuários durante solicitações de autorização.

Acessar os registros e relatórios de erros do Google Cloud no console do Google Cloud

Se você estiver usando o registro do Google Cloud ou o Relatório de erros para seu projeto de script, poderá conferir esses registros e relatórios no console do Google Cloud. Para isso, faça o seguinte:

  1. Abra o projeto do Cloud.
  2. Clique no menu .
  3. Role para baixo até a seção Operações e clique em Logging > Análise de registros.
  4. Para conferir os relatórios de erros, role a tela para baixo até a seção Operações e clique em Relatório de erros. Se você receber uma solicitação para configurar o Error Reporting, isso significa que seu projeto de script ainda não registrou nenhuma exceção.

Ao usar serviços que exigem OAuth, o Google solicita que os usuários autorizem esses serviços. As configurações da tela de consentimento OAuth permitem definir algumas das informações que o Google apresenta aos usuários, como o nome do aplicativo e o URL dos Termos de Serviço.

Os projetos padrão do Cloud criam uma tela de consentimento automaticamente com base nos detalhes do projeto do Apps Script. Não é possível ajustar essas configurações. Os projetos padrão do Cloud permitem personalizar essas informações. Para configurar a tela de consentimento do script, faça o seguinte:

  1. Abra o projeto do Cloud.
  2. Clique em Menu > APIs e serviços > Credenciais.
  3. Clique em Configurar tela de consentimento.
  4. Preencha cada seção do fluxo de trabalho da tela de consentimento.
  5. Para registrar as alterações em cada estágio do fluxo de trabalho, clique em Salvar e continuar.

Crie credenciais do OAuth.

O Apps Script geralmente configura o OAuth para os serviços usados pelo script. Para alguns aplicativos, você precisa criar credenciais adicionais do OAuth (IDs e chaves secretas do cliente). Isso só é possível com projetos padrão.

Para criar um ID e uma chave secreta do cliente para seu projeto de script, faça o seguinte:

  1. Abra o projeto do Cloud.
  2. Clique em Menu > APIs e serviços > Credenciais.
  3. Clique em Criar credenciais > ID do cliente OAuth.
  4. Em Tipo de aplicativo, selecione o tipo de aplicativo e preencha o formulário resultante, se necessário. Quando terminar, clique em Criar.
  5. Na caixa de diálogo exibida, clique em Fazer o download do JSON. É possível usar esse arquivo para configurar o OAuth.

Adicionar outros proprietários a um projeto padrão do Cloud

É possível adicionar proprietários ou outras funções a um projeto padrão. Se você estiver colaborando em um projeto, isso ajuda a garantir que alguém da sua equipe sempre tenha acesso às configurações do Google Cloud do projeto de script.

Para adicionar proprietários ou outras funções a um projeto padrão, faça o seguinte: Você precisa ter permissões de edição para fazer qualquer uma destas mudanças:

  1. Determine quem devem ser seus colaboradores. Recomendamos que você crie ou use um grupo do Google. Também é possível especificar domínios na lista de colaboradores para incluir todos os usuários nesse domínio.
  2. Abra o projeto do script no Cloud.
  3. Clique em Menu > IAM e admin > IAM.
  4. Na parte de cima, clique em Adicionar.
  5. Siga as instruções na tela para adicionar um ou mais novos membros e as respectivas funções ao projeto do Cloud. É possível adicionar e-mails individuais, Grupos do Google ou domínios como novos membros.
  6. Clique em Salvar.

Agrupar vários scripts em um único projeto do Cloud

É possível ter vários projetos do Apps Script que compartilham o mesmo projeto padrão do Cloud. Para fazer isso, crie um projeto padrão e troque em cada projeto de script para usá-lo. Isso não é possível com projetos padrão.

Usar um projeto padrão do Cloud diferente

É possível mudar um projeto de script para que ele use um projeto padrão do Cloud diferente. Se o script exigir a configuração manual do projeto do Cloud, será necessário alternar de um projeto padrão para um padrão. Para saber mais sobre quando você precisa usar um projeto padrão, consulte projetos padrão do Cloud.

Efeitos de mudar para um projeto padrão diferente do Cloud

Se você mudar o script de um projeto padrão ou para um projeto padrão diferente, isso terá os seguintes efeitos:

  • Se você tiver ativado serviços avançados para o script, ative as APIs correspondentes no novo projeto do Cloud. Você perde todos os dados vinculados aos serviços avançados no projeto do Cloud anterior. Para saber como ativar as APIs no seu projeto do Cloud, consulte Ativar as APIs do Google Workspace.
  • Se o script usar o serviço integrado do Google Drive, ative a API Drive em projetos padrão do Cloud.

    No projeto padrão do Cloud, ative a API Drive:

    Ativar a API Drive

  • Todos os usuários que autorizaram o script anteriormente precisam fazer isso novamente. Na maioria dos casos, todos os usuários que já autorizaram apps associados ao novo projeto também precisam fazer a autorização novamente.
  • Se o script estiver associado a uma página "Detalhes do app" no Google Workspace Marketplace, a página, os usuários e as avaliações não serão transferidos para o novo projeto. Você precisa criar uma página "Detalhes do app" no novo projeto, e os usuários precisarão reinstalá-lo. Para informações sobre como criar uma nova página "Detalhes do app", consulte Publicar um app.
  • Não é possível mudar um script para um projeto padrão. O Apps Script exclui projetos padrão depois que você define o script para usar um projeto padrão.

Mudar para um projeto padrão diferente do Cloud

Para mudar o projeto do Cloud de um script para outro, siga estas etapas:

  1. Se você não tiver um projeto do Cloud adequado, crie um seguindo as instruções de Criar um projeto. Defina um nome de projeto fácil de lembrar para que você possa encontrá-lo na página Gerenciar recursos do console do Google Cloud. O Apps Script usa esse nome quando solicita que os usuários autorizem o script.
  2. Se você quiser usar um projeto atual, abra a página Gerenciar recursos do console do Google Cloud e localize um projeto para usar. Você precisa ter os papéis de Navegador do projeto e Editor de configuração do OAuth ou papéis com permissões equivalentes para o projeto. Não é possível usar um projeto criado automaticamente pelo Apps Script.
  3. Determine o número do projeto do seu projeto do Cloud.
  4. Abra o script do projeto do Cloud que você quer substituir.
  5. À esquerda, clique em Configurações do projeto .
  6. Em Projeto do Google Cloud Platform (GCP), clique em Mudar projeto.
  7. Digite o novo número do projeto e clique em Definir projeto.

Projetos em nuvem e drives compartilhados

Os drives compartilhados (antes conhecidos como "Drives de equipe") oferecem espaços compartilhados em que grupos de usuários do Drive podem colaborar em projetos do Apps Script e documentos do Drive. Os drives compartilhados são valiosos ao desenvolver scripts, complementos e apps da Web com uma equipe, mas eles impõem algumas restrições ao que você pode fazer com projetos do Cloud padrão mais antigos.

A lista de restrições a seguir descreve como os projetos do Cloud interagem com unidades compartilhadas:

  • Se o projeto de script usar um projeto padrão, não haverá outras restrições quando o projeto de script estiver em um drive compartilhado.
  • Se o projeto de script usar um projeto padrão criado a partir de 8 de abril de 2019, não haverá outras restrições quando o projeto de script estiver em um drive compartilhado.
  • Se o projeto de script usar um projeto padrão criado antes de 8 de abril de 2019, as seguintes restrições serão aplicadas enquanto o projeto de script estiver em um drive compartilhado:
    1. Não é possível acessar o projeto padrão usando a interface do Apps Script ou o console do Google Cloud. Essa restrição impede que você realize ações que exigem acesso direto ao projeto.
    2. Não é possível ativar os serviços avançados. Para ativar os serviços avançados, mude para um projeto padrão.
    3. Quando você move um projeto do Apps Script para um drive compartilhado, o Google restringe o acesso ao projeto padrão do Cloud. Ainda será possível acessar o projeto padrão, se você teve acesso antes da mudança. Por exemplo, se você criou um script na pasta "Meu Drive" e o moveu para um drive compartilhado, ainda poderá acessar o projeto do Cloud do script. Seus colaboradores no drive compartilhado talvez não consigam.
    4. Um script mantém o nome do projeto do Cloud que tinha antes de ser movido para um drive compartilhado. Mesmo que você mude o nome do projeto no drive compartilhado, os usuários que autorizam o script ainda vão ver o nome antigo nas caixas de diálogo de autorização.

Para evitar as restrições acima para scripts mais antigos, mude para um projeto padrão.

Acessar uma lista de projetos do Apps Script Cloud

Se você tiver a permissão resourcemanager.projects.list para a pasta de projetos do Apps Script da sua organização, poderá acessar todos os projetos padrão e padrão do Apps Script Cloud na pasta.

  1. Abra a página Gerenciar recursos no console do Google Cloud.
  2. Ao lado da pasta Apps Script, copie o ID.
  3. Clique em Filtrar > ID pai e cole o ID da pasta do Apps Script.

Excluir projetos do Apps Script Cloud

Para excluir um projeto do Apps Script Cloud, siga as etapas em Acessar uma lista de projetos do Apps Script Cloud, selecione o projeto que você quer excluir e clique em Excluir.

Para excluir um projeto do Apps Script usando gcloud, use os seguintes comandos.

gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID

Para mais informações sobre como excluir projetos do Cloud, consulte Como encerrar (excluir) projetos.