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

{/* Auto-generated by scripts/generate_tool_docs.py; do not edit by hand. */}
## 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>
