Slides

The Slides component allows you to automate tasks involving Google Slides presentations. You can use this component to create new presentations, retrieve existing slides, replace text or images, and generate thumbnails. It acts as a bridge between your automation workflows in Nappai and your Google Drive presentations, allowing for both reading and writing operations depending on the selected action.

How it Works

This component connects directly to the Google Slides API. When you use this node in your Nappai dashboard, it performs one specific operation from a list of seven possible actions. You must first select the desired operation using the Operation field.

Once the operation is selected, the component uses the Presentation File or Presentation ID you provide to locate the specific Google Slides presentation you want to interact with. Depending on the operation, it will either fetch data (like slide content or images) from Google or modify the presentation (like changing text or updating images).

The component is designed to be flexible. If you enable Mapping Mode, you can use dynamic data from other parts of your workflow to determine which slides to edit or which text to replace, rather than using fixed values.

Connection & Credentials

This component requires configuring a credential in the Nappai panel before interacting with the external service:

1. Go to the Credentials section in your Nappai panel.
2. Create a new credential of the type Google Slides and fill in the required fields (Client Id, Client Secret, and Google Slides access).
3. In your workflow, select the saved credential in the Credential input field of this node.

Note: Ensure you have selected the correct Google Cloud Project and granted the necessary permissions for Google Slides.

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: Retrieves the content of a specific page (slide) within a presentation.
• Get Thumbnail: Generates and retrieves a thumbnail image of a specific slide.
• Create Presentation: Creates a new, empty Google Slides presentation.
• Get Presentation: Retrieves detailed information about a specific presentation, such as its title or ID.
• Get Slides: Retrieves a list of all slides within a presentation.
• Replace Text: Searches for specific text in a slide and replaces it with new text.
• Replace Image: Replaces an existing image in a slide with a new image from a provided 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:

• Presentation File: Select a Google Slides presentation. In create presentation, if Presentation ID not provided It will create an empty presentation.

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

• Operation: Select the specific action you want the component 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.

  • 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

• Server URL: The server url for your Google Slides.

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

• 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

• Max Results: The maximum number of results to return.

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

Outputs

The component produces the following outputs based on the selected operation:

• Data: The primary result of the operation. This will contain the requested slide information, text content, or confirmation of success in a structured format (JSON).
• Tool: A tool representation that can be used if this component is invoked by an AI agent within a larger workflow.

Output Data Example (JSON)

Below is an example of the Data output when retrieving a specific page (slide) from a presentation: json { “pageId”: “slide_id_12345”, “elements”: [ { “objectId”: “shape_01”, “shape”: { “text”: { “textFrames”: [ { “paragraphMarks”: [ { “runs”: [ { “textRun”: { “content”: “Hello World” } } ] } ] } ] } } } ], “slideProperties”: { “layoutObjectId”: “layout_abc” } }

Connectivity

This component is typically used in workflows that involve document processing, reporting, or presentation automation.

• Upstream: It often receives inputs from Google Drive components (to retrieve Presentation IDs) or Data Processing components (to provide text or images for replacement).
• Downstream: The Data output is usually connected to Text Processing components (to extract specific details from slides), File Output components (to save extracted text to a file), or AI Agent components (to analyze slide content).

For example, in a “Weekly Report Automation” workflow, you might use Get Slides to retrieve the latest presentation, then pass that data to an AI component to summarize the content.

Usage Example

Scenario: Updating a Slide Title with Dynamic Data

1. Select Operation: Set the Operation to Replace Text.
2. Connect Data:
   • In Presentation ID, map the ID from a previous step that created or retrieved a presentation.
   • In Search Text, enter “Q3 Revenue”.
   • In Replace Text, map the dynamic value from a previous step containing the new revenue figure (e.g., “$50,000”).
3. Run: The component will find the text “Q3 Revenue” in the specified slides and replace it with “$50,000”.

Important Notes

🔒 Security Protect Your Credentials [🔴 high] Store your OAuth client ID and secret securely and avoid sharing them. The component does not expose sensitive data, but compromised credentials could grant access to your Slides.

⚠️ Limitations Only Google Slides Supported [🟡 medium] This component works exclusively with Google Slides files; it cannot import or export other presentation formats such as PowerPoint or PDF.

Token Expiration [🟡 medium] OAuth tokens may expire during long sessions, causing operations to fail. If you encounter errors, re‑authenticate to refresh the token.

Read‑Only Slides [🟡 medium] If a presentation is set to read‑only, write operations will fail. Ensure the presentation has the correct edit permissions before running the component.

📋 Requirements Google Account and Permissions [🔴 high] You must have a Google account with access to the Slides you want to use, and the account must grant the component the necessary read/write permissions via OAuth.

Internet Connection [🟡 medium] The component communicates with Google Slides over the internet, so a stable internet connection is required for all operations.

💡 Best Practices Target Specific Slides [🟢 low] When possible, specify slide IDs or ranges instead of the entire presentation to reduce processing time and minimize accidental changes.

Test on Sample Data [🟢 low] Run the component on a sample or duplicate presentation first to confirm that it behaves as expected before applying it to important slides.

⚙️ Configuration Correct OAuth Scopes [🟡 medium] Make sure the OAuth client is configured with the proper scopes (e.g., https://www.googleapis.com/auth/presentations). Missing scopes will lead to authentication errors.

ℹ️ Behavior Component May Modify Slides [🟡 medium] Operations performed by the component can change slide content. Use the component on copies of your presentations if you need to preserve the original.

Tips and Best Practices

• Always test your workflows with a copy of your presentation to avoid accidental changes to your master files.
• Use the Mapping Mode to automate tasks across multiple presentations or slides by feeding in dynamic IDs or text from previous steps.
• Ensure your Google Cloud Console project has the correct OAuth scopes enabled for Slides to prevent authentication errors.
• If you are replacing text, ensure the “Search Text” matches exactly what is in the slide, including capitalization, to avoid missing updates.
• For large presentations, consider specifying specific slide IDs to improve performance and reduce the chance of unintended edits.

Security Considerations

This component relies on OAuth authentication. Ensure that you store your API keys and secrets in the Nappai credentials manager securely. Never expose your Client ID or Secret in public workflows. If you suspect your credentials have been compromised, revoke them in the Google Cloud Console immediately.