Centro de suporte da Workiva

Com o conector do Google Drive®, você pode usar os comandos em uma cadeia para gerenciar arquivos e pastas no Google Drive. Por exemplo, com esse conector, você pode:

• Pesquisar arquivos no Google Drive
• Upload e download de arquivos
• Criar ou excluir arquivos e pastas

Observe que os comandos desse conector gerenciam arquivos armazenados no Google Drive, não arquivos salvos em produtos do Google Workspace®, como Google Docs®, Sheets® ou Slides®.

Observação: Esse conector foi criado pela Workiva e se conecta a um sistema de terceiros. Embora nossa equipe de suporte possa ajudar a configurar esse conector no seu espaço de trabalho, não podemos solucionar problemas ou ajudar com problemas que se originem fora da plataforma Workiva.

Pré-requisitos

Para ativar a conexão, o conector usa a API REST do Google Drive. Para configurar o conector, você precisará de:

• Um aplicativo da Web dedicado do Google® com consentimento OAuth e acesso à API habilitado
• O ID e o segredo do cliente OAuth do projeto de integração
• Pop-ups ativados em seu navegador
• O URI de redirecionamento do projeto:
  • Para os Estados Unidos, a América Central e a América do Sul: https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  • Para a região Ásia-Pacífico: https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  • Para o Canadá: https://h.cw.wdesk.com/s/wdata/oc/app/oauth/callback
  • Para a região EMEA: https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback

Criar um aplicativo da web do Google

Para configurar o conector, primeiro crie um aplicativo da Web do Google com o consentimento do OAuth e o acesso à API ativados. O conector usa o ID e o segredo do cliente OAuth do aplicativo para se conectar à API do Google Drive.

Etapa 1. Selecione ou crie um projeto

Em o console do desenvolvedor de APIs do Google, selecione ou crie um projeto para usar com o conector. 

Para criar um projeto:

1. Na barra de ferramentas, clique em Select a project ou o nome do projeto atual e, em seguida, clique em New Project.
   
2. Em Project name, digite um nome exclusivo para ajudar a identificar a integração.
3. Em Location, selecione sua organização para que outras pessoas possam usar o projeto.
4. Clique em Create.

Etapa 2. Habilitar o acesso à API

1. Selecione a guia Library.
2. Pesquise e selecione Google Drive API.
3. Em Google Drive API, clique em Enable.
   
    

Etapa 3. Crie o ID e o segredo do cliente OAuth

1. Na guia da tela de consentimento do OAuth, selecione Internal e clique em Create.
   
2. Em App information, digite o nome do aplicativo e o endereço de e-mail do suporte ao usuário para ajudar a identificar o aplicativo ao autenticar o conector.
3. Em App domain, adicione um domínio autorizado de wdesk.com.
   
4. Em Developer contact information (Informações de contato do desenvolvedor), digite o endereço de e-mail para o qual o Google deve enviar todas as atualizações referentes ao projeto e clique em Save and Continue.

5. Em Escopos e Informações opcionais, clique em Salvar e continuar sem adicionar nenhum escopo ou informação opcional.

   Observação: Nenhum escopo ou informação opcional é necessário para um aplicativo com usuários internos.

6. Em Summary, revise e edite os detalhes da tela de consentimento do OAuth conforme necessário e clique em Back to Dashboard.
7. Na guia Credentials (Credenciais), clique em Create credentials (Criar credenciais) e selecione OAuth client ID (ID do cliente OAuth).
   
8. Em Tipo de aplicativo, selecione Aplicativo Web.
   
9. Digite um nome exclusivo para ajudar a identificar as credenciais do OAuth.
10. Em Origens autorizadas de JavaScript:
    • Para a região da Ásia-Pacífico (APAC), acesse https://h.apac.wdesk.com
    • Para o Canadá, acesse https://h.ca.wdesk.com
    • Para a região EMEA, acesse https://h.eu.wdesk.com
    • Para os Estados Unidos, a América Central e a América do Sul, acesse https://h.app.wdesk.com
11. Em URIs de redirecionamento autorizados:
    • Para a região da Ásia-Pacífico (APAC), acessehttps://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
    • Para o Canadá, acessehttps://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
    • Para a região EMEA, acessehttps://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
    • Para os Estados Unidos, a América Central e a América do Sul, acessehttps://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
12. Clique em Create e anote o ID e o segredo do cliente.

Configurar o conector do Google Drive

Observação: Para tornar o conector disponível para uso nas cadeias de sua organização, um administrador de segurança da organização primeiro o habilita em Configuração.

1. No Chain Builder do , clique em compare_arrows Connections na barra lateral esquerda e, em seguida, em compare_arrows Create no canto superior direito.
2. Em “ ” (Conectores), na seção “Connection” (Conexão), selecione “ ” (Google Drive) e “ ” (CloudRunner).
   
3. Em Basic Info, digite um nome e uma descrição exclusivos para ajudar a identificar o conector.
4. Se você quiser que a cadeia possa usar os comandos Criar, Mover, Carregar e Excluir ao acessar unidades compartilhadas, marque (check) Allow Write for All Drive Types. 
   

5. Em Authentication, insira o ID do cliente e o segredo do projeto de integração do Google do conector.
   

   Observação: Todas as credenciais confidenciais são automaticamente criptografadas e armazenadas com criptografia Advanced Encryption Standard (AES) 256.

6. Clique em Conectar e autorize o acesso do conector à sua conta do Google.

   Observação: Para garantir que o Google possa autorizar o acesso do conector, ative os pop-ups do navegador.

7. Selecione os ambientes a serem usados com a conexão e clique em Salvar.
8. Para testar a conexão, crie e execute uma cadeia com o comando Baixar arquivo do conector e verifique se ele retorna uma saída válida.

Solução de problemas

Se a conexão com o Google Drive falhar:

• Verifique o ID e o segredo do cliente do projeto de integração. No console do desenvolvedor de APIs do Google, o ID do cliente e o segredo do projeto aparecem na guia Credenciais.
• Verifique a origem autorizada do JavaScript do projeto, conforme indicado acima
• Assegure-se de que o URI de redirecionamento do projeto seja o mesmo do anterior
• Verifique se o projeto tem acesso à API do Google Drive ativada