# Google Slides

Your Toolhouse AI Worker can connect to Googleslides using 8 specialized tools.

## Auth Connection

This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=googleslides).

## Tools

### `Googleslides Create Presentation`

Integration name: **GOOGLESLIDES\_CREATE\_PRESENTATION**

Tool to create a blank Google Slides presentation. Use when you need to initialize a new presentation with a specific title, locale, or page size.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example             | Description                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ---------------- | ------ | :------: | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `title`          | string |          | `"My Presentation"` | The title of the presentation. If omitted, the API uses a default title.                                                                                                                                                                                                                                                                                                                                                                  |
| `locale`         | string |          | `"en-US"`           | The locale of the presentation, as an IETF BCP 47 language tag (e.g., 'en-US', 'fr-FR', 'ja-JP'). If omitted, the API uses a default locale.                                                                                                                                                                                                                                                                                              |
| `pageSize`       | object |          | —                   | The size of a page in the presentation.                                                                                                                                                                                                                                                                                                                                                                                                   |
| `presentationId` | string |          | —                   | The ID to use for the new presentation. If provided, it is used as the ID of the new presentation. Otherwise, a new ID is automatically generated. Must be a valid Google Drive/Slides ID format (long alphanumeric string). Note: Human-readable IDs (e.g., 'my-presentation') are not valid and will cause API errors. Only provide this if you have a valid Google Drive/Slides ID format; otherwise omit to let the API generate one. |

### `Googleslides Create Slides Markdown`

Integration name: **GOOGLESLIDES\_CREATE\_SLIDES\_MARKDOWN**

Creates a new Google Slides presentation from Markdown text. Automatically splits content into slides using '---' separators and applies appropriate templates based on content structure.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type   | Required | Example                                                                                    | Description                                       |
| --------------- | ------ | :------: | ------------------------------------------------------------------------------------------ | ------------------------------------------------- |
| `title`         | string |     ✅    | `"Q4 Business Review"`                                                                     | The title for the new Google Slides presentation. |
| `markdown_text` | string |     ✅    | \`"# 🚀 Product Launch\nRevolutionary AI-powered platform\n\n---\n\n# 📊 Market Analysis\n | Segment                                           |

### `Googleslides Get Page Thumbnail2`

Integration name: **GOOGLESLIDES\_GET\_PAGE\_THUMBNAIL2**

Tool to generate a thumbnail of the latest version of a specified page. Use when you need a preview image URL for a slide page. This request counts as an expensive read request for quota purposes.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                           | Type   | Required | Example                                          | Description                                                                                                           |
| ----------------------------------- | ------ | :------: | ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------- |
| `pageObjectId`                      | string |     ✅    | `"p"`                                            | The object ID of the page whose thumbnail to retrieve.                                                                |
| `presentationId`                    | string |     ✅    | `"1l0UiR1k56BzDPiAfOHNbkbHsegbTn3BZMvomy02N0cM"` | The ID of the presentation to retrieve.                                                                               |
| `thumbnailProperties.mimeType`      | string |          | `"PNG"`                                          | The optional mime type of the thumbnail image. Defaults to PNG if not specified.                                      |
| `thumbnailProperties.thumbnailSize` | string |          | `"LARGE"`                                        | The optional thumbnail image size. LARGE = 1600px, MEDIUM = 800px, SMALL = 200px. Defaults to LARGE if not specified. |

### `Googleslides Presentations Batch Update`

Integration name: **GOOGLESLIDES\_PRESENTATIONS\_BATCH\_UPDATE**

Update Google Slides presentations using markdown content or raw API text. Supports professional themes, auto-formatting, and multiple slide types (title, bullet, table, quote, image, two-column).

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ---------------- | ------ | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `requests`       | array  |          | —       | List of update requests, each a dict with one of these valid Slides API request types: **Common requests:** createSlide, createShape, createTable, createImage, insertText, updateTextStyle, updateShapeProperties, updatePageProperties, updateParagraphStyle, deleteObject, updateTableCellProperties, updateTableColumnProperties, replaceAllText **IMPORTANT:** To update slide backgrounds, use `updatePageProperties` (NOT `updateSlideProperties`). The field `pageBackgroundFill` exists in PageProperties, not SlideProperties. Required if markdown\_text is not provided.                                                                                                                                     |
| `writeControl`   | object |          | —       | Options that control how write requests are executed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `markdown_text`  | string |          | —       | Markdown content to add as new slides to an existing presentation. Separate slides with '\n---\n'. Each slide auto-detects its type from content. Slide types: title ('# Title\nSubtitle'), bullets ('-'/'+'/'\*'), tables (markdown tables), quotes ('> text'), images (''), two-column ('\|\|\|' separator), plain text. Add `Theme: <name>` as the first line to apply a theme. Available themes: default, corporate\_blue, modern\_dark, professional\_gray, creative\_purple, warm\_orange, forest\_green, minimal\_beige. Font sizes auto-scale based on content length (28pt down to 8pt). Supports **bold**, emoji, and auto-centering of tables. Images must be publicly accessible URLs (PNG/JPEG/GIF, <50MB). |
| `presentationId` | string |     ✅    | —       | The ID of the presentation to apply the updates to.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

### `Googleslides Presentations Copy From Template`

Integration name: **GOOGLESLIDES\_PRESENTATIONS\_COPY\_FROM\_TEMPLATE**

Tool to create a new Google Slides presentation by duplicating an existing template deck via Drive file copy. Use when you need to preserve themes, masters, and layouts exactly as they appear in the template. After copying, use GOOGLESLIDES\_PRESENTATIONS\_BATCH\_UPDATE to replace placeholder text or images.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                  | Type   | Required | Example                    | Description                                                                                                                                                                     |
| -------------------------- | ------ | :------: | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `new_title`                | string |          | `"Q4 Sales Deck"`          | The name/title for the copied presentation. If omitted, a default name like 'Copy of \[original]' is used.                                                                      |
| `parent_folder_id`         | string |          | `"0B1a2b3c4d5e6f7g8h9i0j"` | The ID of the destination folder in Google Drive. If provided, the copied presentation will be placed in this folder. If omitted, the copy is placed in the user's root folder. |
| `template_presentation_id` | string |     ✅    | `"1a2B3c4D5eF6gH7iJ8kL"`   | The Drive file ID of the Slides template to copy. This is the presentationId of the existing deck you want to duplicate.                                                        |

### `Googleslides Presentations Get`

Integration name: **GOOGLESLIDES\_PRESENTATIONS\_GET**

Tool to retrieve the latest version of a presentation. Use after obtaining the presentation ID.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type   | Required | Example                         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ------------------ | ------ | :------: | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `fields`           | string |          | `"presentationId,title,slides"` | Comma-separated selector specifying which fields to include in a partial response. Nested fields use parentheses that must be properly balanced. Top-level fields: presentationId, title, locale, revisionId, pageSize, slides, masters, layouts, notesMaster. For slides/masters/layouts, valid Page fields: objectId, pageType, pageElements, pageProperties, revisionId. For pageElements, valid fields: objectId, size, transform, title, description, shape, image, video, line, table, wordArt, elementGroup, sheetsChart, speakerSpotlight. For shape, valid fields: shapeType, text, shapeProperties, placeholder. Note: 'autofit' is under shapeProperties, not directly under shape. Use shape(shapeProperties(autofit)), not shape(autofit). Examples: 'presentationId,title', 'slides(objectId,pageElements(objectId,size))', 'slides(objectId,pageElements(objectId,shape(shapeType,text,shapeProperties(autofit))))' |
| `presentationId`   | string |          | `"1a2B3c4D5eF6gH7iJ8kL"`        | The ID of the presentation to retrieve. Either presentation\_id or presentation\_name must be provided.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `presentationName` | string |          | `"Q4 Sales Report"`             | The name of the presentation to search for and retrieve. If provided, the action will search Google Drive for a presentation with this name. Either presentation\_id or presentation\_name must be provided.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |

### `Googleslides Presentations Pages Get`

Integration name: **GOOGLESLIDES\_PRESENTATIONS\_PAGES\_GET**

Tool to get the latest version of a specific page in a presentation. Use when you need to inspect slide, layout, master, or notes page details.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example | Description                                              |
| ---------------- | ------ | :------: | ------- | -------------------------------------------------------- |
| `pageObjectId`   | string |     ✅    | —       | The object ID of the page to retrieve.                   |
| `presentationId` | string |     ✅    | —       | The ID of the presentation from which to fetch the page. |

### `Googleslides Presentations Pages Get Thumbnail`

Integration name: **GOOGLESLIDES\_PRESENTATIONS\_PAGES\_GET\_THUMBNAIL**

DEPRECATED: Use GOOGLESLIDES\_GET\_PAGE\_THUMBNAIL2 instead. Tool to generate and return a thumbnail image URL for a specific page. Use when you need a quick preview of a slide page after loading it.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                           | Type   | Required | Example                  | Description                                                                                                                    |
| ----------------------------------- | ------ | :------: | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
| `pageObjectId`                      | string |     ✅    | `"p"`                    | The object ID of the page whose thumbnail to retrieve.                                                                         |
| `presentationId`                    | string |     ✅    | `"1a2B3c4D5eF6gH7iJ8kL"` | The ID of the presentation containing the page.                                                                                |
| `thumbnailProperties.mimeType`      | string |          | `"PNG"`                  | Optional thumbnail image MIME type. Currently only 'PNG' is supported by the API. Defaults to 'PNG' if omitted.                |
| `thumbnailProperties.thumbnailSize` | string |          | `"LARGE"`                | Optional thumbnail size. One of 'LARGE', 'MEDIUM', 'SMALL', or 'THUMBNAIL\_SIZE\_UNSPECIFIED'. Defaults to 'LARGE' if omitted. |


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toolhouse.ai/toolhouse/integrations/google-slides.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
