Projetos do Google Cloud

Todos os projetos do Google Apps Script usam o Google Cloud para gerenciar autorizações, serviços avançados e outros detalhes. Para configurar 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ê cria por conta própria. Em geral, os projetos padrão são adequados para scripts do dia a dia, mas você deve usar um projeto padrão para qualquer aplicativo complexo, de qualidade comercial ou que você pretende publicar.

É possível mudar de um projeto padrão para um projeto comum a qualquer momento, mas não é possível voltar a usar um projeto padrão. É melhor selecionar o projeto na nuvem que seu script usa no início do desenvolvimento. Mudar depois 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 padrão na nuvem que opera em segundo plano.

  • Para a maioria dos scripts, você nunca precisa ver ou ajustar esse projeto padrão. O Apps Script 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 na nuvem padrão quando você salvar o projeto de script.
  • Para alguns scripts, é necessário interagir com o console do Google Cloud. Nesses casos, o script precisa usar um projeto na nuvem padrão. Por exemplo, para ver 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 do Identity and Access Management (IAM) com uma entrada, uma conta de serviço do Google que atua como proprietária do projeto padrão. A conta de serviço do Google é appsdev-apps-dev-script-auth@system.gserviceaccount.com.

Ver ou atualizar projetos padrão do Cloud

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

Se você criou seu projeto de script antes de 8 de abril de 2019, talvez esteja usando 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 projetos padrão. Consulte Acessar ou editar projetos padrão do Cloud.

Usuários sem função de administrador não podem excluir manualmente projetos padrão. No entanto, se você excluir o projeto de script ou mudar para um projeto padrão, o Apps Script vai excluir o projeto padrão anexado ao script com as configurações e informações dele.

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 mudar o projeto de script para usar um projeto padrão.

As seções a seguir descrevem quando o Apps Script exige um projeto padrão, as propriedades dele e as tarefas comuns. Realize essas tarefas apenas 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 na nuvem

Os projetos padrão têm as seguintes propriedades:

  • Acesse todas as configurações do Google Cloud para o projeto diretamente no console do Google Cloud. Isso permite ativar APIs, ajustar credenciais de autorização e configurar outros detalhes.
  • Quando você exclui um projeto de script ou o 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 Marketplace como um complemento, ele precisa ter um projeto padrão próprio. Os 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 Apps Script, o projeto de script e o aplicativo de chamada precisam compartilhar o mesmo projeto padrão.
  • Quando o Apps Script pede que um usuário autorize um script que usa um projeto padrão, o nome do projeto na nuvem é usado para identificar o script (não o nome do projeto do script). Por isso, defina um nome de projeto na nuvem adequado.

Acessar um projeto na nuvem padrão

Para acessar o projeto padrão associado ao seu projeto de script:

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

Encontre um projeto padrão diretamente na página Gerenciar recursos do console do Google Cloud.

Ativar uma API em um projeto na nuvem padrão

Para dar a um aplicativo do Apps Script acesso a outra API do Google, ative a API no projeto na nuvem correspondente:

  1. Abra o projeto na nuvem.
  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 depois em Ativar.

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 aceitar.

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 na nuvem padrão

Todos os projetos do Cloud têm um nome, um ID e um número. Talvez você precise desses identificadores para configurar serviços ou concluir outras tarefas.

Para determinar o ID e o número do seu projeto padrão:

  1. Abra o projeto na nuvem.
  2. No canto superior direito, clique em Mais > Configurações do projeto.
  3. Confira o Nome do projeto, o ID do projeto e o Número do projeto no painel Configurações resultante. O Número do projeto consiste em dígitos, enquanto o ID do projeto é alfanumérico. Edite o nome do projeto, que aparece para os usuários durante as solicitações de autorização.

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

Se você estiver usando o Google Cloud Logging ou o Error Reporting no projeto de script, consulte os registros e relatórios no console do Google Cloud fazendo o seguinte:

  1. Abra o projeto na nuvem.
  2. Clique no menu .
  3. Na seção Operações, clique em Logging > Análise de registros.
  4. Para ver relatórios de erros, na seção Operações, clique em Error Reporting. 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 pede que os usuários autorizem esses serviços. As configurações da tela de permissão OAuth definem as 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 permissão 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 permissão do script:

  1. Abra o projeto na nuvem.
  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 permissão.
  5. Para gravar as mudanças em cada etapa, 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, crie outras credenciais do OAuth (IDs do cliente e chaves secretas do cliente). Faça isso apenas com projetos padrão.

Para criar um ID do cliente e uma chave secreta do cliente para seu projeto de script:

  1. Abra o projeto na nuvem.
  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 e preencha o formulário. Quando terminar, clique em Criar.
  5. Na caixa de diálogo, clique em Fazer o download do JSON. Use esse arquivo para configurar o OAuth.

Adicionar outros proprietários a um projeto na nuvem padrão

Adicione outros proprietários ou papéis a um projeto padrão para garantir que alguém da sua equipe sempre tenha acesso às configurações do Google Cloud do projeto de script.

Para adicionar outros proprietários ou papéis a um projeto padrão (requer permissões de edição):

  1. Determine seus colaboradores. Recomendamos usar um Grupo do Google. Especifique os domínios para incluir todos os usuários neles.
  2. Abra o projeto na nuvem do script.
  3. Clique em Menu > IAM e administrador > IAM.
  4. Na parte de cima, clique em Adicionar.
  5. Siga as instruções na tela para adicionar novos membros e funções. Adicione e-mails individuais, Grupos do Google ou domínios.
  6. Clique em Salvar.

Agrupar vários scripts com um único projeto na nuvem

Vários projetos do Apps Script podem compartilhar o mesmo projeto padrão na nuvem. Para fazer isso, crie um projeto padrão e mude cada projeto de script para usá-lo. Não é possível fazer isso com projetos padrão.

Se você quiser publicar seu projeto de script no Marketplace como um complemento, ele precisa ter um projeto padrão próprio. Os apps publicados não podem compartilhar projetos do Cloud.

Usar outro projeto na nuvem padrão

Mude um projeto de script para usar um projeto na nuvem padrão diferente. Se o script exigir configuração manual do projeto na nuvem, mude de um projeto padrão para um projeto comum. Para saber mais, consulte projetos padrão do Cloud.

Efeitos da mudança para outro projeto padrão na nuvem

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

  • Se você ativou serviços avançados para seu script, é necessário ativar as APIs correspondentes no novo projeto na nuvem. Você perde todos os dados vinculados aos serviços avançados no projeto anterior na nuvem. Para saber como ativar APIs no seu projeto na nuvem, 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 na nuvem padrão, ative a API Drive:

    Ativar a API Drive

  • Todos os usuários que já autorizaram o script precisam fazer isso de novo. Na maioria dos casos, todos os usuários que autorizaram apps associados ao novo projeto precisam fazer isso de novo.
  • Se o script estiver associado a uma página de detalhes do app no Google Workspace Marketplace, essa página, os usuários e as avaliações não serão transferidos para o novo projeto. Você precisa criar uma página de detalhes do app no novo projeto, e seus usuários precisam reinstalar o app. Para saber como criar uma nova página de detalhes do app, consulte Publicar um app.
  • Não é possível mudar um script de volta 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 outro projeto na nuvem padrão

Para mudar o projeto na nuvem de um script para outro projeto na nuvem, siga estas etapas:

  1. Se você não tiver um projeto na nuvem adequado, crie um seguindo as instruções em Criar um projeto. Defina um nome de projeto fácil de lembrar para localizá-lo na página Gerenciar recursos do console do Google Cloud. O Apps Script usa esse nome quando pede aos usuários para autorizar o script.
  2. Se quiser usar um projeto atual, abra a página Gerenciar recursosdo console do Google Cloud e localize um projeto para usar. Você precisa ter os papéis de Navegador de projetos 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 na nuvem.
  4. Abra o script cujo projeto na nuvem você quer substituir.
  5. À esquerda, clique em Configurações do projeto .
  6. Em Projeto do Google Cloud, clique em Mudar projeto.
  7. Digite o novo número do projeto e clique em Definir projeto.

Projetos na nuvem e drives compartilhados

As unidades compartilhadas estão disponíveis apenas para clientes do Google Workspace Business e do Google Workspace Enterprise.

Os drives compartilhados (antigos drives de equipe) oferecem espaços compartilhados onde grupos de usuários do Drive podem colaborar em projetos do Apps Script e documentos do Drive. Os unidades compartilhadas são úteis ao desenvolver scripts, complementos e apps da Web com uma equipe, mas impõem algumas restrições sobre o que é possível fazer com projetos padrão mais antigos do Cloud.

A lista a seguir descreve como os projetos do Cloud interagem com as unidades compartilhadas:

  • Se o projeto de script usar um projeto padrão, não haverá restrições adicionais quando o projeto de script estiver em um drive compartilhado.
  • Se o projeto de script usar um projeto padrão criado em ou após 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 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 na nuvem padrão. Você ainda pode acessar o projeto padrão se tinha acesso antes da movimentação. Por exemplo, se você criou um script na pasta Meu Drive e o moveu para um drive compartilhado, ainda poderá acessar o projeto na nuvem do script. Seus colaboradores no drive compartilhado talvez não consigam.
    4. Um script mantém o nome do projeto na nuvem 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 autorizarem o script ainda vão ver o nome antigo nas caixas de diálogo de autorização.

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

Acessar uma lista de projetos do Cloud no Apps Script

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

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

Excluir projetos do Cloud do Apps Script

Você precisa ser administrador para excluir projetos padrão.

Para excluir um projeto do Apps Script no console do Google Cloud:

  1. Abra o projeto na nuvem.
  2. No canto superior direito, clique em Mais > Configurações do projeto.
  3. Clique em Desativar / excluir.
  4. Siga as instruções na tela para encerrar o projeto.

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.