# Descrição
Habilite o seu bot com a capacidade de listar e gerir os seus ficheiros no Google Drive e de transferir/carregar dados entre o Google Drive e a API de ficheiros Botpress .
Configuração
Devido à natureza potencialmente sensível dos ficheiros no seu Google Drive, a integração do Google Drive requer uma ligação segura entre Botpress e o Google Drive. Para estabelecer esta ligação segura, deve configurar a integração do Google Drive utilizando o OAuth.
Configuração automática com OAuth
Para configurar a integração do Google Drive utilizando o OAuth, clique no botão de autorização e siga as instruções no ecrã para ligar o seu bot Botpress ao Google Drive.
Ao utilizar este modo de configuração, será utilizada uma aplicação do Google Drive gerida por Botpress para estabelecer ligação à sua conta do Google Drive. No entanto, as acções realizadas pelo bot serão atribuídas ao utilizador que autorizou a ligação, e não à aplicação. Por este motivo, não recomendamos a utilização de contas pessoais do Google Drive para esta integração. Deve configurar uma conta de serviço e utilizar esta conta para autorizar a ligação. Pode então partilhar pastas e ficheiros específicos com esta conta de serviço para dar ao seu bot acesso a esses ficheiros.
Configurar a integração em Botpress
- Autorize a integração do Google Drive clicando no botão de autorização.
- Siga as instruções no ecrã para ligar o seu chatbot Botpress ao Google Drive.
- Quando a ligação estiver estabelecida, pode guardar a configuração e ativar a integração.
Usando a integração
Utilize as acções disponíveis para gerir os seus ficheiros e descarregar/carregar conteúdos de e para o Google Drive.
Utilize os accionadores disponíveis para saber quando um ficheiro ou pasta foi criado ou eliminado.
Utilize a ação "syncChannels" para criar e atualizar canais de subscrição em todos os ficheiros e pastas disponíveis. São estes canais que permitem que o seu bot seja notificado sobre a criação e eliminação de recursos. Os canais são válidos até um dia. Certifique-se de que esta ação é chamada uma vez por dia para evitar a perda de eventos. Chamar esta ação com demasiada frequência pode resultar em erros e na perda de eventos devido ao limite da taxa de criação de subscrições do Google Drive.
Limitações
As limitações padrão da API do Google Drive aplicam-se à integração do Google Drive em Botpress. Essas limitações incluem limites de taxa, restrições de tamanho de arquivo e outras restrições impostas pela plataforma do Google Drive. Certifique-se de que o seu bot respeita estas limitações para manter o desempenho e a fiabilidade ideais.
Estão disponíveis mais pormenores na documentação da API do Google Drive.