View as Markdown
Google Slides icon

Google Slides ACTION

Format Shape

Set the background fill, outline, content alignment, or link of a shape in a Google Slides presentation. Use Get Presentation to find the shape's object ID. Shadow is not settable. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Google Slides account once, then configure and run Format Shape from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "google_slides-format-shape",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    google_slides: { authProvisionId: "apn_xxxxxxx" },
    presentationId: "Presentation ID",
    objectId: "Page Element ID",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Format Shape inputs
Property Type Description
presentationId Presentation ID string
The ID of the presentation. This is the long string in the URL: https://docs.google.com/presentation/d/{PRESENTATION_ID}/edit. A full presentation URL is also accepted. Use Find Presentation to resolve a name to its ID.
Required
objectId Page Element ID string
The object ID of the shape to format. Use Get Presentation and read slides[].pageElements[].objectId.
Required
backgroundColor Background Color string
Fill color as a hex code (e.g. #FF0000) or a theme color name (e.g. ACCENT1).
Optional
backgroundOpacity Background Opacity integer
Opacity of the fill as a whole percentage, from 0 (fully transparent) to 100 (fully opaque). Can be set on its own to change an existing fill's opacity without restating its color.
Optional
outlineColor Outline Color string
Outline color as a 6-digit hex code (e.g. #FF0000) or one of the deck's theme colors (e.g. ACCENT1, DARK1).
Optional
outlineOpacity Outline Opacity integer
Opacity of the outline as a whole percentage, from 0 (fully transparent) to 100 (fully opaque).
Optional
outlineWeight Outline Weight integer
Outline thickness in points (1-100).
Optional
outlineDashStyle Outline Dash Style string
Dash pattern for the outline. One of SOLID, DOT, DASH, DASH_DOT, LONG_DASH or LONG_DASH_DOT - e.g. DASH.
Optional
contentAlignment Content Alignment string
Vertical alignment of the text within the element. One of TOP, MIDDLE or BOTTOM - e.g. MIDDLE to centre the text vertically.
Optional
link Link URL string
Make the shape link to this absolute URL, e.g. https://example.com/report.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
google_slides-format-shape
Version
0.0.2
App
Google Slides
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes