Unable to look up library. Check the ID and access permissions and try again.

[David Wong Li En -]

Previous this method work. But now me and my team cannot use it

https://github.com/googleworkspace/apps-script-oauth2/blob/main/README.md

script ID 1B7FSrk5Zi6L1rSxxTDgDEUsPzlukDsi4KGuTMorsTQHhGBzBkMun4iDF

[Kildere S Irineu]

PARECER TÉCNICO

Assunto: Falha na utilização de biblioteca OAuth2 via Script ID no Google Apps Script

1. Contextualização

Foi reportada pela equipe a impossibilidade de utilização da biblioteca OAuth2 do Google Apps Script por meio do método tradicional de vinculação via Script ID, especificamente:

1B7FSrk5Zi6L1rSxxTDgDEUsPzlukDsi4KGuTMorsTQHhGBzBkMun4iDF

Ao tentar adicionar a biblioteca no editor do Apps Script, é exibida a seguinte mensagem:

“Unable to look up library. Check the ID and access permissions and try again.”

Ressalta-se que, anteriormente, o método funcionava normalmente.

---

2. Análise Técnica

2.1 Validação do Script ID

O Script ID informado:

• Está correto e continua sendo referenciado em documentações oficiais do Google;

• Está alinhado com o repositório oficial da biblioteca OAuth2.

Portanto, não há indícios de erro no identificador utilizado.

---

2.2 Diagnóstico do erro

O erro apresentado ocorre na etapa de lookup da biblioteca, ou seja, antes mesmo da integração com o código.

Esse comportamento indica falha em um dos seguintes níveis:

a) Permissões de acesso

• O usuário (ou domínio) pode não ter permissão para acessar o projeto da biblioteca;

• Em ambientes Google Workspace, políticas administrativas podem restringir bibliotecas externas.

b) Política de segurança do domínio

• Algumas organizações bloqueiam:

  • bibliotecas públicas;

  • scripts externos não aprovados;

• Isso impede a resolução do Script ID no editor.

c) Instabilidade ou regressão do Apps Script

• O mecanismo de lookup de bibliotecas pode apresentar falhas temporárias;

• Há precedentes de inconsistências nesse recurso, especialmente em ambientes corporativos.

d) Publicação da biblioteca

• Embora o ID esteja correto, pode haver:

  • inconsistência na versão publicada;

  • indisponibilidade parcial do projeto da biblioteca.

---

3. Evidência relevante

O próprio repositório oficial da biblioteca OAuth2 prevê explicitamente um caminho alternativo:

A biblioteca pode ser utilizada sem vínculo via Script ID, copiando diretamente o arquivo OAuth2.gs para o projeto.

Isso indica que o uso via biblioteca não é obrigatório e que a abordagem alternativa é suportada oficialmente.

---

4. Conclusão

Com base na análise:

• O problema não está no Script ID;

• A falha ocorre no processo de resolução/acesso da biblioteca;

• Há forte indicativo de restrição de acesso ou limitação do ambiente (Workspace ou Apps Script);

• O comportamento pode ser resultado de:

  • política administrativa;

  • mudança recente na plataforma;

  • ou instabilidade do serviço.

---

5. Recomendação Técnica

5.1 Solução imediata (recomendada)

Adotar a biblioteca de forma local no projeto, eliminando dependência externa:

Procedimento:

1. Acessar o repositório oficial;

2. Copiar o arquivo:

   dist/OAuth2.gs
   

3. Inserir diretamente no projeto Apps Script;

4. Utilizar normalmente as funções da biblioteca.

Benefícios:

• elimina dependência de lookup;

• evita problemas de permissão;

• garante estabilidade para toda a equipe;

• permite versionamento interno (via clasp/Git).

---

5.2 Ações complementares (opcional)

Caso se deseje manter o uso via biblioteca:

• Validar com o administrador do domínio:

  • permissões para bibliotecas externas;

  • políticas de segurança do Google Workspace;

• Testar em conta pessoal (fora do domínio);

• Verificar se há incidentes recentes no Apps Script.

---

6. Considerações finais

A adoção do código local é, neste cenário, a abordagem mais robusta e alinhada com boas práticas de engenharia, especialmente em ambientes corporativos com restrições.

Essa estratégia também melhora a governança do código e reduz dependências externas não controladas.

--
You received this message because you are subscribed to the Google Groups "Google Apps Script Community" group.
To unsubscribe from this group and stop receiving emails from it, send an email to google-apps-script-c...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/google-apps-script-community/bd9c4ad2-7952-4847-83c6-ee3cd8bd0ba9n%40googlegroups.com.