> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracecat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Docs

> Reference for the Tracecat Google Docs integration: registered actions, required secrets, expected inputs, and example workflow usage.

## Batch update document

Action ID: `tools.google_docs.batch_update_document`

Apply multiple updates to a Google Doc in a single request.

Reference: [https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/batchUpdate](https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/batchUpdate)

### Secrets

Optional secrets:

* `google_docs_oauth`: OAuth token `GOOGLE_DOCS_SERVICE_TOKEN`.

### Input fields

<ParamField path="document_id" type="string" required>
  ID of the document to update.
</ParamField>

<ParamField path="requests" type="array[object]" required>
  List of Docs API request objects to apply.
</ParamField>

<ParamField path="write_control" type="object | null">
  Optional write control configuration (e.g., requiredRevisionId).

  Default: `null`.
</ParamField>

## Create document

Action ID: `tools.google_docs.create_document`

Create a new Google Doc.

Reference: [https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/create](https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/create)

### Secrets

Optional secrets:

* `google_docs_oauth`: OAuth token `GOOGLE_DOCS_SERVICE_TOKEN`.

### Input fields

<ParamField path="title" type="string | null">
  Optional document title.

  Default: `null`.
</ParamField>

## Get document

Action ID: `tools.google_docs.get_document`

Retrieve a Google Doc with optional suggestions view mode.

Reference: [https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/get](https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/get)

### Secrets

Optional secrets:

* `google_docs_oauth`: OAuth token `GOOGLE_DOCS_SERVICE_TOKEN`.

### Input fields

<ParamField path="document_id" type="string" required>
  ID of the document to fetch.
</ParamField>

<ParamField path="suggestions_view_mode" type="string | null">
  How to display suggestions in the response.

  Default: `null`.
</ParamField>