Google Slides

Use Google Slides in Sim to build and update presentations from templates or workflow data. Copy a template, replace text and images, embed Sheets charts, style text and shapes, manage tables and layouts, apply batch updates, and export to PDF or PPTX.

OAuth scopes

Sim requests these scopes when someone connects a Google Drive account. For a self-hosted deployment, register your own app with the provider using the settings below. See Integrations and OAuth for setup.

Use the block

Build, edit, and export branded Google Slides presentations end-to-end. Copy a template, replace text and image tokens, embed Sheets charts, style text and shapes with brand fonts and colors, manage tables and layouts, group elements, run atomic batch updates, and export to PDF or PPTX.

Actions

Read Google Slides Presentation

Read content from a Google Slides presentation

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID

Output

Parameter	Type	Description
slides	json	Array of slides with their content
metadata	json	Presentation metadata including ID, title, and URL
↳ presentationId	string	The presentation ID
↳ title	string	The presentation title
↳ pageSize	object	Presentation page size
↳ width	json	Page width as a Dimension object
↳ height	json	Page height as a Dimension object
↳ mimeType	string	The mime type of the presentation
↳ url	string	URL to open the presentation

Write to Google Slides Presentation

Write or update content in a Google Slides presentation

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
content	string	Yes	The content to write to the slide
slideIndex	number	No	The index of the slide to write to (defaults to first slide)

Output

Parameter	Type	Description
updatedContent	boolean	Indicates if presentation content was updated successfully
metadata	json	Updated presentation metadata including ID, title, and URL
↳ presentationId	string	The presentation ID
↳ title	string	The presentation title
↳ mimeType	string	The mime type of the presentation
↳ url	string	URL to open the presentation

Create Google Slides Presentation

Create a new Google Slides presentation

Inputs and outputs

Input

Parameter	Type	Required	Description
title	string	Yes	The title of the presentation to create
content	string	No	The content to add to the first slide
folderSelector	string	No	Google Drive folder ID to create the presentation in (e.g., 1ABCxyz...)
folderId	string	No	The ID of the folder to create the presentation in (internal use)

Output

Parameter	Type	Description
metadata	json	Created presentation metadata including ID, title, and URL
↳ presentationId	string	The presentation ID
↳ title	string	The presentation title
↳ mimeType	string	The mime type of the presentation
↳ url	string	URL to open the presentation

Replace All Text in Google Slides

Find and replace all occurrences of text throughout a Google Slides presentation

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
findText	string	Yes	The text to find (e.g., {{placeholder}})
replaceText	string	Yes	The text to replace with
matchCase	boolean	No	Whether the search should be case-sensitive (default: true)
pageObjectIds	string	No	Comma-separated list of slide object IDs to limit replacements to specific slides (leave empty for all slides)

Output

Parameter	Type	Description
occurrencesChanged	number	Number of text occurrences that were replaced
metadata	json	Operation metadata including presentation ID and URL
↳ presentationId	string	The presentation ID
↳ findText	string	The text that was searched for
↳ replaceText	string	The text that replaced the matches
↳ url	string	URL to open the presentation

Add Slide to Google Slides

Add a new slide to a Google Slides presentation with a specified layout

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
layout	string	No	The predefined layout for the slide (BLANK, TITLE, TITLE_AND_BODY, TITLE_ONLY, SECTION_HEADER, etc.). Defaults to BLANK.
insertionIndex	number	No	The optional zero-based index indicating where to insert the slide. If not specified, the slide is added at the end.
placeholderIdMappings	string	No	JSON array of placeholder mappings to assign custom object IDs to placeholders. Format: [{"layoutPlaceholder":{"type":"TITLE"},"objectId":"custom_title_id"}]

Output

Parameter	Type	Description
slideId	string	The object ID of the newly created slide
metadata	json	Operation metadata including presentation ID, layout, and URL
↳ presentationId	string	The presentation ID
↳ layout	string	The layout used for the new slide
↳ insertionIndex	number	The zero-based index where the slide was inserted
↳ url	string	URL to open the presentation

Add Image to Google Slides

Insert an image into a specific slide in a Google Slides presentation

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
pageObjectId	string	Yes	The object ID of the slide/page to add the image to
imageUrl	string	Yes	The publicly accessible URL of the image (must be PNG, JPEG, or GIF, max 50MB)
width	number	No	Width of the image in points (default: 300)
height	number	No	Height of the image in points (default: 200)
positionX	number	No	X position from the left edge in points (default: 100)
positionY	number	No	Y position from the top edge in points (default: 100)

Output

Parameter	Type	Description
imageId	string	The object ID of the newly created image
metadata	json	Operation metadata including presentation ID and image URL
↳ presentationId	string	The presentation ID
↳ pageObjectId	string	The page object ID where the image was inserted
↳ imageUrl	string	The source image URL
↳ url	string	URL to open the presentation

Get Slide Thumbnail

Generate a thumbnail image of a specific slide in a Google Slides presentation

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
pageObjectId	string	Yes	The object ID of the slide/page to get a thumbnail for
thumbnailSize	string	No	The size of the thumbnail: SMALL (200px), MEDIUM (800px), or LARGE (1600px). Defaults to MEDIUM.
mimeType	string	No	The MIME type of the thumbnail image: PNG. Defaults to PNG.

Output

Parameter	Type	Description
contentUrl	string	URL to the thumbnail image (valid for 30 minutes)
width	number	Width of the thumbnail in pixels
height	number	Height of the thumbnail in pixels
metadata	json	Operation metadata including presentation ID and page object ID
↳ presentationId	string	The presentation ID
↳ pageObjectId	string	The page object ID for the thumbnail
↳ thumbnailSize	string	The requested thumbnail size
↳ mimeType	string	The thumbnail MIME type

Get Slide Page

Get detailed information about a specific slide/page in a Google Slides presentation

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
pageObjectId	string	Yes	The object ID of the slide/page to retrieve

Output

Parameter	Type	Description
objectId	string	The object ID of the page
pageType	string	The type of page (SLIDE, MASTER, LAYOUT, NOTES, NOTES_MASTER)
pageElements	array	Array of page elements (shapes, images, tables, etc.) on this page
slideProperties	object	Properties specific to slides (layout, master, notes)
↳ layoutObjectId	string	Object ID of the layout this slide is based on
↳ masterObjectId	string	Object ID of the master this slide is based on
↳ notesPage	json	The notes page associated with the slide
metadata	object	Operation metadata including presentation ID and URL
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Delete Object from Google Slides

Delete a page element (shape, image, table, etc.) or an entire slide from a Google Slides presentation

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	The object ID of the element or slide to delete

Output

Parameter	Type	Description
deleted	boolean	Whether the object was successfully deleted
objectId	string	The object ID that was deleted
metadata	object	Operation metadata including presentation ID and URL
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Duplicate Object in Google Slides

Duplicate an object (slide, shape, image, table, etc.) in a Google Slides presentation

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	The object ID of the element or slide to duplicate
objectIds	string	No	Optional JSON object mapping source object IDs (within the slide being duplicated) to new object IDs for the duplicates. Format: {"sourceId1":"newId1","sourceId2":"newId2"}

Output

Parameter	Type	Description
duplicatedObjectId	string	The object ID of the newly created duplicate
metadata	object	Operation metadata including presentation ID and source object ID
↳ presentationId	string	The presentation ID
↳ sourceObjectId	string	The original object ID that was duplicated
↳ url	string	URL to the presentation

Reorder Slides in Google Slides

Move one or more slides to a new position in a Google Slides presentation

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
slideObjectIds	string	Yes	Comma-separated list of slide object IDs to move. The slides will maintain their relative order.
insertionIndex	number	Yes	The zero-based index where the slides should be moved. All slides with indices greater than or equal to this will be shifted right.

Output

Parameter	Type	Description
moved	boolean	Whether the slides were successfully moved
slideObjectIds	array	The slide object IDs that were moved
insertionIndex	number	The index where the slides were moved to
metadata	object	Operation metadata including presentation ID and URL
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Create Table in Google Slides

Create a new table on a slide in a Google Slides presentation

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
pageObjectId	string	Yes	The object ID of the slide/page to add the table to
rows	number	Yes	Number of rows in the table (minimum 1)
columns	number	Yes	Number of columns in the table (minimum 1)
width	number	No	Width of the table in points (default: 400)
height	number	No	Height of the table in points (default: 200)
positionX	number	No	X position from the left edge in points (default: 100)
positionY	number	No	Y position from the top edge in points (default: 100)

Output

Parameter	Type	Description
tableId	string	The object ID of the newly created table
rows	number	Number of rows in the table
columns	number	Number of columns in the table
metadata	object	Operation metadata including presentation ID and page object ID
↳ presentationId	string	The presentation ID
↳ pageObjectId	string	The page object ID where the table was created
↳ url	string	URL to the presentation

Create Shape in Google Slides

Create a shape (rectangle, ellipse, text box, arrow, etc.) on a slide in a Google Slides presentation

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
pageObjectId	string	Yes	The object ID of the slide/page to add the shape to
shapeType	string	Yes	The type of shape to create. Common types: TEXT_BOX, RECTANGLE, ROUND_RECTANGLE, ELLIPSE, TRIANGLE, DIAMOND, STAR_5, ARROW_EAST, HEART, CLOUD
width	number	No	Width of the shape in points (default: 200)
height	number	No	Height of the shape in points (default: 100)
positionX	number	No	X position from the left edge in points (default: 100)
positionY	number	No	Y position from the top edge in points (default: 100)

Output

Parameter	Type	Description
shapeId	string	The object ID of the newly created shape
shapeType	string	The type of shape that was created
metadata	object	Operation metadata including presentation ID and page object ID
↳ presentationId	string	The presentation ID
↳ pageObjectId	string	The page object ID where the shape was created
↳ url	string	URL to the presentation

Insert Text in Google Slides

Insert text into a shape or table cell in a Google Slides presentation. Use this to add text to text boxes, shapes, or table cells.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	The object ID of the shape or table cell to insert text into. For table cells, use the cell object ID.
text	string	Yes	The text to insert
insertionIndex	number	No	The zero-based index at which to insert the text. If not specified, text is inserted at the beginning (index 0).

Output

Parameter	Type	Description
inserted	boolean	Whether the text was successfully inserted
objectId	string	The object ID where text was inserted
text	string	The text that was inserted
metadata	object	Operation metadata including presentation ID and URL
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Update Text Style in Google Slides

Update the styling of text in a shape or table cell (bold, italic, font family, font size, foreground/background color, link, etc.). Only the fields you set are applied.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the shape or table containing the text
rowIndex	number	No	When targeting a table cell, the zero-based row index
columnIndex	number	No	When targeting a table cell, the zero-based column index
rangeType	string	No	Range to style: ALL (default), FROM_START_INDEX, or FIXED_RANGE
startIndex	number	No	Start index for FROM_START_INDEX or FIXED_RANGE
endIndex	number	No	End index for FIXED_RANGE
bold	boolean	No	Whether the text is bold
italic	boolean	No	Whether the text is italic
underline	boolean	No	Whether the text is underlined
strikethrough	boolean	No	Whether the text has strikethrough
smallCaps	boolean	No	Whether the text is rendered in small caps
fontFamily	string	No	Font family name (must be a font available to Google Slides)
fontSize	number	No	Font size in points
foregroundColor	string	No	Text color as hex (e.g. #1A73E8)
backgroundColor	string	No	Text background color as hex (e.g. #FFF8E1)
linkUrl	string	No	Convert the range to a hyperlink with this URL
baselineOffset	string	No	Baseline offset: NONE, SUPERSCRIPT, or SUBSCRIPT
styleJson	string	No	Advanced: raw TextStyle JSON merged with the simple fields above (overrides them on conflict)
fields	string	No	Advanced: explicit FieldMask. If omitted, the mask is computed from the fields you provided (or "*" when styleJson is used without explicit fields).

Output

Parameter	Type	Description
updated	boolean	Whether the text style was updated
objectId	string	The object whose text was styled
fields	string	FieldMask applied
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Update Paragraph Style in Google Slides

Update paragraph styling — alignment, line spacing, indents, space above/below — for text in a shape or table cell.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the shape or table containing the text
rowIndex	number	No	When targeting a table cell, the zero-based row index
columnIndex	number	No	When targeting a table cell, the zero-based column index
rangeType	string	No	Range to style: ALL (default), FROM_START_INDEX, or FIXED_RANGE
startIndex	number	No	Start index for FROM_START_INDEX or FIXED_RANGE
endIndex	number	No	End index for FIXED_RANGE
alignment	string	No	Text alignment: START, CENTER, END, or JUSTIFIED
lineSpacing	number	No	Line spacing as a percentage (100 = single, 200 = double)
indentStart	number	No	Start-edge indent in points
indentEnd	number	No	End-edge indent in points
indentFirstLine	number	No	First-line indent in points
spaceAbove	number	No	Space above the paragraph in points
spaceBelow	number	No	Space below the paragraph in points
direction	string	No	Text direction: LEFT_TO_RIGHT or RIGHT_TO_LEFT
spacingMode	string	No	Spacing mode: NEVER_COLLAPSE or COLLAPSE_LISTS
styleJson	string	No	Advanced: raw ParagraphStyle JSON merged with the simple fields above
fields	string	No	Advanced: explicit FieldMask. If omitted, computed from provided fields.

Output

Parameter	Type	Description
updated	boolean	Whether the paragraph style was updated
objectId	string	The object whose paragraph was styled
fields	string	FieldMask applied
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Delete Text in Google Slides

Delete text from a shape or table cell. Use range type ALL to clear all text, or FIXED_RANGE / FROM_START_INDEX to delete a specific span.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the shape or table containing the text
rowIndex	number	No	When targeting a table cell, the zero-based row index
columnIndex	number	No	When targeting a table cell, the zero-based column index
rangeType	string	No	Range to delete: ALL (default), FROM_START_INDEX, or FIXED_RANGE
startIndex	number	No	Start index for FROM_START_INDEX or FIXED_RANGE
endIndex	number	No	End index for FIXED_RANGE

Output

Parameter	Type	Description
deleted	boolean	Whether the text was deleted
objectId	string	The object whose text was deleted
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Create Paragraph Bullets in Google Slides

Convert paragraphs in a shape or table cell into a bulleted or numbered list using a Google Slides bullet preset.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the shape or table containing the text
rowIndex	number	No	When targeting a table cell, the zero-based row index
columnIndex	number	No	When targeting a table cell, the zero-based column index
rangeType	string	No	Range to apply bullets to: ALL (default), FROM_START_INDEX, or FIXED_RANGE
startIndex	number	No	Start index for FROM_START_INDEX or FIXED_RANGE
endIndex	number	No	End index for FIXED_RANGE
bulletPreset	string	No	Bullet preset (e.g. BULLET_DISC_CIRCLE_SQUARE, BULLET_ARROW_DIAMOND_DISC, NUMBERED_DIGIT_ALPHA_ROMAN, NUMBERED_DIGIT_ALPHA_ROMAN_PARENS, NUMBERED_DIGIT_NESTED). Defaults to BULLET_DISC_CIRCLE_SQUARE.

Output

Parameter	Type	Description
created	boolean	Whether bullets were created
objectId	string	The object where bullets were created
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Delete Paragraph Bullets in Google Slides

Remove bullets/numbering from paragraphs in a shape or table cell.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the shape or table containing the text
rowIndex	number	No	When targeting a table cell, the zero-based row index
columnIndex	number	No	When targeting a table cell, the zero-based column index
rangeType	string	No	Range to clear bullets from: ALL (default), FROM_START_INDEX, or FIXED_RANGE
startIndex	number	No	Start index for FROM_START_INDEX or FIXED_RANGE
endIndex	number	No	End index for FIXED_RANGE

Output

Parameter	Type	Description
deleted	boolean	Whether bullets were deleted
objectId	string	The object whose bullets were deleted
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Replace All Shapes With Image in Google Slides

Find every shape whose text matches the given token (e.g. {{cover-image}}) and replace it with an image, preserving the shape's position and bounds.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
imageUrl	string	Yes	Publicly fetchable image URL (PNG, JPEG, or GIF; max 50 MB and accessible to Google's servers)
findText	string	Yes	Text content of shapes to replace (e.g. {{cover-image}})
matchCase	boolean	No	Case-sensitive match (default: true)
imageReplaceMethod	string	No	How the image fits the shape: CENTER_INSIDE (preserve aspect, fit inside) or CENTER_CROP (fill, crop overflow). Default: CENTER_INSIDE.
pageObjectIds	string	No	Comma-separated slide IDs to limit replacement to specific slides

Output

Parameter	Type	Description
occurrencesChanged	number	Number of shapes that were replaced with the image
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation
↳ imageUrl	string	The image URL inserted
↳ findText	string	The matched text token

Replace Image in Google Slides

Replace the source of an existing image with a new image URL, preserving the image's position, size, and properties.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
imageObjectId	string	Yes	Object ID of the existing image to replace
imageUrl	string	Yes	New publicly fetchable image URL (PNG, JPEG, or GIF, max 50 MB)
imageReplaceMethod	string	No	CENTER_INSIDE (preserve aspect) or CENTER_CROP (fill, crop overflow). Default: CENTER_INSIDE.

Output

Parameter	Type	Description
replaced	boolean	Whether the image was replaced
imageObjectId	string	The image object that was replaced
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation
↳ imageUrl	string	The new image URL

Update Image Properties in Google Slides

Update image properties — brightness, contrast, transparency, crop, outline, link — on an existing image.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the image to update
brightness	number	No	Brightness adjustment between -1.0 and 1.0
contrast	number	No	Contrast adjustment between -1.0 and 1.0
transparency	number	No	Transparency between 0.0 (opaque) and 1.0 (fully transparent)
linkUrl	string	No	Make the image a hyperlink to this URL
outlineColor	string	No	Outline color as hex (e.g. #1A73E8)
outlineWeight	number	No	Outline weight in points
outlineDashStyle	string	No	Outline dash style: SOLID, DOT, DASH, DASH_DOT, LONG_DASH, LONG_DASH_DOT
cropLeftOffset	number	No	Crop offset from left edge (0.0 to 1.0)
cropRightOffset	number	No	Crop offset from right edge (0.0 to 1.0)
cropTopOffset	number	No	Crop offset from top edge (0.0 to 1.0)
cropBottomOffset	number	No	Crop offset from bottom edge (0.0 to 1.0)
cropAngle	number	No	Crop rotation angle in radians (clockwise)
propertiesJson	string	No	Advanced: raw ImageProperties JSON merged with the simple fields above
fields	string	No	Advanced: explicit FieldMask. If omitted, computed from provided fields.

Output

Parameter	Type	Description
updated	boolean	Whether the image properties were updated
objectId	string	The image object updated
fields	string	FieldMask applied
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Update Shape Properties in Google Slides

Update a shape's appearance — background fill color, outline, link, content alignment, autofit. Pass only the properties you want to change.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the shape to update
fillColor	string	No	Solid background fill color as hex (e.g. #FF6F61)
fillAlpha	number	No	Fill opacity between 0.0 (transparent) and 1.0 (opaque)
fillUnset	boolean	No	When true, removes any fill so the shape inherits its layout/master fill
outlineColor	string	No	Outline color as hex
outlineWeight	number	No	Outline weight in points
outlineDashStyle	string	No	Outline dash style: SOLID, DOT, DASH, DASH_DOT, LONG_DASH, LONG_DASH_DOT
outlineUnset	boolean	No	When true, removes any outline so the shape inherits its layout/master outline
linkUrl	string	No	Make the shape a hyperlink to this URL
contentAlignment	string	No	Vertical alignment of shape contents: TOP, MIDDLE, or BOTTOM
autofitType	string	No	Autofit behavior: NONE, TEXT_AUTOFIT, or SHAPE_AUTOFIT
propertiesJson	string	No	Advanced: raw ShapeProperties JSON merged with the simple fields above
fields	string	No	Advanced: explicit FieldMask. If omitted, computed from provided fields.

Output

Parameter	Type	Description
updated	boolean	Whether the shape properties were updated
objectId	string	The shape object updated
fields	string	FieldMask applied
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Update Page Properties in Google Slides

Update slide/page background — solid color or stretched picture — and other page properties.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the slide/page to update
backgroundColor	string	No	Solid background color as hex (e.g. #0B1F3A)
backgroundAlpha	number	No	Background fill opacity between 0.0 and 1.0
backgroundImageUrl	string	No	Publicly fetchable image URL to use as a stretched picture background
backgroundUnset	boolean	No	When true, removes the background so the slide inherits its layout background
propertiesJson	string	No	Advanced: raw PageProperties JSON merged with the simple fields above
fields	string	No	Advanced: explicit FieldMask. If omitted, computed from provided fields.

Output

Parameter	Type	Description
updated	boolean	Whether the page properties were updated
objectId	string	The page object updated
fields	string	FieldMask applied
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Update Slide Properties in Google Slides

Update slide-specific properties such as whether the slide is skipped during presentation.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the slide to update
isSkipped	boolean	No	Whether the slide is skipped in presentation mode
propertiesJson	string	No	Advanced: raw SlideProperties JSON merged with the simple fields above
fields	string	No	Advanced: explicit FieldMask. If omitted, computed from provided fields.

Output

Parameter	Type	Description
updated	boolean	Whether the slide properties were updated
objectId	string	The slide object updated
fields	string	FieldMask applied
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Update Alt Text in Google Slides

Set the accessibility title and/or description (alt text) of a page element such as an image, shape, or group.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the page element
title	string	No	Accessibility title for the element
description	string	No	Accessibility description (alt text) for the element

Output

Parameter	Type	Description
updated	boolean	Whether alt text was updated
objectId	string	The element updated
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Update Page Element Transform in Google Slides

Move, resize, scale, or shear a page element. Translate is specified in points; applyMode controls whether the transform is absolute (default) or relative (multiplied with the current transform).

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the page element to transform
scaleX	number	No	Horizontal scale factor (default 1)
scaleY	number	No	Vertical scale factor (default 1)
shearX	number	No	Horizontal shear factor (default 0)
shearY	number	No	Vertical shear factor (default 0)
translateX	number	No	X position in points (absolute) or delta (relative)
translateY	number	No	Y position in points (absolute) or delta (relative)
applyMode	string	No	ABSOLUTE replaces the current transform; RELATIVE multiplies with it. Default ABSOLUTE.

Output

Parameter	Type	Description
updated	boolean	Whether the transform was updated
objectId	string	The element transformed
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Update Z-Order in Google Slides

Bring elements to front, send to back, or step them one layer forward/backward.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectIds	string	Yes	Comma-separated object IDs of the elements to reorder
operation	string	Yes	BRING_TO_FRONT, BRING_FORWARD, SEND_BACKWARD, or SEND_TO_BACK

Output

Parameter	Type	Description
reordered	boolean	Whether the z-order was changed
objectIds	array	Elements reordered
operation	string	Operation applied
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Group Objects in Google Slides

Group two or more page elements on the same slide into a single object group.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
childrenObjectIds	string	Yes	Comma-separated object IDs of the elements to group (must be on the same slide)
groupObjectId	string	No	Optional object ID to assign to the new group

Output

Parameter	Type	Description
grouped	boolean	Whether the objects were grouped
groupObjectId	string	Object ID of the new group
childrenObjectIds	array	IDs of the grouped children
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Ungroup Objects in Google Slides

Ungroup one or more object groups, releasing their children back to the slide.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectIds	string	Yes	Comma-separated object IDs of the groups to ungroup

Output

Parameter	Type	Description
ungrouped	boolean	Whether the objects were ungrouped
objectIds	array	Group IDs that were ungrouped
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Create Line in Google Slides

Create a line or connector on a slide.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
pageObjectId	string	Yes	Object ID of the slide to add the line to
lineCategory	string	No	STRAIGHT (default), BENT, or CURVED
width	number	No	Line width in points (default 200)
height	number	No	Line height in points (default 0 — horizontal line)
positionX	number	No	X position in points (default 100)
positionY	number	No	Y position in points (default 100)

Output

Parameter	Type	Description
lineId	string	Object ID of the new line
lineCategory	string	Line category created
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ pageObjectId	string	The slide ID
↳ url	string	URL to the presentation

Update Line Properties in Google Slides

Update line appearance — color, weight, dash style, arrows, link.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the line
lineColor	string	No	Line color as hex
lineWeight	number	No	Line weight in points
dashStyle	string	No	Dash style: SOLID, DOT, DASH, DASH_DOT, LONG_DASH, LONG_DASH_DOT
startArrow	string	No	Start arrow style: NONE, STEALTH_ARROW, FILL_ARROW, FILL_CIRCLE, FILL_SQUARE, FILL_DIAMOND, OPEN_ARROW, OPEN_CIRCLE, OPEN_SQUARE, OPEN_DIAMOND
endArrow	string	No	End arrow style (same values as startArrow)
linkUrl	string	No	Hyperlink URL
propertiesJson	string	No	Advanced: raw LineProperties JSON merged with the simple fields above
fields	string	No	Advanced: explicit FieldMask. If omitted, computed from provided fields.

Output

Parameter	Type	Description
updated	boolean	Whether the line properties were updated
objectId	string	The line object updated
fields	string	FieldMask applied
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Update Line Category in Google Slides

Change a connector line's category (STRAIGHT, BENT, or CURVED).

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the connector line
lineCategory	string	Yes	New line category: STRAIGHT, BENT, or CURVED

Output

Parameter	Type	Description
updated	boolean	Whether the line category was updated
objectId	string	The line object updated
lineCategory	string	New line category
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Reroute Line in Google Slides

Reroute a connector line so it efficiently connects its endpoint shapes — useful after moving the shapes the line connects.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the connector line to reroute

Output

Parameter	Type	Description
rerouted	boolean	Whether the line was rerouted
objectId	string	The line object rerouted
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Insert Table Rows in Google Slides

Insert one or more rows into a table, above or below a reference cell.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
tableObjectId	string	Yes	Object ID of the table
rowIndex	number	Yes	Zero-based row index of the reference cell
columnIndex	number	Yes	Zero-based column index of the reference cell
number	number	Yes	Number of rows to insert (minimum 1)
insertBelow	boolean	No	Insert below the reference row instead of above (default false)

Output

Parameter	Type	Description
inserted	boolean	Whether rows were inserted
tableObjectId	string	The table updated
number	number	Number of rows inserted
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Insert Table Columns in Google Slides

Insert one or more columns into a table, left or right of a reference cell.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
tableObjectId	string	Yes	Object ID of the table
rowIndex	number	Yes	Zero-based row index of the reference cell
columnIndex	number	Yes	Zero-based column index of the reference cell
number	number	Yes	Number of columns to insert (minimum 1)
insertRight	boolean	No	Insert to the right of the reference column instead of left (default false)

Output

Parameter	Type	Description
inserted	boolean	Whether columns were inserted
tableObjectId	string	The table updated
number	number	Number of columns inserted
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Delete Table Row in Google Slides

Delete the row containing the reference cell from a table.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
tableObjectId	string	Yes	Object ID of the table
rowIndex	number	Yes	Zero-based row index identifying the row to delete
columnIndex	number	Yes	Zero-based column index of any cell in the row

Output

Parameter	Type	Description
deleted	boolean	Whether the row was deleted
tableObjectId	string	The table updated
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Delete Table Column in Google Slides

Delete the column containing the reference cell from a table.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
tableObjectId	string	Yes	Object ID of the table
rowIndex	number	Yes	Zero-based row index of any cell in the column
columnIndex	number	Yes	Zero-based column index identifying the column to delete

Output

Parameter	Type	Description
deleted	boolean	Whether the column was deleted
tableObjectId	string	The table updated
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Merge Table Cells in Google Slides

Merge a rectangular range of table cells into a single cell. The range starts at (rowIndex, columnIndex) and covers rowSpan × columnSpan cells.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the table
rowIndex	number	Yes	Zero-based row index of the top-left cell
columnIndex	number	Yes	Zero-based column index of the top-left cell
rowSpan	number	Yes	Number of rows to merge (minimum 1)
columnSpan	number	Yes	Number of columns to merge (minimum 1)

Output

Parameter	Type	Description
merged	boolean	Whether the cells were merged
objectId	string	The table updated
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Unmerge Table Cells in Google Slides

Unmerge any merged cells within the given table range.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the table
rowIndex	number	Yes	Zero-based row index of the top-left cell of the range
columnIndex	number	Yes	Zero-based column index of the top-left cell of the range
rowSpan	number	Yes	Number of rows in the range (minimum 1)
columnSpan	number	Yes	Number of columns in the range (minimum 1)

Output

Parameter	Type	Description
unmerged	boolean	Whether the cells were unmerged
objectId	string	The table updated
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Update Table Cell Properties in Google Slides

Update background fill and content alignment for a range of table cells.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the table
rowIndex	number	Yes	Zero-based row index of the top-left cell of the range
columnIndex	number	Yes	Zero-based column index of the top-left cell of the range
rowSpan	number	Yes	Number of rows in the range (minimum 1)
columnSpan	number	Yes	Number of columns in the range (minimum 1)
backgroundColor	string	No	Cell background color as hex (e.g. #F1F3F4)
backgroundAlpha	number	No	Background fill opacity between 0.0 and 1.0
contentAlignment	string	No	Vertical alignment of cell content: TOP, MIDDLE, or BOTTOM
propertiesJson	string	No	Advanced: raw TableCellProperties JSON merged with the simple fields above
fields	string	No	Advanced: explicit FieldMask. If omitted, computed from provided fields.

Output

Parameter	Type	Description
updated	boolean	Whether the cell properties were updated
objectId	string	The table updated
fields	string	FieldMask applied
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Update Table Border Properties in Google Slides

Update border color, weight, and dash style for a position (e.g. ALL, INNER, OUTER) in a table range.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the table
rowIndex	number	Yes	Zero-based row index of the top-left cell of the range
columnIndex	number	Yes	Zero-based column index of the top-left cell of the range
rowSpan	number	Yes	Number of rows in the range (minimum 1)
columnSpan	number	Yes	Number of columns in the range (minimum 1)
borderPosition	string	No	Which borders to update: ALL (default), BOTTOM, INNER, INNER_HORIZONTAL, INNER_VERTICAL, LEFT, OUTER, RIGHT, TOP
borderColor	string	No	Border color as hex
borderWeight	number	No	Border weight in points
dashStyle	string	No	Dash style: SOLID, DOT, DASH, DASH_DOT, LONG_DASH, LONG_DASH_DOT
propertiesJson	string	No	Advanced: raw TableBorderProperties JSON merged with the simple fields above
fields	string	No	Advanced: explicit FieldMask. If omitted, computed from provided fields.

Output

Parameter	Type	Description
updated	boolean	Whether the border properties were updated
objectId	string	The table updated
fields	string	FieldMask applied
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Update Table Column Properties in Google Slides

Update column widths and other column-level table properties.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the table
columnIndices	string	Yes	Comma-separated zero-based column indices to update (e.g. "0,2,3")
columnWidth	number	No	Column width in points
propertiesJson	string	No	Advanced: raw TableColumnProperties JSON merged with the simple fields above
fields	string	No	Advanced: explicit FieldMask. If omitted, computed from provided fields.

Output

Parameter	Type	Description
updated	boolean	Whether the column properties were updated
objectId	string	The table updated
fields	string	FieldMask applied
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Update Table Row Properties in Google Slides

Update minimum row heights and other row-level table properties.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the table
rowIndices	string	Yes	Comma-separated zero-based row indices to update (e.g. "0,2,3")
minRowHeight	number	No	Minimum row height in points
propertiesJson	string	No	Advanced: raw TableRowProperties JSON merged with the simple fields above
fields	string	No	Advanced: explicit FieldMask. If omitted, computed from provided fields.

Output

Parameter	Type	Description
updated	boolean	Whether the row properties were updated
objectId	string	The table updated
fields	string	FieldMask applied
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Embed Google Sheets Chart in Slides

Embed a chart from a Google Sheets spreadsheet onto a slide. LINKED charts can be refreshed; NOT_LINKED_IMAGE inserts a static image of the chart.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
pageObjectId	string	Yes	Object ID of the slide to add the chart to
spreadsheetId	string	Yes	Google Sheets spreadsheet ID containing the chart
chartId	number	Yes	Numeric chart ID within the spreadsheet
linkingMode	string	No	LINKED (default) or NOT_LINKED_IMAGE
width	number	No	Width in points (default 400)
height	number	No	Height in points (default 300)
positionX	number	No	X position in points (default 100)
positionY	number	No	Y position in points (default 100)

Output

Parameter	Type	Description
chartObjectId	string	Object ID of the inserted chart
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ pageObjectId	string	The slide ID
↳ url	string	URL to the presentation

Refresh Sheets Chart in Slides

Refresh an embedded linked Sheets chart so it reflects the latest spreadsheet data.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the embedded chart to refresh

Output

Parameter	Type	Description
refreshed	boolean	Whether the chart was refreshed
objectId	string	The chart object refreshed
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Replace All Shapes With Sheets Chart in Slides

Find every shape matching a text token (e.g. {{revenue-chart}}) and replace each with the same embedded Sheets chart, preserving the shape's position and bounds.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
spreadsheetId	string	Yes	Google Sheets spreadsheet ID containing the chart
chartId	number	Yes	Numeric chart ID within the spreadsheet
findText	string	Yes	Text content of shapes to replace (e.g. {{revenue-chart}})
matchCase	boolean	No	Case-sensitive match (default true)
linkingMode	string	No	LINKED (default) or NOT_LINKED_IMAGE
pageObjectIds	string	No	Comma-separated slide IDs to limit replacement to specific slides

Output

Parameter	Type	Description
occurrencesChanged	number	Number of shapes replaced with the chart
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation
↳ findText	string	The matched text token
↳ spreadsheetId	string	Source spreadsheet ID
↳ chartId	number	Source chart ID

Embed Video in Google Slides

Embed a YouTube or Google Drive video on a slide.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
pageObjectId	string	Yes	Object ID of the slide to add the video to
source	string	Yes	YOUTUBE or DRIVE
videoId	string	Yes	YouTube video ID or Drive file ID
width	number	No	Width in points (default 400)
height	number	No	Height in points (default 225)
positionX	number	No	X position in points (default 100)
positionY	number	No	Y position in points (default 100)

Output

Parameter	Type	Description
videoObjectId	string	Object ID of the inserted video
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ pageObjectId	string	The slide ID
↳ url	string	URL to the presentation

Update Video Properties in Google Slides

Update video playback options (autoPlay, mute, start/end) and outline.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
objectId	string	Yes	Object ID of the video
autoPlay	boolean	No	Play the video automatically when the slide is shown
mute	boolean	No	Mute the video
start	number	No	Playback start time in seconds
end	number	No	Playback end time in seconds
outlineColor	string	No	Outline color as hex
outlineWeight	number	No	Outline weight in points
outlineDashStyle	string	No	Outline dash style
propertiesJson	string	No	Advanced: raw VideoProperties JSON merged with the simple fields above
fields	string	No	Advanced: explicit FieldMask. If omitted, computed from provided fields.

Output

Parameter	Type	Description
updated	boolean	Whether the video properties were updated
objectId	string	The video object updated
fields	string	FieldMask applied
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation

Batch Update Google Slides (Raw)

Run a raw Slides API batchUpdate with a list of Request objects. Use this when the higher-level tools do not cover an operation, or to bundle multiple operations into a single atomic batch (all-or-nothing).

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
requests	string	Yes	JSON array of Slides API Request objects. Example: [{"replaceAllText":{"containsText":{"text":"{{title}}"},"replaceText":"Q3 Review"}}, {"updatePageProperties":{"objectId":"slide_1","pageProperties":{"pageBackgroundFill":{"solidFill":{"color":{"rgbColor":{"red":0.043,"green":0.122,"blue":0.231}}}}},"fields":"pageBackgroundFill"}}]
writeControl	string	No	Optional JSON WriteControl object for optimistic concurrency, e.g. {"requiredRevisionId":"..."}

Output

Parameter	Type	Description
replies	array	Array of reply objects, one per request (parallel-indexed)
writeControl	json	WriteControl returned by the server (revision tracking)
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation
↳ requestCount	number	Number of replies returned

Copy Google Slides Presentation

Copy a template presentation in Drive to a new file. Use this before merging data so the original template is never modified.

Inputs and outputs

Input

Parameter	Type	Required	Description
sourcePresentationId	string	Yes	Drive file ID of the source/template presentation
title	string	No	Title for the copy. Defaults to "Copy of <source title>".
folderId	string	No	Drive folder ID where the copy should be placed

Output

Parameter	Type	Description
presentationId	string	ID of the new copied presentation
title	string	Title of the new presentation
metadata	object	Operation metadata
↳ sourcePresentationId	string	Source/template presentation ID
↳ presentationId	string	New presentation ID
↳ title	string	New presentation title
↳ mimeType	string	MIME type of the presentation
↳ url	string	URL to the new presentation

Export Google Slides Presentation

Export a presentation to PDF, PPTX, ODP, TXT, PNG, JPEG, or SVG via the Drive export endpoint. Stores the exported file as an execution file when execution context is available.

Inputs and outputs

Input

Parameter	Type	Required	Description
presentationId	string	Yes	Google Slides presentation ID
exportFormat	string	No	Format: PDF (default), PPTX, ODP, TXT, PNG, JPEG, or SVG

Output

Parameter	Type	Description
file	file	Stored exported presentation file
contentBase64	string	Deprecated legacy inline content. New exports return file.
mimeType	string	MIME type of the exported content
sizeBytes	number	Size of the exported content in bytes
metadata	object	Operation metadata
↳ presentationId	string	The presentation ID
↳ url	string	URL to the presentation
↳ exportFormat	string	Export format used