# Format Shape — Google Slides

> 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

- Key: `google_slides-format-shape`
- Type: Action (Write)
- Version: 0.0.2
- App: Google Slides (`google_slides`) — https://pipedream.com/apps/google-slides.md
- This page (HTML): https://pipedream.com/apps/google-slides/actions/format-shape
- Hints: open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/google_slides/actions/format-shape/format-shape.mjs

## Description

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](https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/request#UpdateShapePropertiesRequest)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `presentationId` | `string` | Yes | 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. |
| `objectId` | `string` | Yes | The object ID of the shape to format. Use Get Presentation and read slides[].pageElements[].objectId. |
| `backgroundColor` | `string` | No | Fill color as a hex code (e.g. #FF0000) or a theme color name (e.g. ACCENT1). |
| `backgroundOpacity` | `integer` | No | 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. |
| `outlineColor` | `string` | No | Outline color as a 6-digit hex code (e.g. #FF0000) or one of the deck's theme colors (e.g. ACCENT1, DARK1). |
| `outlineOpacity` | `integer` | No | Opacity of the outline as a whole percentage, from 0 (fully transparent) to 100 (fully opaque). |
| `outlineWeight` | `integer` | No | Outline thickness in points (1-100). |
| `outlineDashStyle` | `string` | No | Dash pattern for the outline. One of SOLID, DOT, DASH, DASH_DOT, LONG_DASH or LONG_DASH_DOT - e.g. DASH. |
| `contentAlignment` | `string` | No | Vertical alignment of the text within the element. One of TOP, MIDDLE or BOTTOM - e.g. MIDDLE to centre the text vertically. |
| `link` | `string` | No | Make the shape link to this absolute URL, e.g. https://example.com/report. |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
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 accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "google_slides",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
  name: "google_slides-format-shape",
  arguments: {
    presentationId: "Presentation ID",
    objectId: "Page Element ID",
  },
})
```

**TypeScript**

```ts
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)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "google_slides-format-shape",
    "configured_props": {
      "google_slides": { "authProvisionId": "apn_xxxxxxx" },
      "presentationId": "Presentation ID",
      "objectId": "Page Element ID"
    }
  }'
```

---

- App: https://pipedream.com/apps/google-slides.md · All apps: https://pipedream.com/apps