Skip to content
Nappai Documentation

Google Slides

Google Slides is a component that lets you work with Google Slides presentations directly from the Nappai dashboard. You can get information about slides, create new presentations, replace text or images, and more—all without leaving the platform.

How it Works

The component talks to the Google Slides API. When you run an operation, Nappai sends a request to Google, receives the response, and passes the data back into your workflow. All the heavy lifting—authentication, API calls, and data formatting—is handled for you, so you only need to supply the required inputs.

Operations

This component offers several operations that you can select based on what you need to do. You can only use one operation at a time:

  • Get Page: Retrieve the content of a specific slide by its ID or URL.
  • Get Thumbnail: Get a thumbnail image of a slide for quick preview.
  • Create Presentation: Create a new blank presentation or from a template.
  • Get Presentation: List all presentations or get details of a specific one.
  • Get Slides: Retrieve all slides in a presentation.
  • Replace Text: Find and replace text on a slide.
  • Replace Image: Replace an image on a slide with a new one from a URL.

To use the component, first select the operation you need in the “Operation” field.

Inputs

Mapping Mode

This component has a special mode called “Mapping Mode”. When you enable this mode using the toggle switch, an additional input called “Mapping Data” is activated, and each input field offers you three different ways to provide data:

  • Fixed: You type the value directly into the field.
  • Mapped: You connect the output of another component to use its result as the value.
  • Javascript: You write Javascript code to dynamically calculate the value.

This flexibility allows you to create more dynamic and connected workflows.

Input Fields

The following fields are available to configure this component. Each field may be visible in different operations:

  • Credential: Select the Slides API credential you have configured in Nappai.

    • Visible in: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

  • Presentation File: Select a Google Slides presentation. In create presentation, if Presentation ID not provided it will create an empty presentation. In get presentation, if Presentation ID not provided it will return all the presentations.

    • Visible in: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

  • Operation: Choose the operation you want to perform.

    • Visible in: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

  • Last Url: The last URL used for your Google Slides.

    • Visible in: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

  • Mapping Mode: Enable mapping mode to process multiple data records in batch.

    • Visible in: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

  • Mode of Input: Mode to use.

    • If By Id its selected, the inputs will be Id
    • If By Selection its selected, the inputs will be a selection.
    • If By Url its selected, the inputs will be Url
    • Visible in: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

  • Object ID to Replace: The object id to replace in your Google Slides.

    • Visible in: Replace Image

  • Page Object ID: The page object id for your Google Slides.

    • Visible in: Get Page, Get Thumbnail

  • Presentation ID: The presentation id for your Google Slides. In create presentation, if Presentation ID not provided it will create an empty presentation. In get presentation, if Presentation ID not provided it will return all the presentations.

    • Visible in: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

  • Replace Text: The text to replace in your Google Slides.

    • Visible in: Replace Text

  • Replace Image URL: The URL of the new image that will replace the old one.

    • Visible in: Replace Image

  • Search Text: The text to search for in your Google Slides.

    • Visible in: Replace Text

  • Title Presentation: The title for the presentation. Used for ‘Create Presentation’ and ‘Create Presentation-From-Template’.

    • Visible in: Create Presentation

  • Tool Name: The name of the tool that will be used when this component is connected as a tool. This name will be displayed to the agent when it selects tools to use.

    • Visible in: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

  • Tool Description: A detailed description of what this tool does. This description will help the agent understand when and how to use this tool effectively.

    • Visible in: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

  • Tools arguments metadata: Defines the arguments metadata for the tools.

    • Visible in: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

Outputs

  • Data: The raw data returned from the Google Slides API (e.g., slide content, presentation details).
  • Tool: A tool representation that can be used by agents to call this component programmatically.

Usage Example

Scenario: You want to replace the word “Draft” with “Final” on slide 3 of a presentation.

  1. Drag the Google Slides component onto the canvas.
  2. Set Operation to Replace Text.
  3. In Mode of Input, choose By Id.
  4. Enter the Presentation ID of your presentation.
  5. Enter Page Object ID (the ID of slide 3).
  6. Set Search Text to “Draft”.
  7. Set Replace Text to “Final”.
  8. Connect the Credential field to the Slides API credential you created earlier.
  9. Run the workflow. The component will update the slide and output the updated slide data.
  • Google Drive – Manage files and folders in Google Drive.
  • Google Docs – Create and edit Google Docs documents.
  • Google Sheets – Read and write data in Google Sheets.

Tips and Best Practices

  • Keep your Slides API credential secure; never share it publicly.
  • Use Mapping Mode when you need to process many slides or presentations in a single run.
  • Test operations with a small sample presentation before applying changes to production files.
  • When replacing images, ensure the image URL is publicly accessible or hosted in a location Google Slides can fetch.

Security Considerations

  • The component uses OAuth credentials stored in Nappai. Make sure the credential has the minimum scopes required for the operations you need.
  • Do not expose the credential details in logs or outputs.
  • Regularly rotate your client secrets and review access permissions in the Google Cloud Console.