Skip to main content

google_drive_64_x_64.png Google Drive

Conectores do Alteryx One no Designer

Os conectores do Google Drive agora fazem parte da experiência de conectores do Alteryx One. Revise com atenção as informações nesta página para garantir o uso apropriado e correto das ferramentas.

O conector do Google Drive permite que você se conecte ao armazenamento em nuvem do Google Drive no Designer Desktop.

O Google Drive está disponível como uma fonte de dados nas ferramentas Dados de Entrada e Dados de Saída, e como as ferramentas autônomas Entrada do Google Drive e Saída do Google Drive.

Tipo de conector

Disponibilidade

Ferramentas e opções de processamento de dados

Conector do Alteryx One

Disponível mediante convite.

Input Data Tool Icon Ferramenta Dados de EntradaLer dados do Google DriveLer dados do Google Drive

Output Data Tool Icon Ferramenta Dados de SaídaGravar dados no Google DriveGravar dados no Google Drive

Conectores autônomos

A versão mais recente está disponível no Alteryx Marketplace.

Google Drive Tool Ferramenta Entrada do Google Drive

Google Drive Tool Ferramenta Saída do Google Drive

Conector do Alteryx One

O Google Drive está disponível no Designer Desktop 2025.1.XX e versões posteriores como uma fonte de dados para as ferramentas Dados de Entrada e Dados de Saída. Para saber mais sobre as opções de tipo de arquivo, acesse Ler dados do Google Drive ou Gravar dados no Google Drive.Ler dados do Google DriveGravar dados no Google Drive

28 de agosto de 2025

Conector do Google Drive versão 2.0.0

O que há de novo

Para alinhar a experiência do usuário entre o Alteryx One e o Designer Desktop, estamos lançando um novo conector do Google Drive para o Designer Desktop. Esse conector permite uma conexão do DCM com o Google Drive nas ferramentas Dados de Entrada e Dados de Saída.

Problemas conhecidos
  • O conector do Google Drive é compatível com a adição de dados apenas a planilhas do Excel.

  • O conector do Google Drive não é compatível com a leitura de dados com caracteres curinga ou de vários arquivos, pastas ou planilhas.

  • O conector do Google Drive não é compatível com particionamento, com ou sem metadados. Para usar o particionamento sem metadados, utilize macros.

  • O conector do Google Drive não é compatível com a seleção de uma planilha em uma lista suspensa. Você precisa digitar o nome da planilha manualmente.

Métodos de autenticação

O Google Drive é compatível com autenticação básica com credenciais do usuário (Fazer login com o Google) e autenticação avançada por aplicativo de API personalizado (Fazer login com o Google – privado).

Fazer login com o Google

A autenticação básica com e-mail e senha está vinculada às credenciais pessoais do usuário do Google. Agora é possível permitir essa conexão para o SDK.

Não recomendamos esse tipo de autenticação para agendar fluxos de trabalho.

Fazer login com o Google – privado

A autenticação avançada aproveita as capacidades de aplicativos de API personalizados. Para obter instruções sobre como configurar o aplicativo de API, acesse Configuração do aplicativo de API do Google Drive. Agora é possível permitir essa conexão para o SDK.

Os aplicativos de API não estão vinculados a um usuário específico, portanto você pode usá-los de forma mais conveniente para agendar fluxos de trabalho. No entanto, exige-se autenticação única ao criar uma conexão no DCM.

Configurar uma conexão com DCM

Para se conectar ao Google Drive com o DCM...DCM - Designer

  1. Arraste as ferramentas Dados de Entrada ou Dados de Saída da paleta de ferramentas para a tela e selecione-o.

  2. Clique em Configurar conexão.

    Se você já criou uma conexão do Google Drive antes, pode clicar em Fontes de dados > Google Drive > Conector do Alteryx One (também chamado de Conector unificado) > Google Drive e pular para a etapa 13.

  3. Na janela do DCM, clique em Fontes de dados.

  4. Em Google Drive, clique em Conector do Alteryx One (também chamado de Conector unificado).

  5. A janela Conexões é aberta.

  6. Clique em + Novo para criar uma nova conexão.

  7. Insira um nome de conexão de sua escolha.

  8. O Designer seleciona automaticamente os detalhes da fonte de dados do Google Drive.

  9. Clique em Salvar.

  10. Clique em + Nova credencial.

  11. Selecione o método de autenticação. Para obter detalhes, consulte o método de autenticação na seção anterior.

  12. Selecione Criar e vincular. Você também pode testar a conexão antes de vincular.

  13. Clique em Conectar ao lado da Conexão de sua escolha. O Google Drive pode solicitar autenticação.

  14. Na janela do navegador de arquivos, selecione o arquivo a ser lido ou gravado.

  15. Selecione a configuração de leitura ou gravação na janela Opções.

  16. Clique em Confirmar para criar uma conexão com o arquivo. Você pode continuar criando seu fluxo de trabalho.

Versão

Descrição

v1.3.5

  • É compatível com o Designer 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores.

  • Compatível apenas com AMP Engine.

  • O DCM é obrigatório para executar este conector no Alteryx Server.

  • Desabilitada a exibição do menu de contexto ao clicar com o botão direito do mouse no Designer para que as ferramentas do Google Drive impeçam ações não intencionais.

  • Adicionada uma caixa de seleção de dados de alta precisão para permitir que os usuários optem pela precisão em nanossegundos para os campos de data/hora e hora que usam a precisão em milissegundos por padrão. Essa caixa de seleção vem desativada por padrão.

  • Corrigido o problema em que caracteres especiais em uma senha do proxy causavam um erro durante a configuração manual do servidor proxy.

  • Corrigido o problema em que fluxos de trabalho usando as ferramentas do Google Drive ficavam parados no estado "Em execução" quando publicados sem sincronizar a conexão do DCM com o Server. (TPM-4985)

  • Corrigido o problema em que a Saída do Google Drive retornava um erro de resposta da API quando mais de 26 campos eram usados sem registros. (TPM-4961)

  • Corrigido o problema em que a Saída do Google Drive removia a formatação apenas da coluna B. (TPM-4960)

  • Corrigido o problema em que as ferramentas do Google Drive gravavam lentamente no Google Planilhas. (TPM-4879)

  • Corrigido o problema em que nomes de esquema do DCM eram trocados no corpo da Entrada e da Saída do Google Drive. (TPM-4845)

  • Corrigido o problema em que valores secretos eram expostos em JSON ao usar Ferramentas de desenvolvedor no Designer. (TPM-4784)

  • Corrigido o problema em que o conector do Google Drive não aceitava corretamente o caminho do arquivo selecionado. (TPM-4756)

  • Corrigido o problema em que a versão 1.3.5 das ferramentas do Google Drive levava mais tempo do que o esperado ao gravar dados no Google Planilhas. (TPM-4701)

  • Corrigido o problema em que o conector do Google Drive gravava valores nulos como "nan" em arquivos do Excel (XLSX). (TPM-4643)

  • Corrigido o problema em que o conector do Google Drive alterava os GIDs (IDs do Google Planilhas) das planilhas existentes ao adicionar uma nova planilha ao mesmo arquivo. (TPM-4489)

  • Corrigido o problema em que a funcionalidade "Acrescentar e renomear" falhava para o formato do Google Planilhas em drives compartilhados. (TPM-4484)

  • Corrigido o problema em que a Entrada do Google Drive mostrava um erro "int muito grande para converter" ao ler valores numéricos grandes. (TPM-4446)

  • Corrigido o problema em que a Entrada do Google Drive adicionava um segundo nome à planilha inesperadamente. (TPM-4437)

  • Corrigido o problema em que a versão 1.3.4 das ferramentas do Google Drive falhava com um erro "Índice da lista fora do intervalo". (TPM-4432)

  • Corrigido o problema em que conexões com as ferramentas do Google Drive eram bloqueadas com a mensagem "Este aplicativo está bloqueado". (TPM-3774)

  • Corrigido o problema em que a criação de arquivos não aplicava automaticamente a extensão de arquivo correta. (TPM-3747)

  • Corrigido o problema em que o uso de caracteres especiais em um nome de arquivo mostrava um caractere "{" na mensagem de erro. (TPM-3746)

  • Corrigido o problema em que a exibição da trilha de navegação do arquivo não mostrava o caminho completo ao navegar por arquivos no Google Drive. (TPM-3628)

Problemas conhecidos

  • O conector do Google Drive adiciona automaticamente um ponto decimal aos valores numéricos. (TPM-4642)

v1.3.4

  • É compatível com Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores.

  • Compatível apenas com AMP Engine.

  • O DCM é obrigatório para executar este conector no Alteryx Server.

  • Corrigido o problema em que a ferramenta Entrada do Google Drive não conseguia ler dados ou metadados de arquivos CSV e YXDB que continham apenas a linha de cabeçalho. (TPM-4240)

  • Corrigido o problema em que a ferramenta Saída do Google Drive não criava arquivos se os critérios não eram atendidos. (TPM-4045)

  • Corrigido o problema em que as ferramentas do Google Drive não conseguiam converter números inteiros do Python. (TPM-3832)

v1.3.3

  • É compatível com Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores.

  • Compatível apenas com AMP Engine.

  • O DCM é obrigatório para executar este conector no Alteryx Server.

  • Corrigido o problema em que a ferramenta Entrada do Google Drive não mantinha as configurações do usuário. (TPM-3873)

  • Corrigido o problema em que a ferramenta Entrada do Google Drive não lia corretamente arquivos com linhas em branco. (TPM-3872)

  • Corrigido o problema em que a ferramenta Entrada do Google Drive não lia corretamente um arquivo CSV se o caractere \0 fosse definido como nenhum delimitador e os dados contivessem o caractere \. (TPM-3860)

  • Corrigido o problema em que o a ferramenta Saída do Google Drive perdia a formatação e o tipo de dados ao escrever datas. (TPM-3859)

  • Corrigido o problema em que a interface das ferramentas do Google Drive não atualizava o caminho do arquivo, o nome do arquivo e outros valores quando o arquivo era atualizado. (TDCE-542)

  • Corrigido o problema em que a ferramenta Entrada do Google Drive retorna o erro de "extensão inválida". (TDCE-541)

  • Corrigido o problema em que a ferramenta Entrada do Google Drive não lia corretamente arquivos CSV contendo caracteres especiais. (TDCE-535)

  • Corrigido o problema em que a ferramenta Entrada do Google Drive não lia corretamente arquivos XLSX cujo nome da planilha terminasse com um espaço. (TDCE-532)

  • Corrigido o problema em que a ferramenta Saída do Google Drive não acrescentava dados ou substituía planilhas corretamente em arquivos XLSX existentes. (TDCE-483)

v1.3.2

  • É compatível com Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores.

  • Compatível apenas com AMP Engine.

  • O DCM é obrigatório para executar este conector no Alteryx Server.

  • A ferramenta Saída do Google Drive agora utiliza a API do Google Planilhas para criar arquivos GSHEET. (TPM-2984)

  • Corrigido o problema em que a ferramenta Saída do Google Drive não acrescentava corretamente os dados DateTime. (TPM-3738)

  • Corrigido o problema em que a ferramenta Saída do Google Drive não criava arquivos CSV. (TPM-3737)

  • Corrigido o problema em que a ferramenta Entrada do Google Drive retornava um erro ao ler arquivos XLSX com valores de texto e números em uma única coluna. (TPM-3708)

  • Corrigido o problema em que a ferramenta Saída do Google Drive ignorava o nome da planilha inserido. (TPM-3626, TPM-3368)

  • Corrigido o problema em que a ferramenta Saída do Google Drive alterava a ID do Google Planilhas. (TPM-3434)

  • Corrigido o problema em que a ferramenta Entrada do Google Drive não lia corretamente valores nulos. (TPM-2972)

  • Corrigido o problema em que várias ferramentas de Saída do Google Drive anteriormente configuradas para substituir dados em planilhas diferentes alteravam as configurações e substituíam a mesma planilha. (TPM-2059)

  • Corrigido o problema em que as ferramentas do Google Drive retornavam um erro informando que o arquivo não existia. (TFLN-1908)

  • Corrigidos os problemas de conectividade e autenticação da ferramenta Entrada do Google Drive para pastas com muitos caracteres. (TDCE-451)

  • Corrigido o problema em que a ferramenta Entrada do Google Drive não mantinha as configurações do usuário caso este alternasse para outra guia. (TDCE-450)

Problemas conhecidos

  • A ferramenta Entrada do Google Drive lê dados booleanos como strings em arquivos YXDB. (TPM-3756)

  • A ferramenta Entrada do Google Drive lê incorretamente as aspas duplas. (TPM-3707)

  • A ferramenta Saída do Google Drive retorna um erro ao gravar arquivos cujos nomes tenham caracteres especiais. (TPM-3746)

  • As ferramentas do Google Drive não exibem o caminho completo do arquivo. (TPM-3628)

  • A ferramenta Saída do Google Drive grava valores nulos em colunas booleanas como valores falsos. (TPM-3053)

v1.3.1

  • É compatível com Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores.

  • Compatível apenas com AMP Engine.

  • O DCM é obrigatório para executar este conector no Alteryx Server.

  • Para a ferramenta Entrada do Google Drive, adicionamos uma opção para incluir subpastas ao usar a pesquisa com o caractere curinga, fazer download de arquivos localmente ou quando o usuário optar por "Processar arquivo como".

  • Problema corrigido em que a lista de arquivos na unidade compartilhada atualizava de volta para a raiz quando o usuário rolava a lista para baixo. (TFLN-1759)

  • Problema corrigido em que a pesquisa com o caractere curinga não funcionava em arquivos compartilhados. (TFLN-1373)

  • Problema corrigido em que a edição manual do caminho do arquivo em uma unidade compartilhada excluía a configuração do conector. (TFLN-1861)

  • Problema corrigido em que a ferramenta Saída do Google Drive não acrescentava registros a novas planilhas. (TDCE-252)

v1.3.0

  • É compatível com Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores.

  • Compatível apenas com AMP Engine.

  • O DCM é obrigatório para executar este conector no Alteryx Server.

  • Removemos o uso da pasta .shiv.

  • Opção adicionada para limitar o uso de caractere curinga e a opção "Baixar arquivo localmente" para apenas a pasta selecionada no momento.

  • Problema corrigido em que a ferramenta não conseguia se conectar quando o PAC foi baixado como texto não criptografado ou JSON. (TPM-2927)

  • Problema corrigido em que a lista de arquivos era atualizada e redirecionada de volta para o local da unidade compartilhada raiz ao rolar a lista para baixo. (TFLN-1759)

  • Problema corrigido em que a ferramenta Entrada do Google Drive substituía os valores "NA" por nulos. (TPM-2576)

  • Problema corrigido em que a ferramenta Saída do Google Drive removia formatação, filtragem e agrupamento de objetos incorporados quando o usuário optava por "Substituir planilha" no GSHEET. (TPM-2926)

  • Problema corrigido em que a ferramenta Saída do Google Drive estava alterando os IDs do Google Planilhas ao anexar ou substituir a mesma planilha do Google. (TPM-2789)

  • Problema corrigido em que o Designer parava de responder quando o usuário substituía um ferramenta Dados de Entrada por um ferramenta Entrada do Google Drive. (TPM-3059)

v1.1.2

  • É compatível com o Alteryx Designer e Server 2021.4.2 Patch 4, 2022.1 Patch 2 e versões posteriores.

  • Exige o AMP Engine.

  • Ao baixar um arquivo XLSX localmente, a ferramenta agora retorna uma lista com nomes de planilhas.

  • A ferramenta Saída do Google Drive agora preserva a formatação ao usar a ação "Agregar" ou "Substituir" planilha.

  • Problema corrigido em que a ferramenta Saída do Google Drive mudava os campos de data para 70 anos no futuro. (TPM-1905)

  • Problema corrigido em que a ferramenta Saída do Google Drive mantinha a configuração do nome da planilha. (TFLN-1223)

Problemas conhecidos

  • O Alteryx Server exige o valor AllowAll das configurações do Modo de Acesso do SDK.

  • Quando múltiplas ferramentas Saída do Google Drive são configuradas para substituir planilhas diferentes no mesmo arquivo GSHEET, elas substituem incorretamente a mesma planilha. (TPM-2059)

  • A pesquisa por caractere curinga não funciona para arquivos compartilhados. (TPM-1840)

v1.1.1

  • É compatível com o Alteryx Designer e Server 2021.4.2 Patch 4, 2022.1 Patch 2 e versões posteriores.

  • Opção adicionada para substituir uma única planilha no Google Planilhas.

Problema conhecido

  • O Alteryx Server exige o valor AllowAll das configurações do Modo de Acesso do SDK.

v1.1.0

  • É compatível com o Alteryx Designer e Server 2021.4.2 Patch 4, 2022.1 Patch 2 e versões posteriores.

  • Exige o AMP Engine.

  • Suporte adicional para DCM.

    • O DCM é necessário para executar esse conector no Alteryx Server.

  • Suporte adicionado para Google Shared Drives.

  • Alteração do comportamento do campo de nome da planilha e do arquivo a serem excluídos dos dados gravados. Adicionada opção para manter o campo de nome da planilha e do arquivo.

  • A validação SSL/TLS é agora executada em relação ao Repositório de Certificados do Windows.

  • Capaz de operar com FIPS.

Problemas conhecidos

  • O Alteryx Server exige o valor AllowAll das configurações do Modo de Acesso do SDK.

  • Não é possível substituir uma única planilha no Google Planilhas. (Em breve.)

v1.0.0

  • É compatível com o Alteryx Designer 2021.4 e versões posteriores.

  • Versão inicial.

  • Aplicativo Google multilocatário incorporado com uma opção para usar um aplicativo Google personalizado (inclusive aplicativo de locatário único).

  • Suporte para leitura e gravação de arquivos nos formatos XLSX, CSV e YXDB.

  • Compatível com proxy.

Gerenciador de Conexões de Dados

As ferramentas do Google Drive 1.1.0 e versões posteriores são compatíveis com o Gerenciador de Conexões de Dados para um armazenamento mais fácil e seguro de suas credenciais. Crie uma conexão com o Google Drive e reutilize facilmente as credenciais armazenadas em fluxos de trabalho que incluem as ferramentas do Google Drive. O Alteryx Server exige credenciais armazenadas para executar com êxito os fluxos de trabalho publicados.

Entrar no Google Drive

Você pode fazer login por meio de um navegador da Internet ou um aplicativo pessoal do Google. Vá para Configuração de aplicativo de API personalizado para obter mais informações sobre como criar um aplicativo ou consulte Criar e configurar seu aplicativo para obter detalhes.

Fazer login pelo navegador da Internet

  1. Em Criar nova conexão, selecione Entrar usando o navegador da Internet.

  2. Clique em Conectar.

  3. Insira suas credenciais e faça login.

  4. Clique em Continuar para permitir o acesso.

Conectar através de aplicativo do Google próprio

  1. Em Criar nova conexão, selecione Entrar usando o navegador da Internet e marque a opção Conectar por meio do próprio aplicativo do Google.

  2. Insira o ID do cliente e o ID do locatário.

  3. Clique em Conectar.

  4. Insira suas credenciais e faça login.

  5. Clique em Continuar para permitir o acesso.

Habilitar o AMP Engine

Certifique-se de ter o AMP Engine habilitado para os fluxos de trabalho que contêm as ferramentas do Google Drive 1.1.0 e versões posteriores.

Configuração de aplicativo de API personalizado do Google

Para configurar um aplicativo de API personalizado para esta ferramenta, consulte o nosso guia.