> ## 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 Slides

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

## Batch update presentation

Action ID: `tools.google_slides.batch_update_presentation`

Applies one or more updates to the presentation.

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

### Secrets

Optional secrets:

* `google_slides_oauth`: OAuth token `GOOGLE_SLIDES_USER_TOKEN`.
* `google_slides_oauth`: OAuth token `GOOGLE_SLIDES_SERVICE_TOKEN`.
* `google_api`: required values `GOOGLE_API_CREDENTIALS`; optional values `GOOGLE_API_SUBJECT`.

### Input fields

<ParamField path="presentation_id" type="string" required>
  The presentation to apply the updates to.
</ParamField>

<ParamField path="requests" type="array[object]" required>
  A list of updates to apply to the presentation. Each Request sets exactly one of the union fields documented at [https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/request](https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/request) (createSlide, createShape, createTable, insertText, replaceAllText, deleteObject, updatePageElementTransform, updateTextStyle, duplicateObject, and so on).
</ParamField>

<ParamField path="write_control" type="object | null">
  Provides control over how write requests are executed. Documented fields: requiredRevisionId, targetRevisionId.

  Default: `null`.
</ParamField>

## Create presentation

Action ID: `tools.google_slides.create_presentation`

Creates a blank presentation using the title given in the request.

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

### Secrets

Optional secrets:

* `google_slides_oauth`: OAuth token `GOOGLE_SLIDES_USER_TOKEN`.
* `google_slides_oauth`: OAuth token `GOOGLE_SLIDES_SERVICE_TOKEN`.
* `google_api`: required values `GOOGLE_API_CREDENTIALS`; optional values `GOOGLE_API_SUBJECT`.

### Input fields

<ParamField path="title" type="string | null">
  The title of the presentation.

  Default: `null`.
</ParamField>

## Get page

Action ID: `tools.google_slides.get_page`

Gets the latest version of the specified page in the presentation.

Reference: [https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations.pages/get](https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations.pages/get)

### Secrets

Optional secrets:

* `google_slides_oauth`: OAuth token `GOOGLE_SLIDES_USER_TOKEN`.
* `google_slides_oauth`: OAuth token `GOOGLE_SLIDES_SERVICE_TOKEN`.
* `google_api`: required values `GOOGLE_API_CREDENTIALS`; optional values `GOOGLE_API_SUBJECT`.

### Input fields

<ParamField path="page_object_id" type="string" required>
  The object ID of the page to retrieve.
</ParamField>

<ParamField path="presentation_id" type="string" required>
  The ID of the presentation to retrieve.
</ParamField>

## Get page thumbnail

Action ID: `tools.google_slides.get_page_thumbnail`

Generates a thumbnail of the latest version of the specified page in the presentation and returns a URL to the thumbnail image.

Reference: [https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations.pages/getThumbnail](https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations.pages/getThumbnail)

### Secrets

Optional secrets:

* `google_slides_oauth`: OAuth token `GOOGLE_SLIDES_USER_TOKEN`.
* `google_slides_oauth`: OAuth token `GOOGLE_SLIDES_SERVICE_TOKEN`.
* `google_api`: required values `GOOGLE_API_CREDENTIALS`; optional values `GOOGLE_API_SUBJECT`.

### Input fields

<ParamField path="page_object_id" type="string" required>
  The object ID of the page whose thumbnail to retrieve.
</ParamField>

<ParamField path="presentation_id" type="string" required>
  The ID of the presentation to retrieve.
</ParamField>

<ParamField path="thumbnail_properties_mime_type" type="string | null">
  The optional mime type of the thumbnail image. If you don't specify the mime type, the mime type defaults to PNG. Allowed value: PNG.

  Default: `null`.
</ParamField>

<ParamField path="thumbnail_properties_thumbnail_size" type="string | null">
  The optional thumbnail image size. If you don't specify the size, the server chooses a default size of the image. Allowed values: THUMBNAIL\_SIZE\_UNSPECIFIED (the server chooses the size), LARGE (thumbnail image width of 1600px), MEDIUM (800px), SMALL (200px).

  Default: `null`.
</ParamField>

## Get presentation

Action ID: `tools.google_slides.get_presentation`

Gets the latest version of the specified presentation.

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

### Secrets

Optional secrets:

* `google_slides_oauth`: OAuth token `GOOGLE_SLIDES_USER_TOKEN`.
* `google_slides_oauth`: OAuth token `GOOGLE_SLIDES_SERVICE_TOKEN`.
* `google_api`: required values `GOOGLE_API_CREDENTIALS`; optional values `GOOGLE_API_SUBJECT`.

### Input fields

<ParamField path="presentation_id" type="string" required>
  The ID of the presentation to retrieve.
</ParamField>