Skip to main content

Google Slides

Supported Functions:​

extract

Getting Started​

The Google Slides integration provides support for Google slides presentations, allowing users to extract data from Google sides presentations.

Upload: No​

Files Supported​

The Istari platform can extract from URLs of Google slides presentations.

Example Files​

Version Compatibility​

This software was tested with google.apis.slides.v1. For more information, check the Google Slides API Documentation.

Function Coverage and Outputs​

The Google slides module can produce a number of artifacts extracted from Google slides presentation. The table below describes each output artifact and its type.

RouteCoverageArtifact Content Example
Extract slides rendered as images - PNGYes
Extract slides texts - JSONYes
Extract slides images - PNGYes
Extract slides rendered charts - PNGYes

Detailed SDK Reference​

Prerequisite: Install Istari SDK and initialize Istari Client per instructions here​

Step 1: Add and Extract the Presentation(s)​

Add the presentation as a model​

model = client.add_model(
    path="presentation_id",
    description="Google slides example presentation",
    display_name="Baby album presentation",
)
print(f"Added base model with ID {model.id}")

Extract once you have the model ID​

extraction_job = client.add_job(
    model_id  = model.id,
    function  = "@istari:extract",
    tool_name = "google_slides",
    tool_version = "1.0.0",
    operating_system = "Windows 10",
)
print(f"Extraction started for model ID {model.id}, job ID: {extraction_job.id}")

Please choose appropriate tool_name, tool_version, and operating_system for your installation of this software.
Above is an example of how to call the function

Step 2: Check the Job Status​

extraction_job.poll_job()

Step 3: Retrieve Results​

Example​

for artifact in model.artifacts:
    output_file_path = f"c:\\extracts\\{artifact.name}"

    if artifact.extension in ["txt", "csv", "md", "json", "html"]:
        with open(output_file_path, "w") as f:
            f.write(artifact.read_text())
    else:
        with open(output_file_path, "wb") as f:
            f.write(artifact.read_bytes())

Setup for Administrators​

Make sure a Google service account is created, and its credentials file path is specified in module_config.json. The service account must have access to the Google Slides presentation.

Place module_config.json in the same directory as the module executable.

Below is an example of a module_config.json configuration file for the Google Slides module:

{
  "LogLevel": "INFO",
  "LogFilePath": "gslides_module.log",
  "CredentialsFilePath": "config/credentials.json",
  "ApplicationName": "Google Slides Module",
  "TokensDirectoryPath": "tokens"
}

Troubleshooting​

  1. For general Agent and Software Troubleshooting Click Here
  2. Missing Artifacts:
    • Check if service account credentials are properly referenced and the presentation is accessible by the service account.

FAQ​