Update Task with TeamGantt API on Assignment Done from Google Classroom API

Pipedream makes it easy to connect APIs for TeamGantt, Google Classroom and 2,900+ other apps remarkably fast.

Trigger workflow on

Assignment Done from the Google Classroom API

Next, do this

Update Task with the TeamGantt 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 TeamGantt action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the Assignment Done trigger
1. Connect your Google Classroom account
2. Configure timer
3. Optional- Select one or more Course States
4. Select a Course
Configure the Update Task action
1. Connect your TeamGantt account
2. Select a Task Id
3. Optional- Configure Name
4. Optional- Configure Percent Complete
5. Optional- Configure Estimated Hours
6. Optional- Configure Start Date
7. Optional- Configure End Date
8. Optional- Configure Days
9. Optional- Select a Color
10. Optional- Configure Sort
11. Optional- Select a Type
12. Optional- Configure Is Starred
13. Optional- Select a Parent Group Id
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#

Assignment Done on Google Classroom

Description:Emit new event when an assignment in a course is marked as done.

Version:0.0.3

Key:google_classroom-assignment-done

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-assignment-done",
  name: "Assignment Done",
  description: "Emit new event when an assignment in a course is marked as done.",
  version: "0.0.3",
  type: "source",
  dedupe: "unique",
  methods: {
    ...common.methods,
    async getHistoricalEvents({ pageSize }) {
      const submissions = await this.getResults();
      return submissions?.slice(0, pageSize);
    },
    async getResults(after = null) {
      const submissions = [];
      const courseWork = await this.paginate(this.googleClassroom.listCoursework, {
        courseId: this.course,
        courseWorkStates: this.courseStates,
      }, "courseWork");
      const params = this.getParams();
      for (const assignment of courseWork) {
        params.courseWorkId = assignment.id;
        const studentSubmissions = await this.paginate(this.googleClassroom.listSubmissions, params, "studentSubmissions", after);
        submissions.push(...studentSubmissions);
      }
      return submissions;
    },
    getParams() {
      return {
        courseId: this.course,
        states: [
          "TURNED_IN",
        ],
      };
    },
    isRelevant(submission, after = null) {
      if (after && Date.parse(submission.updateTime) <= after) {
        return false;
      }
      return true;
    },
    generateMeta(submission) {
      return {
        id: submission.id,
        summary: `New assignment submission with ID ${submission.id}`,
        ts: Date.parse(submission.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#

Update Task on TeamGantt

Description:Updates a specific task. [See the documentation](https://api.teamgantt.com)

Version:0.0.2

Key:teamgantt-update-task

View on GitHub

TeamGantt Overview#

The TeamGantt API allows you to interact programmatically with your TeamGantt project management data. With it, you can create, read, update, and delete various project elements, such as tasks, milestones, and time entries. Integrating the TeamGantt API with Pipedream enables you to automate your project workflows, sync data across platforms, and react to events in real-time. By leveraging Pipedream's capabilities, you can connect TeamGantt to a myriad of other apps and services to streamline your project management processes.

Action Code#

import teamgantt from "../../teamgantt.app.mjs";

export default {
  key: "teamgantt-update-task",
  name: "Update Task",
  version: "0.0.2",
  annotations: {
    destructiveHint: true,
    openWorldHint: true,
    readOnlyHint: false,
  },
  description: "Updates a specific task. [See the documentation](https://api.teamgantt.com)",
  type: "action",
  props: {
    teamgantt,
    taskId: {
      propDefinition: [
        teamgantt,
        "taskId",
      ],
    },
    name: {
      propDefinition: [
        teamgantt,
        "name",
      ],
      optional: true,
    },
    percentComplete: {
      propDefinition: [
        teamgantt,
        "percentComplete",
      ],
      optional: true,
    },
    estimatedHours: {
      propDefinition: [
        teamgantt,
        "estimatedHours",
      ],
      optional: true,
    },
    startDate: {
      propDefinition: [
        teamgantt,
        "startDate",
      ],
      optional: true,
    },
    endDate: {
      propDefinition: [
        teamgantt,
        "endDate",
      ],
      optional: true,
    },
    days: {
      type: "integer",
      label: "Days",
      description: "The duration of the task (only positive integers). Ignored if start_date and end_date are empty.",
      optional: true,
    },
    color: {
      propDefinition: [
        teamgantt,
        "color",
      ],
      optional: true,
    },
    sort: {
      propDefinition: [
        teamgantt,
        "sort",
      ],
      optional: true,
    },
    type: {
      propDefinition: [
        teamgantt,
        "type",
      ],
      optional: true,
    },
    isStarred: {
      propDefinition: [
        teamgantt,
        "isStarred",
      ],
      optional: true,
    },
    parentGroupId: {
      propDefinition: [
        teamgantt,
        "parentGroupId",
        ({ taskId }) => ({
          taskId,
        }),
      ],
      optional: true,
    },
  },
  async run({ $ }) {
    const {
      teamgantt,
      taskId,
      percentComplete,
      estimatedHours,
      startDate,
      endDate,
      isStarred,
      parentGroupId,
      ...data
    } = this;

    const response = await teamgantt.updateTask({
      $,
      taskId,
      data: {
        percent_complete: percentComplete,
        estimated_hours: estimatedHours,
        start_date: startDate,
        end_date: endDate,
        is_starred: isStarred,
        parent_group_id: parentGroupId,
        ...data,
      },
    });

    $.export("$summary", `The task with Id: ${response.id} was successfully updated!`);
    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
TeamGantt	`teamgantt`	`app`	This component uses the TeamGantt app.
Task Id	`taskId`	`string`	Select a value from the drop down menu.
Name	`name`	`string`	The task name.
Percent Complete	`percentComplete`	`integer`	Update the progress of the task. (100 = completed).
Estimated Hours	`estimatedHours`	`integer`	The number of hours this task should take to complete.
Start Date	`startDate`	`string`	YYYY-MM-DD format.
End Date	`endDate`	`string`	YYYY-MM-DD format.
Days	`days`	`integer`	The duration of the task (only positive integers). Ignored if start_date and end_date are empty.
Color	`color`	`string`	Select a value from the drop down menu:`blue1blue2blue3brown1green1green2green3grey1magenta1orange1orange2pink1purple1purple2red1yellow1`
Sort	`sort`	`string`	The order of the task - defaults to end of the parent group.
Type	`type`	`string`	Select a value from the drop down menu:`taskmilestone`
Is Starred	`isStarred`	`boolean`	Whether the task is flagged as starred or not.
Parent Group Id	`parentGroupId`	`string`	Select a value from the drop down menu.

Action Authentication#

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

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