Adicionar conta do Google Drive
Configuração do Google Drive
Seção intitulada “Configuração do Google Drive”Estas etapas precisam ser concluídas no Google Cloud Console para criar uma conta de serviço que o PlaidCloud possa usar para acessar o Google Drive.
Crie um projeto do Google Cloud
Seção intitulada “Crie um projeto do Google Cloud”- Entre no Google Cloud Console
- Crie um novo projeto ou selecione um existente
Ative a API do Google Drive
Seção intitulada “Ative a API do Google Drive”- Navegue até APIs & Services > Library
- Pesquise por Google Drive API
- Selecione-a e clique em Ativar
Crie uma conta de serviço
Seção intitulada “Crie uma conta de serviço”- Navegue até APIs & Services > Credentials
- Selecione + Create Credentials > Service account
- Informe um nome para a conta de serviço (por exemplo,
plaidcloud-drive) - Selecione Create and Continue
- Se quiser, conceda funções (por exemplo, Visualizador para somente leitura ou Editor para leitura e gravação). Selecione Continuar.
- Selecione Concluído
Gere uma chave da conta de serviço
Seção intitulada “Gere uma chave da conta de serviço”- Na lista Service Accounts, selecione a conta de serviço que você acabou de criar
- Navegue até a guia Keys
- Selecione Adicionar chave > Criar novo
- Escolha o formato JSON e selecione Criar
- Um arquivo de chave JSON será baixado. Guarde esse arquivo com segurança — ele contém as credenciais que o PlaidCloud usará.
Compartilhe o conteúdo do Drive com a conta de serviço
Seção intitulada “Compartilhe o conteúdo do Drive com a conta de serviço”- Copie o endereço de e-mail da conta de serviço (por exemplo,
plaidcloud-drive@your-project.iam.gserviceaccount.com) - No Google Drive, compartilhe com esse endereço de e-mail as pastas que você quer que o PlaidCloud acesse, concedendo acesso de Editor. Para usar um Drive compartilhado, adicione a conta de serviço como membro dele.
Agora você deve ter tudo o que precisa para adicionar sua conta do Google Drive ao PlaidCloud Document.
Configuração do PlaidCloud Document
Seção intitulada “Configuração do PlaidCloud Document”- Entre no PlaidCloud
- Selecione o espaço de trabalho em que a nova conta de documentos ficará
- Vá para
Document > Manage - Clique no botão Nova conta
- Selecione
Google Drivecomo o Tipo de serviço - Preencha um nome e uma descrição
- Informe o caminho da pasta compartilhada no campo Caminho inicial ou deixe-o em branco para acessar todo o conteúdo compartilhado
- Selecione um Modelo de segurança adequado ao seu caso de uso. Se estiver em dúvida, deixe como
Private. - Cole todo o conteúdo do arquivo de chave JSON no campo JSON de credenciais OAuth2, em Credenciais de autenticação
- Clique no botão Salvar e sua nova conta de documentos estará ativa
Usar a conta em fluxos de trabalho
Seção intitulada “Usar a conta em fluxos de trabalho”Uma conta do Google Drive funciona em fluxos de trabalho, além do navegador do Document. As etapas podem listar, importar, exportar, copiar, mover, renomear e excluir arquivos e criar pastas.
- Locais. Os locais de nível superior da conta são as pastas compartilhadas com a conta de serviço e os Drives compartilhados dos quais ela é membro. Os caminhos são nomes de pastas, como
Finance/Reports/2026. Se duas pastas compartilhadas ou Drives compartilhados tiverem o mesmo nome, a conta se recusa a abrir esse nome. Renomeie ou deixe de compartilhar todos, exceto um. - Google Sheets. Uma planilha do Google Sheets é lida como uma exportação
.xlsxe aparece comoName.xlsx. Outros arquivos do Google Workspace, como Docs e Slides, não podem ser lidos. - Novos arquivos no Meu Drive. Uma conta de serviço não tem armazenamento próprio. Por isso, em uma pasta que fica no Meu Drive pessoal de alguém, ela pode sobrescrever um arquivo existente, mas não pode criar um novo. Crie o arquivo lá primeiro ou use uma pasta em um Drive compartilhado, que aceita novos arquivos e pastas.
- Pastas ausentes. Uma pasta que não existe é listada como vazia, em vez de causar um erro.
- Limitação de taxa. O PlaidCloud tenta novamente de forma automática quando o Google limita uma solicitação ou retorna um erro temporário.