Projetos do Google Cloud

Todo projeto do Apps Script usa 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 uma 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, projetos padrão são bons para tarefas cotidianas scripts, mas você deve usar um projeto padrão para qualquer aplicativo que é complexa, de qualidade comercial ou que você pretende publicar.

É possível alternar 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 para selecionar o projeto do Cloud que seu script usa no início do desenvolvimento. A troca posterior pode causar complicações, como exigir que os usuários reautorizar.

Projetos padrão do Cloud

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

  • Na maioria dos scripts, nunca é necessário ver ou ajustar esse projeto padrão. Aplicativos O script lida com as interações necessárias com o Google Cloud. Por exemplo, se ativar um serviço avançado no editor do Apps Script ativa o serviço avançado no projeto padrão do Cloud quando você salvar o projeto de script.
  • Para alguns scripts, você precisa interagir com o console do Google Cloud. Nessas em alguns casos, seu script precisa usar um projeto padrão do Cloud. Para exemplo, para acessar os registros do Google Cloud no console do Google Cloud, seu script precisa usar em um projeto padrão.

Por padrão, os projetos do Cloud têm um Identity and Access Management (IAM) com uma entrada: uma conta de serviço do Google que atua como proprietária do o 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 diretamente no console do Google Cloud. Se você for administrador, consulte Acessar projetos padrão do Google Cloud.

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

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 Cloud que usam o Apps Script.

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 Apps Script exclui o projeto padrão associado. Se o script for executado depois O Apps Script exclui o projeto padrão e cria 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, você deve mude seu 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 desses projetos e as tarefas comuns realizadas com eles. Você só pode execute as tarefas abaixo 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 padrão de projetos 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. Isso permite ativar APIs, ajustar a autorização credenciais e configurar outros detalhes.
  • Quando você exclui ou muda para um projeto de script usar outro projeto padrão, o projeto original permanece e pode ser reutilizadas.
  • 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 Apps Script, o projeto de script e o aplicativo de chamada precisam compartilhar o mesmo padrão. em um projeto de IA.
  • Quando o Apps Script pede que um usuário autorize um script que usa uma interface projeto, o nome do projeto do Cloud é usado para identificar o script (não o nome do projeto de script). Por isso, defina um nome de projeto do Cloud adequado.

Acessar um projeto padrão do Cloud

Para acessar o projeto padrão associado ao seu script projeto, 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 no console do Google Cloud.

Ativar uma API em um projeto padrão do Cloud

Muitas vezes, um aplicativo do Apps Script precisa de acesso a outra API do Google. Para 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 no 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 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 você também precise configurar a API selecioná-lo na guia APIs e Services.

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

Todos os projetos do Cloud têm um nome, um ID e um número. Ocasionalmente, você precisa 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, ID e Número do projeto. no painel Configurações resultante. O número do projeto consiste apenas no dígitos, enquanto o ID do projeto é alfanumérico. É possível editar Nome do projeto, que aparece para os usuários durante as solicitações de autorização.

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

Se você usa o Google Cloud Logging. ou Error Reporting para seu projeto de script, é possível visualizar esses registros e relatórios na Console do Google Cloud fazendo 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 visualizar os relatórios de erros, role para baixo até a seção Operações e 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 solicita que os usuários autorizem esses serviços. As configurações da tela de permissão OAuth permitem que você defina 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 no detalhes do projeto do Apps Script; não será possível ajustar essas configurações. Com os projetos padrão do Cloud, a personalizar essas informações. Você pode configurar o consentimento do seu script na tela fazendo o seguinte:

  1. Abra o projeto do Cloud.
  2. Clique no 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 etapa 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, é necessário criar Credenciais OAuth (IDs e chaves secretas do cliente). Você só pode fazer isso com projetos padrão.

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

  1. Abra o projeto do Cloud.
  2. Clique no 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 resultante, se necessário. Quando terminar, clique em Criar.
  5. Na caixa de diálogo exibida, clique em Fazer o download do JSON. Você pode use 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 sempre tem acesso às configurações do Google Cloud do projeto de script.

É possível adicionar outros proprietários ou outros papéis a um projeto padrão fazendo o seguindo. Você precisa ter permissões de edição no projeto para fazer qualquer uma das essas mudanças:

  1. Determine quem devem ser seus colaboradores. Recomendamos que você criar ou usar um Grupo do Google existente. Você pode também especificar domínios na lista de colaboradores para incluir todos os usuários da domínio.
  2. Abra o projeto do Cloud do script.
  3. Clique no menu . > IAM e administrador > 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 fazer com que vários projetos do Google Apps Script compartilhem o mesmo padrão do Google Cloud. Para isso, crie um projeto padrão e Mudar cada projeto de script para usá-lo. Não é possível fazer isso com projetos padrão.

Usar um projeto padrão do Cloud diferente

É possível alternar um projeto de script para que ele use um padrão diferente do Google Cloud. Se o script exigir a configuração manual da do Google Cloud, é preciso mudar de um projeto padrão para um padrão em um projeto de IA. Para saber mais sobre quando você precisa usar um projeto padrão, consulte projetos padrão do Cloud.

Efeitos da mudança para um projeto padrão do Cloud diferente

Se você alternar seu script de um projeto padrão ou para um padrão diferente projeto, ela tem os seguintes efeitos:

  • Se você ativou serviços avançados para seu script, é necessário ativar a opção as APIs correspondentes o novo projeto do Cloud. Se você perder todos os dados vinculados serviços no projeto anterior do Cloud. Para saber como ativar as APIs no projeto do Cloud, consulte Ativar APIs do Google Workspace.
  • Se o script usar o serviço integrado Google Drive, será necessário ativar a opção 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. Em na maioria dos casos, todos os usuários que tenham autorizado aplicativos associados a que o novo projeto também precisa autorizar.
  • Caso seu script esteja associado a uma página "Detalhes do app" no Google Workspace Marketplace, as informações, os usuários e as avaliações do app não serão transferidos para o um novo projeto. É necessário criar uma página "Detalhes do app" no novo projeto, e os usuários precisam reinstalar o app. Para saber como criar uma nova página "Detalhes do app", consulte Publicar um app.
  • Não é possível mudar um script de volta para um projeto padrão. Exclusões do Apps Script projetos padrão depois de definir o script para usar um projeto padrão.

Alternar 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 uma seguindo os exercícios do curso Criar um projeto instruções. Defina um nome de projeto fácil de lembrar para poder localize-o na página Gerenciar recursos no console do Google Cloud. O Apps Script usa esse nome quando solicitando que os usuários autorizem o script.
  2. Para usar um projeto atual, abra a página Gerenciar recursos no console do Google Cloud. e localizar um projeto para usar. Você precisa ter o Navegador do projeto e Editor de configuração OAuth ou papéis com os equivalentes para a permissão em um projeto de IA. Não é possível usar um projeto criado automaticamente pelo Google Apps Script.
  3. Determine o número do projeto do seu projeto do Cloud.
  4. Abra o script com o 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 número do novo 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 no desenvolvimento scripts, complementos e aplicativos da Web com uma equipe, mas impõem algumas restrições o que é possível fazer com projetos padrão mais antigos do Cloud.

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

  • Se seu 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á mais restrições quando o script o projeto fica em um drive compartilhado.
  • Se o projeto de script usar um projeto padrão criado antes 8 de abril de 2019, as seguintes restrições serão aplicadas enquanto o script o projeto fica em um drive compartilhado:
    1. Não é possível acessar o projeto padrão usando a interface do Apps Script ou no console do Google Cloud. Essa restrição impede que você faça 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 padrão em um projeto de IA.
    3. Quando você move um projeto do Apps Script para um drive compartilhado, o Google que restringe o acesso ao projeto padrão do Cloud. Você ainda pode acessar o projeto padrão, se você tinha acesso antes da mudança. Para exemplo, se você criou um script na pasta "Meu Drive" e o moveu em um drive compartilhado, você ainda pode acessar do Google Cloud. Talvez os colaboradores no drive compartilhado não possam fazer isso.
    4. Um script mantém o nome do projeto do Cloud que tinha antes de ser movido para um drive compartilhado. Mesmo se você alterar o nome do projeto no drive compartilhado, os usuários que autorizarem o script ainda poderão ver o nome antigo na autorização. caixas de diálogo.

Para evitar as restrições acima em scripts mais antigos, mudar 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 sua pasta de projeto do Google Apps Script da sua organização, é possível visualizar todas as tarefas projetos do Cloud padrão do Apps Script 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 Cloud que usam o Apps Script

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 o seguinte 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.