@pipedream/google_slides 0.0.4 → 0.1.1

package/README.md

@@ -1,13 +1,11 @@
 # Overview
 
-Using the Google Slides API, you can build applications that do the following:
-
-- Create new presentations or edit existing ones
-- Add or remove slides
-- Add or remove slide content
-- Change slide layouts
-- Format text
-- Insert or delete images
-- Crop images
-- Add or remove comments
-- And more!
+The Google Slides API allows you to create, read, and edit Google Slides presentations programmatically. With Pipedream's integration, you can automate your slide workflows, enabling dynamic content updates, collaboration enhancements, and streamlined reporting. By plugging into Pipedream's serverless platform, you can trigger slide creation or updates based on events from other apps, process data for presentations, and handle sharing and publishing tasks—all with minimal fuss.
+
+# Example Use Cases
+
+- **Automated Data Visualization Updates**: Create a workflow that pulls the latest sales data from a Google Sheets document. With the Google Slides API, you can update charts and tables in your company's weekly report presentation with fresh data, without manual intervention.
+
+- **Event-triggered Slideshow Creation**: Set up a trigger that listens for new product launches from your e-commerce platform. Once a launch is detected, use the Google Slides API to generate a product overview presentation, populating it with images, descriptions, and specifications pulled from your CMS.
+
+- **Collaboration and Sharing Workflow**: Implement a process where a new slide deck is crafted for each project kick-off. After the slides are created using the Google Slides API, integrate with Gmail or Slack to automatically notify team members, share the presentation, and collect feedback.

package/actions/merge-data/merge-data.mjs

@@ -0,0 +1,110 @@
+import app from "../../google_slides.app.mjs";
+
+export default {
+  key: "google_slides-merge-data",
+  name: "Merge Data",
+  description: "Merge data into a presentation. [See the docs here](https://developers.google.com/slides/api/guides/merge)",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    app,
+    drive: {
+      propDefinition: [
+        app,
+        "watchedDrive",
+      ],
+      description: "The drive to select a presentation from. If you are connected with any [Google Shared Drives](https://support.google.com/a/users/answer/9310351), you can select it here.",
+    },
+    presentationId: {
+      propDefinition: [
+        app,
+        "presentationId",
+        (c) => ({
+          driveId: app.methods.getDriveId(c.drive),
+        }),
+      ],
+      description: "Select the presentation to make a copy of.",
+    },
+    title: {
+      type: "string",
+      label: "Title",
+      description: "The title of the new presentation.",
+    },
+    placeholdersAndTexts: {
+      type: "object",
+      label: "Placeholders And Texts",
+      description: "The placeholders and texts to be merged into the presentation. So the key should be the placeholder ID and the value should be the text to be merged. As a placeholder example you can use `{{name}}` and the value can be `John Doe`.",
+    },
+    placeholdersAndImageUrls: {
+      type: "object",
+      label: "Placeholders And Image URLs",
+      description: "The placeholders and image URLs to be merged into the presentation. So the key should be the placeholder ID and the value should be the image URL to be merged. As a placeholder example you can use `{{image}}` and the value can be `https://example.com/image.jpg`.",
+      optional: true,
+    },
+  },
+  methods: {
+    getTextRequests(placeholdersAndTexts = {}) {
+      return Object.entries(placeholdersAndTexts)
+        .map(([
+          key,
+          value,
+        ]) => ({
+          replaceAllText: {
+            containsText: {
+              text: key,
+              matchCase: true,
+            },
+            replaceText: value,
+          },
+        }));
+    },
+    getImageRequests(placeholdersAndImageUrls = {}) {
+      return Object.entries(placeholdersAndImageUrls)
+        .map(([
+          key,
+          value,
+        ]) => ({
+          replaceAllShapesWithImage: {
+            imageUrl: value,
+            replaceMethod: "CENTER_INSIDE",
+            containsText: {
+              text: key,
+              matchCase: true,
+            },
+          },
+        }));
+    },
+    batchUpdate(args = {}) {
+      const slides = this.app.slides();
+      return slides.presentations.batchUpdate(args);
+    },
+  },
+  async run({ $ }) {
+    const {
+      app,
+      batchUpdate,
+      presentationId,
+      title,
+      placeholdersAndTexts,
+      placeholdersAndImageUrls,
+      getTextRequests,
+      getImageRequests,
+    } = this;
+
+    const presentation = await app.copyPresentation(presentationId, title);
+
+    const { data: response } = await batchUpdate({
+      presentationId: presentation.id,
+      resource: {
+        requests: [
+          ...getTextRequests(placeholdersAndTexts),
+          ...getImageRequests(placeholdersAndImageUrls),
+        ],
+      },
+    });
+
+    $.export("$summary", `Successfully merged data into presentation with ID: ${response.presentationId}`);
+
+    return response;
+  },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/google_slides",
-  "version": "0.0.4",
+  "version": "0.1.1",
   "description": "Pipedream Google Slides Components",
   "main": "google_slides.app.mjs",
   "keywords": [

package/sources/new-presentation/new-presentation.mjs

@@ -6,12 +6,12 @@ export default {
   type: "source",
   name: "New Presentation (Instant)",
   description: "Emit new event each time a new presentation is created in a drive.",
-  version: "0.0.2",
+  version: "0.0.3",
   hooks: {
     ...newFilesInstant.hooks,
     async deploy() {
       // Emit sample records on the first run
-      const slides = await this.getPresentations(10);
+      const slides = await this.getPresentations(5);
       for (const fileInfo of slides) {
         const createdTime = Date.parse(fileInfo.createdTime);
         this.$emit(fileInfo, {
@@ -22,6 +22,14 @@ export default {
       }
     },
   },
+  props: {
+    ...newFilesInstant.props,
+    folders: {
+      ...newFilesInstant.props.folders,
+      description:
+        "(Optional) The folders you want to watch. Leave blank to watch for any new presentation in the Drive.",
+    },
+  },
   methods: {
     ...newFilesInstant.methods,
     shouldProcess(file) {