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.

Usage Instructions

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID

Output

ParameterTypeDescription
slidesjsonArray of slides with their content
metadatajsonPresentation metadata including ID, title, and URL
presentationIdstringThe presentation ID
titlestringThe presentation title
pageSizeobjectPresentation page size
widthjsonPage width as a Dimension object
heightjsonPage height as a Dimension object
mimeTypestringThe mime type of the presentation
urlstringURL to open the presentation

Write to Google Slides Presentation

Write or update content in a Google Slides presentation

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
contentstringYesThe content to write to the slide
slideIndexnumberNoThe index of the slide to write to (defaults to first slide)

Output

ParameterTypeDescription
updatedContentbooleanIndicates if presentation content was updated successfully
metadatajsonUpdated presentation metadata including ID, title, and URL
presentationIdstringThe presentation ID
titlestringThe presentation title
mimeTypestringThe mime type of the presentation
urlstringURL to open the presentation

Create Google Slides Presentation

Create a new Google Slides presentation

Input

ParameterTypeRequiredDescription
titlestringYesThe title of the presentation to create
contentstringNoThe content to add to the first slide
folderSelectorstringNoGoogle Drive folder ID to create the presentation in (e.g., 1ABCxyz...)
folderIdstringNoThe ID of the folder to create the presentation in (internal use)

Output

ParameterTypeDescription
metadatajsonCreated presentation metadata including ID, title, and URL
presentationIdstringThe presentation ID
titlestringThe presentation title
mimeTypestringThe mime type of the presentation
urlstringURL to open the presentation

Replace All Text in Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
findTextstringYesThe text to find (e.g., {{placeholder}})
replaceTextstringYesThe text to replace with
matchCasebooleanNoWhether the search should be case-sensitive (default: true)
pageObjectIdsstringNoComma-separated list of slide object IDs to limit replacements to specific slides (leave empty for all slides)

Output

ParameterTypeDescription
occurrencesChangednumberNumber of text occurrences that were replaced
metadatajsonOperation metadata including presentation ID and URL
presentationIdstringThe presentation ID
findTextstringThe text that was searched for
replaceTextstringThe text that replaced the matches
urlstringURL to open the presentation

Add Slide to Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
layoutstringNoThe predefined layout for the slide (BLANK, TITLE, TITLE_AND_BODY, TITLE_ONLY, SECTION_HEADER, etc.). Defaults to BLANK.
insertionIndexnumberNoThe optional zero-based index indicating where to insert the slide. If not specified, the slide is added at the end.
placeholderIdMappingsstringNoJSON array of placeholder mappings to assign custom object IDs to placeholders. Format: [{"layoutPlaceholder":{"type":"TITLE"},"objectId":"custom_title_id"}]

Output

ParameterTypeDescription
slideIdstringThe object ID of the newly created slide
metadatajsonOperation metadata including presentation ID, layout, and URL
presentationIdstringThe presentation ID
layoutstringThe layout used for the new slide
insertionIndexnumberThe zero-based index where the slide was inserted
urlstringURL to open the presentation

Add Image to Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
pageObjectIdstringYesThe object ID of the slide/page to add the image to
imageUrlstringYesThe publicly accessible URL of the image (must be PNG, JPEG, or GIF, max 50MB)
widthnumberNoWidth of the image in points (default: 300)
heightnumberNoHeight of the image in points (default: 200)
positionXnumberNoX position from the left edge in points (default: 100)
positionYnumberNoY position from the top edge in points (default: 100)

Output

ParameterTypeDescription
imageIdstringThe object ID of the newly created image
metadatajsonOperation metadata including presentation ID and image URL
presentationIdstringThe presentation ID
pageObjectIdstringThe page object ID where the image was inserted
imageUrlstringThe source image URL
urlstringURL to open the presentation

Get Slide Thumbnail

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
pageObjectIdstringYesThe object ID of the slide/page to get a thumbnail for
thumbnailSizestringNoThe size of the thumbnail: SMALL (200px), MEDIUM (800px), or LARGE (1600px). Defaults to MEDIUM.
mimeTypestringNoThe MIME type of the thumbnail image: PNG. Defaults to PNG.

Output

ParameterTypeDescription
contentUrlstringURL to the thumbnail image (valid for 30 minutes)
widthnumberWidth of the thumbnail in pixels
heightnumberHeight of the thumbnail in pixels
metadatajsonOperation metadata including presentation ID and page object ID
presentationIdstringThe presentation ID
pageObjectIdstringThe page object ID for the thumbnail
thumbnailSizestringThe requested thumbnail size
mimeTypestringThe thumbnail MIME type

Get Slide Page

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
pageObjectIdstringYesThe object ID of the slide/page to retrieve

Output

ParameterTypeDescription
objectIdstringThe object ID of the page
pageTypestringThe type of page (SLIDE, MASTER, LAYOUT, NOTES, NOTES_MASTER)
pageElementsarrayArray of page elements (shapes, images, tables, etc.) on this page
slidePropertiesobjectProperties specific to slides (layout, master, notes)
layoutObjectIdstringObject ID of the layout this slide is based on
masterObjectIdstringObject ID of the master this slide is based on
notesPagejsonThe notes page associated with the slide
metadataobjectOperation metadata including presentation ID and URL
presentationIdstringThe presentation ID
urlstringURL 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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesThe object ID of the element or slide to delete

Output

ParameterTypeDescription
deletedbooleanWhether the object was successfully deleted
objectIdstringThe object ID that was deleted
metadataobjectOperation metadata including presentation ID and URL
presentationIdstringThe presentation ID
urlstringURL to the presentation

Duplicate Object in Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesThe object ID of the element or slide to duplicate
objectIdsstringNoOptional JSON object mapping source object IDs (within the slide being duplicated) to new object IDs for the duplicates. Format: {"sourceId1":"newId1","sourceId2":"newId2"}

Output

ParameterTypeDescription
duplicatedObjectIdstringThe object ID of the newly created duplicate
metadataobjectOperation metadata including presentation ID and source object ID
presentationIdstringThe presentation ID
sourceObjectIdstringThe original object ID that was duplicated
urlstringURL to the presentation

Reorder Slides in Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
slideObjectIdsstringYesComma-separated list of slide object IDs to move. The slides will maintain their relative order.
insertionIndexnumberYesThe zero-based index where the slides should be moved. All slides with indices greater than or equal to this will be shifted right.

Output

ParameterTypeDescription
movedbooleanWhether the slides were successfully moved
slideObjectIdsarrayThe slide object IDs that were moved
insertionIndexnumberThe index where the slides were moved to
metadataobjectOperation metadata including presentation ID and URL
presentationIdstringThe presentation ID
urlstringURL to the presentation

Create Table in Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
pageObjectIdstringYesThe object ID of the slide/page to add the table to
rowsnumberYesNumber of rows in the table (minimum 1)
columnsnumberYesNumber of columns in the table (minimum 1)
widthnumberNoWidth of the table in points (default: 400)
heightnumberNoHeight of the table in points (default: 200)
positionXnumberNoX position from the left edge in points (default: 100)
positionYnumberNoY position from the top edge in points (default: 100)

Output

ParameterTypeDescription
tableIdstringThe object ID of the newly created table
rowsnumberNumber of rows in the table
columnsnumberNumber of columns in the table
metadataobjectOperation metadata including presentation ID and page object ID
presentationIdstringThe presentation ID
pageObjectIdstringThe page object ID where the table was created
urlstringURL 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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
pageObjectIdstringYesThe object ID of the slide/page to add the shape to
shapeTypestringYesThe type of shape to create. Common types: TEXT_BOX, RECTANGLE, ROUND_RECTANGLE, ELLIPSE, TRIANGLE, DIAMOND, STAR_5, ARROW_EAST, HEART, CLOUD
widthnumberNoWidth of the shape in points (default: 200)
heightnumberNoHeight of the shape in points (default: 100)
positionXnumberNoX position from the left edge in points (default: 100)
positionYnumberNoY position from the top edge in points (default: 100)

Output

ParameterTypeDescription
shapeIdstringThe object ID of the newly created shape
shapeTypestringThe type of shape that was created
metadataobjectOperation metadata including presentation ID and page object ID
presentationIdstringThe presentation ID
pageObjectIdstringThe page object ID where the shape was created
urlstringURL 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.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesThe object ID of the shape or table cell to insert text into. For table cells, use the cell object ID.
textstringYesThe text to insert
insertionIndexnumberNoThe zero-based index at which to insert the text. If not specified, text is inserted at the beginning (index 0).

Output

ParameterTypeDescription
insertedbooleanWhether the text was successfully inserted
objectIdstringThe object ID where text was inserted
textstringThe text that was inserted
metadataobjectOperation metadata including presentation ID and URL
presentationIdstringThe presentation ID
urlstringURL 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.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the shape or table containing the text
rowIndexnumberNoWhen targeting a table cell, the zero-based row index
columnIndexnumberNoWhen targeting a table cell, the zero-based column index
rangeTypestringNoRange to style: ALL (default), FROM_START_INDEX, or FIXED_RANGE
startIndexnumberNoStart index for FROM_START_INDEX or FIXED_RANGE
endIndexnumberNoEnd index for FIXED_RANGE
boldbooleanNoWhether the text is bold
italicbooleanNoWhether the text is italic
underlinebooleanNoWhether the text is underlined
strikethroughbooleanNoWhether the text has strikethrough
smallCapsbooleanNoWhether the text is rendered in small caps
fontFamilystringNoFont family name (must be a font available to Google Slides)
fontSizenumberNoFont size in points
foregroundColorstringNoText color as hex (e.g. #1A73E8)
backgroundColorstringNoText background color as hex (e.g. #FFF8E1)
linkUrlstringNoConvert the range to a hyperlink with this URL
baselineOffsetstringNoBaseline offset: NONE, SUPERSCRIPT, or SUBSCRIPT
styleJsonstringNoAdvanced: raw TextStyle JSON merged with the simple fields above (overrides them on conflict)
fieldsstringNoAdvanced: explicit FieldMask. If omitted, the mask is computed from the fields you provided (or "*" when styleJson is used without explicit fields).

Output

ParameterTypeDescription
updatedbooleanWhether the text style was updated
objectIdstringThe object whose text was styled
fieldsstringFieldMask applied
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL 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.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the shape or table containing the text
rowIndexnumberNoWhen targeting a table cell, the zero-based row index
columnIndexnumberNoWhen targeting a table cell, the zero-based column index
rangeTypestringNoRange to style: ALL (default), FROM_START_INDEX, or FIXED_RANGE
startIndexnumberNoStart index for FROM_START_INDEX or FIXED_RANGE
endIndexnumberNoEnd index for FIXED_RANGE
alignmentstringNoText alignment: START, CENTER, END, or JUSTIFIED
lineSpacingnumberNoLine spacing as a percentage (100 = single, 200 = double)
indentStartnumberNoStart-edge indent in points
indentEndnumberNoEnd-edge indent in points
indentFirstLinenumberNoFirst-line indent in points
spaceAbovenumberNoSpace above the paragraph in points
spaceBelownumberNoSpace below the paragraph in points
directionstringNoText direction: LEFT_TO_RIGHT or RIGHT_TO_LEFT
spacingModestringNoSpacing mode: NEVER_COLLAPSE or COLLAPSE_LISTS
styleJsonstringNoAdvanced: raw ParagraphStyle JSON merged with the simple fields above
fieldsstringNoAdvanced: explicit FieldMask. If omitted, computed from provided fields.

Output

ParameterTypeDescription
updatedbooleanWhether the paragraph style was updated
objectIdstringThe object whose paragraph was styled
fieldsstringFieldMask applied
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL 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.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the shape or table containing the text
rowIndexnumberNoWhen targeting a table cell, the zero-based row index
columnIndexnumberNoWhen targeting a table cell, the zero-based column index
rangeTypestringNoRange to delete: ALL (default), FROM_START_INDEX, or FIXED_RANGE
startIndexnumberNoStart index for FROM_START_INDEX or FIXED_RANGE
endIndexnumberNoEnd index for FIXED_RANGE

Output

ParameterTypeDescription
deletedbooleanWhether the text was deleted
objectIdstringThe object whose text was deleted
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL 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.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the shape or table containing the text
rowIndexnumberNoWhen targeting a table cell, the zero-based row index
columnIndexnumberNoWhen targeting a table cell, the zero-based column index
rangeTypestringNoRange to apply bullets to: ALL (default), FROM_START_INDEX, or FIXED_RANGE
startIndexnumberNoStart index for FROM_START_INDEX or FIXED_RANGE
endIndexnumberNoEnd index for FIXED_RANGE
bulletPresetstringNoBullet 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

ParameterTypeDescription
createdbooleanWhether bullets were created
objectIdstringThe object where bullets were created
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation

Delete Paragraph Bullets in Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the shape or table containing the text
rowIndexnumberNoWhen targeting a table cell, the zero-based row index
columnIndexnumberNoWhen targeting a table cell, the zero-based column index
rangeTypestringNoRange to clear bullets from: ALL (default), FROM_START_INDEX, or FIXED_RANGE
startIndexnumberNoStart index for FROM_START_INDEX or FIXED_RANGE
endIndexnumberNoEnd index for FIXED_RANGE

Output

ParameterTypeDescription
deletedbooleanWhether bullets were deleted
objectIdstringThe object whose bullets were deleted
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL 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.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
imageUrlstringYesPublicly fetchable image URL (PNG, JPEG, or GIF; max 50 MB and accessible to Google's servers)
findTextstringYesText content of shapes to replace (e.g. {{cover-image}})
matchCasebooleanNoCase-sensitive match (default: true)
imageReplaceMethodstringNoHow the image fits the shape: CENTER_INSIDE (preserve aspect, fit inside) or CENTER_CROP (fill, crop overflow). Default: CENTER_INSIDE.
pageObjectIdsstringNoComma-separated slide IDs to limit replacement to specific slides

Output

ParameterTypeDescription
occurrencesChangednumberNumber of shapes that were replaced with the image
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation
imageUrlstringThe image URL inserted
findTextstringThe 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.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
imageObjectIdstringYesObject ID of the existing image to replace
imageUrlstringYesNew publicly fetchable image URL (PNG, JPEG, or GIF, max 50 MB)
imageReplaceMethodstringNoCENTER_INSIDE (preserve aspect) or CENTER_CROP (fill, crop overflow). Default: CENTER_INSIDE.

Output

ParameterTypeDescription
replacedbooleanWhether the image was replaced
imageObjectIdstringThe image object that was replaced
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation
imageUrlstringThe new image URL

Update Image Properties in Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the image to update
brightnessnumberNoBrightness adjustment between -1.0 and 1.0
contrastnumberNoContrast adjustment between -1.0 and 1.0
transparencynumberNoTransparency between 0.0 (opaque) and 1.0 (fully transparent)
linkUrlstringNoMake the image a hyperlink to this URL
outlineColorstringNoOutline color as hex (e.g. #1A73E8)
outlineWeightnumberNoOutline weight in points
outlineDashStylestringNoOutline dash style: SOLID, DOT, DASH, DASH_DOT, LONG_DASH, LONG_DASH_DOT
cropLeftOffsetnumberNoCrop offset from left edge (0.0 to 1.0)
cropRightOffsetnumberNoCrop offset from right edge (0.0 to 1.0)
cropTopOffsetnumberNoCrop offset from top edge (0.0 to 1.0)
cropBottomOffsetnumberNoCrop offset from bottom edge (0.0 to 1.0)
cropAnglenumberNoCrop rotation angle in radians (clockwise)
propertiesJsonstringNoAdvanced: raw ImageProperties JSON merged with the simple fields above
fieldsstringNoAdvanced: explicit FieldMask. If omitted, computed from provided fields.

Output

ParameterTypeDescription
updatedbooleanWhether the image properties were updated
objectIdstringThe image object updated
fieldsstringFieldMask applied
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL 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.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the shape to update
fillColorstringNoSolid background fill color as hex (e.g. #FF6F61)
fillAlphanumberNoFill opacity between 0.0 (transparent) and 1.0 (opaque)
fillUnsetbooleanNoWhen true, removes any fill so the shape inherits its layout/master fill
outlineColorstringNoOutline color as hex
outlineWeightnumberNoOutline weight in points
outlineDashStylestringNoOutline dash style: SOLID, DOT, DASH, DASH_DOT, LONG_DASH, LONG_DASH_DOT
outlineUnsetbooleanNoWhen true, removes any outline so the shape inherits its layout/master outline
linkUrlstringNoMake the shape a hyperlink to this URL
contentAlignmentstringNoVertical alignment of shape contents: TOP, MIDDLE, or BOTTOM
autofitTypestringNoAutofit behavior: NONE, TEXT_AUTOFIT, or SHAPE_AUTOFIT
propertiesJsonstringNoAdvanced: raw ShapeProperties JSON merged with the simple fields above
fieldsstringNoAdvanced: explicit FieldMask. If omitted, computed from provided fields.

Output

ParameterTypeDescription
updatedbooleanWhether the shape properties were updated
objectIdstringThe shape object updated
fieldsstringFieldMask applied
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation

Update Page Properties in Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the slide/page to update
backgroundColorstringNoSolid background color as hex (e.g. #0B1F3A)
backgroundAlphanumberNoBackground fill opacity between 0.0 and 1.0
backgroundImageUrlstringNoPublicly fetchable image URL to use as a stretched picture background
backgroundUnsetbooleanNoWhen true, removes the background so the slide inherits its layout background
propertiesJsonstringNoAdvanced: raw PageProperties JSON merged with the simple fields above
fieldsstringNoAdvanced: explicit FieldMask. If omitted, computed from provided fields.

Output

ParameterTypeDescription
updatedbooleanWhether the page properties were updated
objectIdstringThe page object updated
fieldsstringFieldMask applied
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation

Update Slide Properties in Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the slide to update
isSkippedbooleanNoWhether the slide is skipped in presentation mode
propertiesJsonstringNoAdvanced: raw SlideProperties JSON merged with the simple fields above
fieldsstringNoAdvanced: explicit FieldMask. If omitted, computed from provided fields.

Output

ParameterTypeDescription
updatedbooleanWhether the slide properties were updated
objectIdstringThe slide object updated
fieldsstringFieldMask applied
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL 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.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the page element
titlestringNoAccessibility title for the element
descriptionstringNoAccessibility description (alt text) for the element

Output

ParameterTypeDescription
updatedbooleanWhether alt text was updated
objectIdstringThe element updated
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL 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).

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the page element to transform
scaleXnumberNoHorizontal scale factor (default 1)
scaleYnumberNoVertical scale factor (default 1)
shearXnumberNoHorizontal shear factor (default 0)
shearYnumberNoVertical shear factor (default 0)
translateXnumberNoX position in points (absolute) or delta (relative)
translateYnumberNoY position in points (absolute) or delta (relative)
applyModestringNoABSOLUTE replaces the current transform; RELATIVE multiplies with it. Default ABSOLUTE.

Output

ParameterTypeDescription
updatedbooleanWhether the transform was updated
objectIdstringThe element transformed
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation

Update Z-Order in Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdsstringYesComma-separated object IDs of the elements to reorder
operationstringYesBRING_TO_FRONT, BRING_FORWARD, SEND_BACKWARD, or SEND_TO_BACK

Output

ParameterTypeDescription
reorderedbooleanWhether the z-order was changed
objectIdsarrayElements reordered
operationstringOperation applied
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation

Group Objects in Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
childrenObjectIdsstringYesComma-separated object IDs of the elements to group (must be on the same slide)
groupObjectIdstringNoOptional object ID to assign to the new group

Output

ParameterTypeDescription
groupedbooleanWhether the objects were grouped
groupObjectIdstringObject ID of the new group
childrenObjectIdsarrayIDs of the grouped children
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation

Ungroup Objects in Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdsstringYesComma-separated object IDs of the groups to ungroup

Output

ParameterTypeDescription
ungroupedbooleanWhether the objects were ungrouped
objectIdsarrayGroup IDs that were ungrouped
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation

Create Line in Google Slides

Create a line or connector on a slide.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
pageObjectIdstringYesObject ID of the slide to add the line to
lineCategorystringNoSTRAIGHT (default), BENT, or CURVED
widthnumberNoLine width in points (default 200)
heightnumberNoLine height in points (default 0 — horizontal line)
positionXnumberNoX position in points (default 100)
positionYnumberNoY position in points (default 100)

Output

ParameterTypeDescription
lineIdstringObject ID of the new line
lineCategorystringLine category created
metadataobjectOperation metadata
presentationIdstringThe presentation ID
pageObjectIdstringThe slide ID
urlstringURL to the presentation

Update Line Properties in Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the line
lineColorstringNoLine color as hex
lineWeightnumberNoLine weight in points
dashStylestringNoDash style: SOLID, DOT, DASH, DASH_DOT, LONG_DASH, LONG_DASH_DOT
startArrowstringNoStart arrow style: NONE, STEALTH_ARROW, FILL_ARROW, FILL_CIRCLE, FILL_SQUARE, FILL_DIAMOND, OPEN_ARROW, OPEN_CIRCLE, OPEN_SQUARE, OPEN_DIAMOND
endArrowstringNoEnd arrow style (same values as startArrow)
linkUrlstringNoHyperlink URL
propertiesJsonstringNoAdvanced: raw LineProperties JSON merged with the simple fields above
fieldsstringNoAdvanced: explicit FieldMask. If omitted, computed from provided fields.

Output

ParameterTypeDescription
updatedbooleanWhether the line properties were updated
objectIdstringThe line object updated
fieldsstringFieldMask applied
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation

Update Line Category in Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the connector line
lineCategorystringYesNew line category: STRAIGHT, BENT, or CURVED

Output

ParameterTypeDescription
updatedbooleanWhether the line category was updated
objectIdstringThe line object updated
lineCategorystringNew line category
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL 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.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the connector line to reroute

Output

ParameterTypeDescription
reroutedbooleanWhether the line was rerouted
objectIdstringThe line object rerouted
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation

Insert Table Rows in Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
tableObjectIdstringYesObject ID of the table
rowIndexnumberYesZero-based row index of the reference cell
columnIndexnumberYesZero-based column index of the reference cell
numbernumberYesNumber of rows to insert (minimum 1)
insertBelowbooleanNoInsert below the reference row instead of above (default false)

Output

ParameterTypeDescription
insertedbooleanWhether rows were inserted
tableObjectIdstringThe table updated
numbernumberNumber of rows inserted
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation

Insert Table Columns in Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
tableObjectIdstringYesObject ID of the table
rowIndexnumberYesZero-based row index of the reference cell
columnIndexnumberYesZero-based column index of the reference cell
numbernumberYesNumber of columns to insert (minimum 1)
insertRightbooleanNoInsert to the right of the reference column instead of left (default false)

Output

ParameterTypeDescription
insertedbooleanWhether columns were inserted
tableObjectIdstringThe table updated
numbernumberNumber of columns inserted
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation

Delete Table Row in Google Slides

Delete the row containing the reference cell from a table.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
tableObjectIdstringYesObject ID of the table
rowIndexnumberYesZero-based row index identifying the row to delete
columnIndexnumberYesZero-based column index of any cell in the row

Output

ParameterTypeDescription
deletedbooleanWhether the row was deleted
tableObjectIdstringThe table updated
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation

Delete Table Column in Google Slides

Delete the column containing the reference cell from a table.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
tableObjectIdstringYesObject ID of the table
rowIndexnumberYesZero-based row index of any cell in the column
columnIndexnumberYesZero-based column index identifying the column to delete

Output

ParameterTypeDescription
deletedbooleanWhether the column was deleted
tableObjectIdstringThe table updated
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL 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.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the table
rowIndexnumberYesZero-based row index of the top-left cell
columnIndexnumberYesZero-based column index of the top-left cell
rowSpannumberYesNumber of rows to merge (minimum 1)
columnSpannumberYesNumber of columns to merge (minimum 1)

Output

ParameterTypeDescription
mergedbooleanWhether the cells were merged
objectIdstringThe table updated
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation

Unmerge Table Cells in Google Slides

Unmerge any merged cells within the given table range.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the table
rowIndexnumberYesZero-based row index of the top-left cell of the range
columnIndexnumberYesZero-based column index of the top-left cell of the range
rowSpannumberYesNumber of rows in the range (minimum 1)
columnSpannumberYesNumber of columns in the range (minimum 1)

Output

ParameterTypeDescription
unmergedbooleanWhether the cells were unmerged
objectIdstringThe table updated
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation

Update Table Cell Properties in Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the table
rowIndexnumberYesZero-based row index of the top-left cell of the range
columnIndexnumberYesZero-based column index of the top-left cell of the range
rowSpannumberYesNumber of rows in the range (minimum 1)
columnSpannumberYesNumber of columns in the range (minimum 1)
backgroundColorstringNoCell background color as hex (e.g. #F1F3F4)
backgroundAlphanumberNoBackground fill opacity between 0.0 and 1.0
contentAlignmentstringNoVertical alignment of cell content: TOP, MIDDLE, or BOTTOM
propertiesJsonstringNoAdvanced: raw TableCellProperties JSON merged with the simple fields above
fieldsstringNoAdvanced: explicit FieldMask. If omitted, computed from provided fields.

Output

ParameterTypeDescription
updatedbooleanWhether the cell properties were updated
objectIdstringThe table updated
fieldsstringFieldMask applied
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL 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.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the table
rowIndexnumberYesZero-based row index of the top-left cell of the range
columnIndexnumberYesZero-based column index of the top-left cell of the range
rowSpannumberYesNumber of rows in the range (minimum 1)
columnSpannumberYesNumber of columns in the range (minimum 1)
borderPositionstringNoWhich borders to update: ALL (default), BOTTOM, INNER, INNER_HORIZONTAL, INNER_VERTICAL, LEFT, OUTER, RIGHT, TOP
borderColorstringNoBorder color as hex
borderWeightnumberNoBorder weight in points
dashStylestringNoDash style: SOLID, DOT, DASH, DASH_DOT, LONG_DASH, LONG_DASH_DOT
propertiesJsonstringNoAdvanced: raw TableBorderProperties JSON merged with the simple fields above
fieldsstringNoAdvanced: explicit FieldMask. If omitted, computed from provided fields.

Output

ParameterTypeDescription
updatedbooleanWhether the border properties were updated
objectIdstringThe table updated
fieldsstringFieldMask applied
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation

Update Table Column Properties in Google Slides

Update column widths and other column-level table properties.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the table
columnIndicesstringYesComma-separated zero-based column indices to update (e.g. "0,2,3")
columnWidthnumberNoColumn width in points
propertiesJsonstringNoAdvanced: raw TableColumnProperties JSON merged with the simple fields above
fieldsstringNoAdvanced: explicit FieldMask. If omitted, computed from provided fields.

Output

ParameterTypeDescription
updatedbooleanWhether the column properties were updated
objectIdstringThe table updated
fieldsstringFieldMask applied
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation

Update Table Row Properties in Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the table
rowIndicesstringYesComma-separated zero-based row indices to update (e.g. "0,2,3")
minRowHeightnumberNoMinimum row height in points
propertiesJsonstringNoAdvanced: raw TableRowProperties JSON merged with the simple fields above
fieldsstringNoAdvanced: explicit FieldMask. If omitted, computed from provided fields.

Output

ParameterTypeDescription
updatedbooleanWhether the row properties were updated
objectIdstringThe table updated
fieldsstringFieldMask applied
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL 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.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
pageObjectIdstringYesObject ID of the slide to add the chart to
spreadsheetIdstringYesGoogle Sheets spreadsheet ID containing the chart
chartIdnumberYesNumeric chart ID within the spreadsheet
linkingModestringNoLINKED (default) or NOT_LINKED_IMAGE
widthnumberNoWidth in points (default 400)
heightnumberNoHeight in points (default 300)
positionXnumberNoX position in points (default 100)
positionYnumberNoY position in points (default 100)

Output

ParameterTypeDescription
chartObjectIdstringObject ID of the inserted chart
metadataobjectOperation metadata
presentationIdstringThe presentation ID
pageObjectIdstringThe slide ID
urlstringURL to the presentation

Refresh Sheets Chart in Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the embedded chart to refresh

Output

ParameterTypeDescription
refreshedbooleanWhether the chart was refreshed
objectIdstringThe chart object refreshed
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL 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.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
spreadsheetIdstringYesGoogle Sheets spreadsheet ID containing the chart
chartIdnumberYesNumeric chart ID within the spreadsheet
findTextstringYesText content of shapes to replace (e.g. {{revenue-chart}})
matchCasebooleanNoCase-sensitive match (default true)
linkingModestringNoLINKED (default) or NOT_LINKED_IMAGE
pageObjectIdsstringNoComma-separated slide IDs to limit replacement to specific slides

Output

ParameterTypeDescription
occurrencesChangednumberNumber of shapes replaced with the chart
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation
findTextstringThe matched text token
spreadsheetIdstringSource spreadsheet ID
chartIdnumberSource chart ID

Embed Video in Google Slides

Embed a YouTube or Google Drive video on a slide.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
pageObjectIdstringYesObject ID of the slide to add the video to
sourcestringYesYOUTUBE or DRIVE
videoIdstringYesYouTube video ID or Drive file ID
widthnumberNoWidth in points (default 400)
heightnumberNoHeight in points (default 225)
positionXnumberNoX position in points (default 100)
positionYnumberNoY position in points (default 100)

Output

ParameterTypeDescription
videoObjectIdstringObject ID of the inserted video
metadataobjectOperation metadata
presentationIdstringThe presentation ID
pageObjectIdstringThe slide ID
urlstringURL to the presentation

Update Video Properties in Google Slides

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

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
objectIdstringYesObject ID of the video
autoPlaybooleanNoPlay the video automatically when the slide is shown
mutebooleanNoMute the video
startnumberNoPlayback start time in seconds
endnumberNoPlayback end time in seconds
outlineColorstringNoOutline color as hex
outlineWeightnumberNoOutline weight in points
outlineDashStylestringNoOutline dash style
propertiesJsonstringNoAdvanced: raw VideoProperties JSON merged with the simple fields above
fieldsstringNoAdvanced: explicit FieldMask. If omitted, computed from provided fields.

Output

ParameterTypeDescription
updatedbooleanWhether the video properties were updated
objectIdstringThe video object updated
fieldsstringFieldMask applied
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL 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).

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
requestsstringYesJSON 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"}}]
writeControlstringNoOptional JSON WriteControl object for optimistic concurrency, e.g. {"requiredRevisionId":"..."}

Output

ParameterTypeDescription
repliesarrayArray of reply objects, one per request (parallel-indexed)
writeControljsonWriteControl returned by the server (revision tracking)
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation
requestCountnumberNumber 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.

Input

ParameterTypeRequiredDescription
sourcePresentationIdstringYesDrive file ID of the source/template presentation
titlestringNoTitle for the copy. Defaults to "Copy of <source title>".
folderIdstringNoDrive folder ID where the copy should be placed

Output

ParameterTypeDescription
presentationIdstringID of the new copied presentation
titlestringTitle of the new presentation
metadataobjectOperation metadata
sourcePresentationIdstringSource/template presentation ID
presentationIdstringNew presentation ID
titlestringNew presentation title
mimeTypestringMIME type of the presentation
urlstringURL 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.

Input

ParameterTypeRequiredDescription
presentationIdstringYesGoogle Slides presentation ID
exportFormatstringNoFormat: PDF (default), PPTX, ODP, TXT, PNG, JPEG, or SVG

Output

ParameterTypeDescription
filefileStored exported presentation file
contentBase64stringDeprecated legacy inline content. New exports return file.
mimeTypestringMIME type of the exported content
sizeBytesnumberSize of the exported content in bytes
metadataobjectOperation metadata
presentationIdstringThe presentation ID
urlstringURL to the presentation
exportFormatstringExport format used