Projetos do Google Cloud

Todo projeto do Google Apps Script usa o Google Cloud para gerenciar autorização, 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. O projeto de script pode usar um padrão projeto que o Apps Script cria automaticamente, ou um padrão projeto que você cria por conta própria. Em geral, os projetos padrão são adequados para scripts do dia a dia, mas você precisa 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 padrão a qualquer momento, mas não é possível voltar a usar um projeto padrão. É melhor selecionar o projeto na nuvem que o script usa no início do desenvolvimento. A mudança posterior 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 ativará o serviço avançado no projeto padrão na nuvem 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 padrão do Cloud. Por exemplo, para visualizar os registros do Google Cloud no console do Google Cloud, o 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.

Visualizar ou atualizar projetos padrão do Cloud

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

Se você criou o projeto de script antes de 8 de abril de 2019, talvez 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 um administrador, poderá excluir projetos padrão do Cloud como faria com projetos padrão do Cloud. Consulte Visualizar ou editar projetos padrão do Cloud.

Os não administradores não podem excluir projetos padrão manualmente. 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, além das 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. Execute essas tarefas apenas com projetos padrão.

Quando o Apps Script exige projetos padrão do Cloud

Você precisa usar um projeto padrão nas seguintes situações:

Propriedades do projeto padrão 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 o próprio projeto padrão. 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.runda 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 de script). Por esse motivo, defina um nome de projeto na nuvem adequado.

Acessar um projeto padrão na nuvem

Para acessar o projeto padrão associado ao 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 do console do Google Cloud Gerenciar recursos.

Ativar uma API em um projeto padrão na nuvem

Para conceder 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 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 na nuvem

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 projeto padrão:

  1. Abra o projeto na nuvem.
  2. No canto superior direito, clique em Mais > Configurações do projeto.
  3. Visualize 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 é exibido aos usuários durante os avisos de autorização.

Visualizar 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 o projeto de script, poderá visualizar esses registros e relatórios no console do Google Cloud fazendo o seguinte:

  1. Abra o projeto na nuvem.
  2. Clique em Menu .
  3. Na seção Operações, clique em Registro > Explorador de registros.
  4. Para visualizar relatórios de erros, na seção Operações , clique em Error Reporting. Se você receber uma solicitação para configurar o relatório de erros, isso significa que o projeto de script ainda não registrou nenhuma exceção.

Ao usar serviços que exigem o 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 permissão.
  4. Preencha cada seção do fluxo de trabalho da tela de permissão.
  5. Para registrar as mudanças em cada etapa, clique em Salvar e continuar.

Criar credenciais do OAuth

O Apps Script geralmente configura o OAuth para os serviços que o script usa. Para alguns aplicativos, crie credenciais do OAuth adicionais (IDs e segredos do cliente). Faça isso apenas com projetos padrão.

Para criar um ID e um segredo do cliente para o 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 de aplicativo 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 outros 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 outros papéis a um projeto padrão (requer permissões de edição):

  1. Determine seus colaboradores. Recomendamos o uso de um Grupo do Google. Especifique domínios para incluir todos os usuários nesse domínio.
  2. Abra o projeto na nuvem do script.
  3. Clique em Menu > IAM e admin > IAM.
  4. Na parte superior, clique em Adicionar.
  5. Siga as instruções na tela para adicionar novos membros e os papéis deles. 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 na nuvem padrão. Para fazer isso, crie um projeto padrão e então mude cada projeto de script para usá-lo. Não é possível fazer isso com projetos padrão.

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

Usar um projeto na nuvem padrão diferente

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

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

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

  • Se você ativou serviços avançados para o 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 projeto na nuvem, consulte Ativar as APIs do Google Workspace.
  • Se o script usar o serviço integrado do Google Drive, será necessário ativar a API Drive em projetos padrão do Cloud.

    No seu projeto na nuvem padrão, ative a API Drive:

    Ativar a API Drive

  • Todos os usuários que autorizaram o script anteriormente precisam autorizar novamente. Na maioria dos casos, todos os usuários que autorizaram apps associados ao novo projeto também precisam autorizar novamente.
  • Se o script estiver associado a uma listagem de apps no Google Workspace Marketplace, a listagem de apps, os usuários e as avaliações não serão transferidos para o novo projeto. É necessário criar uma listagem de apps no novo projeto, e os usuários precisam reinstalar o app. Para informações sobre como criar uma nova listagem de apps, 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 um projeto na nuvem padrão diferente

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 memorável para localizá-lo na página Gerenciar recursos do console do Google Cloud. O Apps Script usa esse nome ao pedir que os usuários autorizem o script.
  2. Se você quiser usar um projeto atual, abra a página do console do Google Cloud Gerenciar recursos e localize um projeto atual 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 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. Insira o novo número do projeto e clique em Definir projeto.

Projetos do Cloud e drives compartilhados

Os drives compartilhados 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 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 impõem algumas restrições sobre o que você pode fazer com projetos padrão do Cloud mais antigos.

A lista a seguir descreve como os projetos do Cloud interagem com os drives compartilhados:

  • 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á restrições adicionais 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 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 na nuvem. Ainda é possível acessar o projeto padrão se você tiver 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 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 para scripts mais antigos, mude para um projeto padrão.

Receber uma lista de projetos do Cloud do Apps Script

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

  1. Abra a página do console do Google Cloud Gerenciar recursos.
  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 Cloud do Apps Script

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

Para excluir um projeto do Apps Script do 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 Desligar / excluir.
  4. Siga as instruções na tela para desligar o projeto.

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

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.