> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/contexto/knowledge-bases/add-data/import-from-google-drive.md).

# Importar do Google Drive

## Importar ficheiros do Google Drive

O AirOps permite-lhe importar facilmente conteúdo diretamente do Google Drive para a sua Base de conhecimento, com suporte para Google Docs, Sheets e PDFs. Esta integração permite-lhe tirar partido dos seus documentos existentes sem ter de os transferir e carregar novamente.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-a410020903751a6c79f0539093fc7d0f1e82ad5d%2Fkb-google-drive-01-menu.png?alt=media" alt="Add Data menu with the Google Drive submenu open on File and Folder"><figcaption><p>Selecione Google Drive e, em seguida, Ficheiro ou Pasta.</p></figcaption></figure>

Para importar um ficheiro do Google Drive:

* Clique em "Adicionar dados" e selecione "Importar ficheiro do Google Drive" no menu pendente
* Partilhe o ficheiro do Google Drive com a conta de serviço do AirOps fornecida (com acesso de edição)
* Copie e cole a ligação partilhável do ficheiro do Google Drive no campo indicado
* Clique em "Importar dados" para adicionar o conteúdo à sua Base de conhecimento

O conteúdo será processado e ficará disponível para pesquisa semântica, permitindo que os seus fluxos de trabalho e agentes acedam a estas informações quando necessário.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-f547ba771ebb34c156c006cce2db31f9146dcaf0%2Fkb-google-drive-02-import.png?alt=media" alt="Import Google Drive File dialog with the service account email to share with and a Google Docs link"><figcaption><p>Partilhe o ficheiro com o AirOps e, em seguida, cole a respetiva ligação.</p></figcaption></figure>

## Importar uma pasta do Google Drive

Se tiver muitos ficheiros para importar de uma só vez, pode indicar ao AirOps uma pasta inteira do Google Drive, em vez de adicionar os ficheiros um a um. O AirOps irá analisar a pasta e importar todos os ficheiros compatíveis que encontrar.

Para importar uma pasta do Google Drive:

* Clique em "Adicionar dados" e selecione "Importar pasta do Google Drive" no menu pendente
* Partilhe a pasta do Google Drive com a conta de serviço do AirOps fornecida (com, pelo menos, acesso de visualização)
* Copie e cole a ligação partilhável da pasta no campo indicado
* Clique em "Importar dados" para colocar a importação na fila

A pasta é processada de forma assíncrona: o AirOps lista os ficheiros da pasta, cria um documento para cada um na sua Base de conhecimento e, em seguida, sincroniza-os e indexa-os em segundo plano. As pastas maiores podem demorar vários minutos até que todo o conteúdo fique disponível para pesquisa.

### Tipos de ficheiro compatíveis

Ao importar uma pasta, o AirOps irá incluir os seguintes tipos de ficheiro:

* Google Docs
* Google Sheets
* Google Slides
* PDFs do Google Drive e ficheiros PDF carregados
* Ficheiros CSV
* Ficheiros de imagem (PNG, JPEG, etc.)

Os restantes tipos de ficheiro na pasta são ignorados.

### Limitações

* **Não são suportadas pastas aninhadas.** Só são importados os ficheiros da pasta indicada. Os ficheiros existentes em subpastas são ignorados. Se precisar de importar conteúdo de uma pasta que contenha subpastas, nivele primeiro a estrutura ou importe cada subpasta separadamente.
* **Máximo de 1.000 ficheiros por importação de pasta.** Se uma pasta contiver mais de 1.000 ficheiros compatíveis, só serão importados os primeiros 1.000 devolvidos pelo Google Drive. Para importar todos os ficheiros, divida as pastas maiores em pastas mais pequenas.
* **A conta de serviço tem de ter acesso à pasta.** Se a partilha não estiver configurada ou se a ligação for inválida, a importação falhará com um erro de autorização. Partilhe novamente a pasta com a conta de serviço do AirOps e tente de novo.
* **Só são importados os tipos de ficheiro indicados acima.** Os restantes formatos (por exemplo, `.docx`, `.zip`, ficheiros de vídeo) são ignorados sem aviso.
* **Os novos ficheiros adicionados posteriormente à pasta não são importados automaticamente.** O AirOps regista o estado da pasta no momento da importação. Para incluir ficheiros novos ou atualizados, utilize a ação "Ressincronizar" no conector da pasta na sua Base de conhecimento. Esta ação volta a analisar a pasta e adiciona quaisquer ficheiros compatíveis novos.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/pt/contexto/knowledge-bases/add-data/import-from-google-drive.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
