Send Personalization Request with Hippo Video API on New Videos in Playlist from YouTube Data API

Pipedream makes it easy to connect APIs for Hippo Video, YouTube Data and 2,700+ other apps remarkably fast.

Trigger workflow on

New Videos in Playlist from the YouTube Data API

Next, do this

Send Personalization Request with the Hippo Video API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a YouTube Data trigger and Hippo Video action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Videos in Playlist trigger
1. Connect your YouTube Data account
2. Optional- Configure Maximum Results
3. Configure Polling interval
4. Configure Playlist ID
Configure the Send Personalization Request action
1. Connect your Hippo Video account
2. Select a Video ID
3. Configure File Path or URL
4. Optional- Configure syncDir
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger#

New Videos in Playlist on YouTube Data

Description:Emit new event for each new Youtube video added to a Playlist.

Version:0.0.11

Key:youtube_data_api-new-videos-in-playlist

View on GitHub

YouTube Data Overview#

The YouTube Data API lets you incorporate functions normally executed on the YouTube website into your own website or application. You can perform operations like searching for videos, retrieving channel data, and managing playlists. When integrated with Pipedream's serverless platform, this API can be part of automations that react to events, synchronize YouTube data with other services, or generate custom reports.

Trigger Code#

import youtubeDataApi from "../../youtube_data_api.app.mjs";
import common from "./common.mjs";

export default {
  ...common,
  type: "source",
  key: "youtube_data_api-new-videos-in-playlist",
  name: "New Videos in Playlist",
  description: "Emit new event for each new Youtube video added to a Playlist.",
  version: "0.0.11",
  dedupe: "unique",
  props: {
    youtubeDataApi,
    maxResults: {
      propDefinition: [
        youtubeDataApi,
        "maxResults",
      ],
    },
    ...common.props,
  },
};

Trigger Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
YouTube Data	`youtubeDataApi`	`app`	This component uses the YouTube Data app.
Maximum Results	`maxResults`	`integer`	The maximum number of items that should be returned in the result set. Acceptable values are 0 to 50, inclusive. Default is 20
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
Polling interval	`timer`	`$.interface.timer`	Pipedream will poll the YouTube API on this schedule
Playlist ID	`playlistId`	`string`	The ID of the playlist to search for new videos in. E.g. `PLJswo-CV0rmm19_Xi5_NlGJzRbnyp43c_`. When viewing the playlist in a browser, the playlistId is the part of the URL that comes after "list="

Trigger Authentication#

YouTube Data uses OAuth authentication. When you connect your YouTube Data account, Pipedream will open a popup window where you can sign into YouTube Data and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any YouTube Data API.

Pipedream requests the following authorization scopes when you connect your account:

emailprofilehttps://www.googleapis.com/auth/youtube.readonlyhttps://www.googleapis.com/auth/youtube.uploadhttps://www.googleapis.com/auth/youtubehttps://www.googleapis.com/auth/youtube.force-ssl

About YouTube Data#

With the YouTube Data API, you can add a variety of YouTube features to your application. Use the API to upload videos, manage playlists and subscriptions, update channel settings, and more.

Action#

Send Personalization Request on Hippo Video

Description:Sends a personalization request for a specified video. [See the documentation](https://help.hippovideo.io/support/solutions/articles/19000099793-bulk-video-personalization-and-tracking-api)

Version:1.0.1

Key:hippo_video-send-personalization-request

View on GitHub

Hippo Video Overview#

The Hippo Video API lets you harness the power of video in your business processes. Through Pipedream, you can automate video creation, management, and distribution workflows. This means you can trigger actions in Hippo Video based on events from other apps, or use Hippo Video events to kick off processes elsewhere. Whether it's automating video emails in your CRM, monitoring video analytics, or managing video content at scale, Pipedream's serverless platform empowers you to build and run workflows seamlessly.

Action Code#

import {
  ConfigurationError, getFileStreamAndMetadata,
} from "@pipedream/platform";
import FormData from "form-data";
import hippoVideo from "../../hippo_video.app.mjs";

export default {
  key: "hippo_video-send-personalization-request",
  name: "Send Personalization Request",
  description: "Sends a personalization request for a specified video. [See the documentation](https://help.hippovideo.io/support/solutions/articles/19000099793-bulk-video-personalization-and-tracking-api)",
  version: "1.0.1",
  type: "action",
  props: {
    hippoVideo,
    videoId: {
      propDefinition: [
        hippoVideo,
        "videoId",
      ],
    },
    file: {
      type: "string",
      label: "File Path or URL",
      description: "Provide a file URL or a path to a file (csv, xls, or xlsx) in the `/tmp` directory.",
    },
    syncDir: {
      type: "dir",
      accessMode: "read",
      sync: true,
      optional: true,
    },
  },
  async run({ $ }) {
    const formData = new FormData();
    const {
      stream, metadata,
    } = await getFileStreamAndMetadata(this.file);

    formData.append("file", stream, {
      filename: metadata.name,
    });
    formData.append("video_id", this.videoId);

    const response = await this.hippoVideo.personalizeVideo({
      $,
      data: formData,
      headers: formData.getHeaders(),
      maxBodyLength: Infinity,
    });

    if (response.code != 200) throw new ConfigurationError(response.message || response.type);

    $.export("$summary", `Successfully sent personalization request for video Id: ${this.videoId}`);
    return response;
  },
};

Action Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

Label	Prop	Type	Description
Hippo Video	`hippoVideo`	`app`	This component uses the Hippo Video app.
Video ID	`videoId`	`string`	Select a value from the drop down menu.
File Path or URL	`file`	`string`	Provide a file URL or a path to a file (csv, xls, or xlsx) in the `/tmp` directory.
syncDir	`syncDir`	`dir`

Action Authentication#

Hippo Video uses OAuth authentication. When you connect your Hippo Video account, Pipedream will open a popup window where you can sign into Hippo Video and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Hippo Video API.

Pipedream requests the following authorization scopes when you connect your account: