Skip to main content

Celonis Product Documentation

Google Slides (Action Flow)

With Google Slides modules in Celonis platform, you can create, update, list, and/or delete presentations and upload images to presentations in your Google Slides account.

To use the Google Slides modules, you must have a Google Slides account with slides and/or presentations in your Google Drive. You can create an account at https://accounts.google.com.

Refer to the Google Slides API documentation for a list of available endpoints.

Note

Celonis platform's use and transfer of information received from Google APIs to any other app will adhere to Google API Services User Data Policy.

Connect Google Slides to Celonis platform

To establish the connection in Celonis platform:

  1. Log in to your Celonis platform account, add a Google Slides module to your Action Flow, and click Create a connection.

  2. Optional: In the Connection name field, enter a name for the connection.

  3. Optional: Switch on the Show advanced settings toggle and enter your Google Cloud Console project client credentials. For more information, see the Create and configure a Google Cloud Console project for Google Slides section below.

  4. Click Sign in with Google.

  5. If prompted, authenticate your account and confirm access.

You have successfully established the connection. You can now edit your Action Flow and add more Google Slides modules. If your connection requires reauthorization at any point, follow the connection renewal steps here.

To connect to Celonis platform using your own client credentials, you can create and configure a project in the Google Cloud Console.

Create a Google Cloud Console project for Google Slides

To create a Google Cloud Console project:

  1. Log in to the Google Cloud Console using your Google credentials.

  2. In the top menu, click Select a project > New project.

  3. Enter a Project name and select the Location for your project.

  4. Click Create.

  5. In the top menu, check if your new project is selected in the Select a project dropdown. If not, select the project you just created.

Enable APIs for Google Slides

To enable the required APIs:

  1. Open the left navigation menu and go to APIs & Services > Library.

  2. Search for and enable the following APIs: Google Slides API, Google Drive API.

Configure your OAuth consent screen for Google Slides

To configure your OAuth consent screen:

  1. In the left sidebar, click OAuth consent screen.

  2. Under User Type, select External.

    For more information regarding user types, refer to Google's Exceptions to verification requirements documentation.

  3. Click Create.

  4. Fill in the required fields with your information.

  5. In the Authorized domains section, add:

    celonis.cloud

  6. Click Save and continue.

  7. In the Scopes page, click Add or remove scopes, add the following scopes, and click Update.

    • https://www.googleapis.com/auth/userinfo.email

    • https://www.googleapis.com/auth/presentations

    • https://www.googleapis.com/auth/drive

  8. Click Save and continue.

  9. Optional: If your project will remain in the Testing publishing status, add test user emails on the Test users page, then click Save and continue.

Create your Google Slides client credentials

To create your client credentials:

  1. In the left sidebar, click Credentials.

  2. Click + Create Credentials > OAuth client ID.

  3. In the Application type dropdown, select Web application.

  4. Update the Name of your OAuth client. This will help you identify it in the console.

  5. In the Authorized redirect URIs section, click + Add URI and enter the following redict URI:

    https://auth.redirect.celonis.cloud/oauth/cb/google

  6. Copy your Client ID and Client secret values and store them in a safe place.

You will use these values in the Client ID and Client Secret fields in Celonis platform.

Build Google Slides Action Flows

After connecting the app, you can perform the following actions:

Presentation

Triggers when a new presentation is created or updated.

Connection

Establish a connection to your Google Slides account.

Watch Presentations

Select whether you want to watch created or modified documents.

Limit

The maximum number of presentations Celonis platform should return during one Action Flow execution cycle.

Retrieves a list of all presentations.

Connection

Establish a connection to your Google Slides account.

Choose a Drive Location

Select the drive that contains the presentation you want to list.

The Google Shared Drive option is available only for Google Workspace users:

Use Domain Admin Access

Request the list of drives that require admin access.

Shared Drive

Select the drive.

Folder ID

Select the folder that contains the presentations you want to list.

Limit

The maximum number of presentations Celonis platform should return during one Action Flow execution cycle.

Gets the latest version of a specified presentation.

Connection

Establish a connection to your Google Slides account.

Choose a Drive

Select the drive that contains a presentation you want to retrieve.

The Google Shared Drive option is available only for Google Workspace users:

Use Domain Admin Access

Request the list of drives that require admin access.

Shared Drive

Select the drive.

Presentation ID

Select the Presentation ID whose details you want to retrieve.

Gets the latest version of the specified page or the thumbnail of a page in the presentation.

Connection

Establish a connection to your Google Slides account.

Enter a Presentation and Page ID

Select whether you want to manually enter the Presentation ID and Page Object ID or to select them from the dropdown list.

Choose a Drive

Select the drive that contains a presentation whose page or thumbnail you want to retrieve.

The Google Shared Drive option is available only for Google Workspace users:

Use Domain Admin Access

Request the list of drives that require admin access.

Shared Drive

Select the drive.

Presentation ID

Select or map the presentation whose page you want to retrieve.

Page Object ID

Select or map the page you want to retrieve or whose thumbnail you want to retrieve.

Show Page Thumbnail

Select if you want to get the thumbnail URL in the output.

Creates a new presentation by replacing all tags, for example, {{name}} in a template with provided data.

Connection

Establish a connection to your Google Slides account.

Title

Enter a name for the presentation.

Copy a Presentation

Select to map the ID of the presentation for copying or select the presentation from the dropdown menu.

Copy of Existing Presentation ID

Enter or map the path to the presentation or the ID of the presentation for copying.

Values

Tag

Enter the tag associated with the presentation template. Do not use {{}}.

Replaced Value

Enter the value of the tag.

Choose a Drive

Select the drive that contains a presentation whose template you want to copy.

The Google Shared Drive option is available only for Google Workspace users:

Use Domain Admin Access

Request the list of drives that require admin access.

Shared Drive

Select the drive.

Presentation ID

Select or map the Presentation ID whose template you want to copy.

New Drive Location

Select the drive where you want to store a new presentation.

New Document's Location

Select the folder where you want to store a new presentation.

Shared

Select if you want to share a new presentation.

Sharing with Other's Email Address

Enter email addresses of people who you want to share a new presentation with. If you leave the field empty, the presentation is sharable to everyone.

Uploads an image with URL to a presentation.

Note: The maximum image size is 50 MB. The image resolution must not exceed 25 megapixels. Only PNG, JPEG, or GIF formats are supported.

Connection

Establish a connection to your Google Slides account.

Choose a Presentation

Select to map the ID of the presentation for editing or select the presentation from the dropdown menu.

Choose a Drive

Select the drive that contains a presentation where you want to insert an image.

The Google Shared Drive option is available only for Google Workspace users:

Use Domain Admin Access

Request the list of drives that require admin access.

Shared Drive

Select the drive.

Presentation ID

Select or map the Presentation ID where you want to insert an image.

Select the Method

Select the method you want to use to insert an image.

Values

Select Upload an Image by Replacing Text Tag to replace the text with an image.

Tag

Enter the tag associated with the presentation. Do not use {{}}.

Image URL

Enter the URL of the image you want to insert.

Select Upload an Image by Replacing Image to replace an existing image.

Image Object ID

Enter the ID of the image you want to replace.

Image Replace Method

Select the replacement method.

Image URL

Enter the URL of the image you want to insert.

Refreshes the chart data stored in a presentation specified by ID.

Connection

Establish a connection to your Google Slides account.

Enter a Presentation ID

Select to map the ID of the presentation for refreshing or select the presentation from the dropdown menu.

Choose a Drive

Select the drive that contains a presentation where you want to refresh a chart.

The Google Shared Drive option is available only for Google Workspace users:

Use Domain Admin Access

Request the list of drives that require admin access.

Shared Drive

Select the drive.

Presentation ID

Select or map the Presentation ID where you want to refresh a chart.

Chart Object ID

Enter the ID of the chart you want to refresh.

Slide

Creates an empty slide or delete an existing slide in the specified presentation.

Connection

Establish a connection to your Google account.

Select the method

Select the action you want to apply to the presentation.

Presentation ID

Select or map the presentation where you want to add or delete a slide, or enter the Presentation ID manually.

Enter a slide

Select whether you want to manually enter the Slide ID or to select the slide from the dropdown list.

To manually enter the Slide ID, use the field:

Slide Object ID

Enter the ID of the slide you want to delete.

Predefined layout type

Select the layout that you want to apply for a slide in the presentation.

Content

Enter the content of the slide in relevant fields.

Creates a new slide by representing all tags, for example, {{name}} from a template slide within a specified presentation.

Connection

Establish a connection to your Google account.

Create a Slide from a Template Slide

Select whether you want to manually enter the Slide ID or to select the slide from the dropdown list.

Choose a Drive

Select the drive that contains the presentation with a slide you want to use as a template.

The Google Shared Drive option is available only for Google Workspace users:

Use Domain Admin Access

Request the list of drives that require admin access.

Shared Drive

Select the drive.

Presentation ID

Select or map the presentation where you want to create a slide from a template slide.

Template Slide ID (Page Object ID)

Enter the ID of the slide you want to use as a template.

The Slide ID can be found at the end of the URL of the slide you want to use. For example, #slide=id.g2f01d547879_0_15.

You need to Skip slide in Google Slides to see the slide in the dropdown list.

Values

Tag

Enter the tag associated with the presentation template. Do not use {{}}.

Replaced Value

Enter the value of the tag.

Slide Index Page Number

Enter the page index that you want to append a new slide to.

Other

Performs an arbitrary authorized API call.

Connection

Establish a connection to your Google account.

URL

Enter a path relative to https://developers.google.com/slides/.

For the list of available endpoints, refer to the Google Slides API Documentation.

Method

Select the HTTP method you want to use:

  • GET: To retrieve information for an entry.

  • POST: To create a new entry.

  • PUT: To update/replace an existing entry.

  • PATCH: To make a partial entry update.

  • DELETE: To delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Makes all links in a presentation clickable or inserts a link into all matched input texts.

Connection

Establish a connection to your Google account.

Choose a Presentation

Select to map the ID of the presentation that contains links or select the presentation from the dropdown menu.

Choose a Drive

Select the drive that contains the documents with links.

The Google Shared Drive option is available only for Google Workspace users:

Use Domain Admin Access

Request the list of drives that require admin access.

Shared Drive

Select the drive.

Presentation ID

Select or map the presentation where you want to insert a link or make all links clickable.

Select

Select the action to apply to links in the presentation.

Text Inputs

Insert a link to a specific piece of text.

Text

Enter the text where you want to put a link.

Link

Insert a link.