> 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/integracoes/overview/project-management/google-docs.md).

# Google Docs

Integre o seu Workflow com Google Docs

A integração com o Google Docs permite criar um Doc dentro da conta do Drive conectada.

## Autenticação

Antes de usar a integração com o Google Docs, você precisa autenticar sua conta Google com a AirOps. Esta integração requer permissões específicas para criar e gerir documentos do Google Docs no Google Drive.

### Várias contas Google

A AirOps suporta a ligação de várias contas Google dentro do mesmo workspace. Isto permite-lhe:

* Criar documentos em diferentes contas do Google Drive
* Gerir permissões em várias organizações Google
* Alternar entre contas pessoais e profissionais

Cada conta autenticada aparece como um conector separado que pode selecionar ao configurar a etapa do seu fluxo de trabalho.

### Permissões necessárias

A integração com o Google Docs requer os seguintes escopos OAuth 2.0:

* `https://www.googleapis.com/auth/drive.file` - Criar e gerir ficheiros no Google Drive criados pela AirOps
* `https://www.googleapis.com/auth/documents` - Criar e editar Google Docs

### Como autenticar

Antes de usar o Google Docs nos seus fluxos de trabalho, precisa de configurar a integração nas definições do seu workspace:

1. **Configurar a integração**
   * Aceda a **Definições > Integrações** (ou visite `/account/integrations`)
   * Clique em **Adicionar novo** para criar uma nova autenticação
   * Selecione **Google Docs** da lista de fornecedores
2. **Concluir o fluxo OAuth**
   * Clique em **Autenticar** para iniciar o processo OAuth da Google
   * Inicie sessão com a sua conta Google
   * Conceda as permissões solicitadas à AirOps
   * Será redirecionado de volta para a AirOps com a autenticação bem-sucedida
3. **Usar nos fluxos de trabalho**
   * Navegue até ao seu fluxo de trabalho e adicione a etapa do Google Docs
   * Selecione a sua conta Google autenticada no menu pendente
   * Configure os parâmetros do documento

{% hint style="info" %}
**Várias contas:** Se tiver várias contas Google autenticadas, verá um menu pendente para selecionar qual conta usar em cada etapa do fluxo de trabalho. Cada autenticação fica disponível em todos os fluxos de trabalho no seu workspace.
{% endhint %}

## Parâmetros

1. **Pasta (Opcional):** escolha uma pasta para criar o documento; caso contrário, o padrão é a pasta de nível superior
2. **Título:** o título do documento criado
3. **Texto do documento:** o texto a colocar no documento, suporta Markdown

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-eddb6a8d1d69cf97476e7a667db47bc32e21461d%2Fgoogle-docs-01-step-config.png?alt=media" alt="Google Docs step creating a launch brief document in the Launch Briefs folder"><figcaption><p>Crie um Google Doc a partir do resultado do fluxo de trabalho.</p></figcaption></figure>

## Resolução de problemas

### Problemas comuns

**Falha na autenticação**

* Certifique-se de que concedeu todas as permissões solicitadas durante o fluxo OAuth
* Verifique se a sua conta Google tem acesso ao Google Drive e ao Google Docs
* Tente autenticar novamente visitando [Integrações da AirOps](https://app.airops.com/account/integrations)

**Falha na criação do documento**

* Verifique se a pasta selecionada existe e se tem permissões de escrita
* Certifique-se de que a conta Google tem espaço de armazenamento suficiente no Google Drive
* Verifique se o título do documento não contém caracteres inválidos

**Erros de permissão**

* Confirme que a conta autenticada tem permissão para criar ficheiros na pasta especificada
* Para pastas partilhadas, certifique-se de que a conta tem permissões de "Editor" ou "Proprietário"

## Exemplo

{% @arcade/embed %}


---

# 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/integracoes/overview/project-management/google-docs.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.
