Upload Thumbnail with YouTube Data API on New Due Date from Google Classroom API

Pipedream makes it easy to connect APIs for YouTube Data, Google Classroom and 2,500+ other apps remarkably fast.

Trigger workflow on

New Due Date from the Google Classroom API

Next, do this

Upload Thumbnail with the YouTube Data 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 Google Classroom trigger and YouTube Data action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Due Date trigger
1. Connect your Google Classroom account
2. Configure timer
3. Optional- Select one or more Course States
4. Select a Course
Configure the Upload Thumbnail action
1. Connect your YouTube Data account
2. Configure infoAlert
3. Select a Video ID
4. Optional- Configure File URL
5. Optional- Configure File Path
6. Optional- Configure On Behalf Of Content Owner
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 Due Date on Google Classroom

Description:Emit new event when an assignment's due date is created or updated'.

Version:0.0.3

Key:google_classroom-new-due-date

View on GitHub

Google Classroom Overview#

The Google Classroom API lets you tap into the educational space by managing courses, assignments, and student interactions programmatically. With this API, you can automate course creation, roster management, and content distribution, effectively bridging the gap between various educational tools and platforms. Leveraging Pipedream's serverless execution environment, you can build powerful workflows that respond to events in Classroom, sync data across platforms, and streamline the educational process for teachers and students alike.

Trigger Code#

import common from "../common/common.mjs";

export default {
  ...common,
  key: "google_classroom-new-due-date",
  name: "New Due Date",
  description: "Emit new event when an assignment's due date is created or updated'.",
  version: "0.0.3",
  type: "source",
  dedupe: "unique",
  methods: {
    ...common.methods,
    async getHistoricalEvents({ pageSize }) {
      const { courseWork } = await this.googleClassroom.listCoursework({
        ...this.getParams(),
        pageSize,
      });
      return courseWork;
    },
    async getResults(after) {
      return this.paginate(this.googleClassroom.listCoursework, this.getParams(), "courseWork", after);
    },
    getParams() {
      return {
        courseId: this.course,
        courseWorkStates: this.courseStates,
      };
    },
    isRelevant(assignment, after = null) {
      return assignment.dueDate && this.isAfter(assignment.updateTime, after);
    },
    createDueDate(assignment) {
      const {
        dueDate, dueTime = {},
      } = assignment;
      if (!dueDate) {
        return;
      }
      const {
        year, month, day,
      } = dueDate;
      const {
        hours = 0, minutes = 0,
      } = dueTime;
      return new Date(year, month - 1, day - 1, hours, minutes, 0, 0);
    },
    generateMeta(assignment) {
      const dueDate = this.createDueDate(assignment);
      return {
        id: `${assignment.id}${Date.parse(dueDate)}`,
        summary: `New due date ${dueDate.toISOString()} for assignment ${assignment.title}`,
        ts: Date.parse(assignment.updateTime),
      };
    },
  },
};

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
Google Classroom	`googleClassroom`	`app`	This component uses the Google Classroom app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`
Course States	`courseStates`	`string[]`	Select a value from the drop down menu:`COURSE_STATE_UNSPECIFIEDACTIVEARCHIVEDPROVISIONEDDECLINEDSUSPENDED`
Course	`course`	`string`	Select a value from the drop down menu.

Trigger Authentication#

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

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

https://www.googleapis.com/auth/userinfo.emailhttps://www.googleapis.com/auth/userinfo.profilehttps://www.googleapis.com/auth/classroom.courses.readonlyhttps://www.googleapis.com/auth/classroom.coursework.studentshttps://www.googleapis.com/auth/classroom.coursework.mehttps://www.googleapis.com/auth/classroom.announcements.readonly

About Google Classroom#

Google Classroom helps educators create engaging learning experiences they can personalize, manage, and measure.

Action#

Upload Thumbnail on YouTube Data

Description:Uploads a custom video thumbnail to YouTube and sets it for a video. Note: Account must be [verified](https://www.youtube.com/verify). [See the documentation](https://developers.google.com/youtube/v3/docs/thumbnails/set) for more information

Version:0.0.3

Key:youtube_data_api-upload-thumbnail

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.

Action Code#

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

export default {
  ...common,
  key: "youtube_data_api-upload-thumbnail",
  name: "Upload Thumbnail",
  description: "Uploads a custom video thumbnail to YouTube and sets it for a video. Note: Account must be [verified](https://www.youtube.com/verify). [See the documentation](https://developers.google.com/youtube/v3/docs/thumbnails/set) for more information",
  version: "0.0.3",
  type: "action",
  props: {
    youtubeDataApi,
    infoAlert: {
      type: "alert",
      alertType: "info",
      content: "- Maximum file size: 2MB \n- Accepted Media MIME types: image/jpeg, image/png, application/octet-stream",
    },
    videoId: {
      propDefinition: [
        youtubeDataApi,
        "userOwnedVideo",
      ],
    },
    fileUrl: {
      propDefinition: [
        youtubeDataApi,
        "fileUrl",
      ],
      description: "The URL of the thumbnail image file you want to upload to YouTube. Must specify either **File URL** or **File Path**.",
    },
    filePath: {
      propDefinition: [
        youtubeDataApi,
        "filePath",
      ],
      description: "Path to the thumbnail image file to upload (e.g., `/tmp/myVideo.mp4`). Must specify either **File URL** or **File Path**.",
    },
    onBehalfOfContentOwner: {
      propDefinition: [
        youtubeDataApi,
        "onBehalfOfContentOwner",
      ],
    },
    ...common.props,
  },
};

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
YouTube Data	`youtubeDataApi`	`app`	This component uses the YouTube Data app.
Video ID	`videoId`	`string`	Select a value from the drop down menu.
File URL	`fileUrl`	`string`	The URL of the thumbnail image file you want to upload to YouTube. Must specify either File URL or File Path.
File Path	`filePath`	`string`	Path to the thumbnail image file to upload (e.g., `/tmp/myVideo.mp4`). Must specify either File URL or File Path.
On Behalf Of Content Owner	`onBehalfOfContentOwner`	`string`	This parameter can only be used in a properly authorized request. Note: This parameter is intended exclusively for YouTube content partners. The `onBehalfOfContentOwner` parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.

Action 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

Upload Thumbnail with YouTube Data API on New Due Date from Google Classroom API

Pipedream makes it easy to connect APIs for YouTube Data, Google Classroom and 2,500+ other apps remarkably fast.

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

Developers ♥ Pipedream

1-24of2,500+apps by most popular

1
-
24
of
2,500+
apps by most popular