Teamwork Projects (プレビュー)

  • リファレンス

チームのすべてのタスクを 1 か所に保管します。 リアルタイムでコラボレーションし、実際の成果につなげることができます。 Teamwork Projects は、チームとコラボレーションするための強力でシンプルな方法です。

このコネクタは、次の製品および地域で利用可能です。

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
コネクタのメタデータ
公開元 Microsoft
Web サイト https://www.teamwork.com/
プライバシー ポリシー https://www.teamwork.com/legal/privacy-policy/

この統合でトリガーを使用するには、まず Teamwork Projects アカウントで Webhook を有効にしておく必要があります。 Webhook を有効にするには、Teamwork Projects アカウントの右上にある設定をクリックしてから、サイトの設定をクリックして、Webhook タブを選択します。アカウントで設定が有効になると、トリガーを使用することで自動的に Webhook が登録されます。

接続の作成

コネクタは、次の認証タイプをサポートしています:
既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名 タイプ 内容 必要
ユーザー名 文字列 この API のユーザー名 真
パスワード securestring この API のパスワード 真
サイト URL 文字列 ルート サイト URL (例: https://my.teamwork.com) 真

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒
トリガー ポーリングの頻度 1 1 秒

アクション

タスクの一覧表示

この操作は、特定のプロジェクトのタスクのリストを返すために使用します。
タスクの取得

この操作は、特定のタスクに関連するすべてのプロパティを、そのプロジェクトの ID を使って返します。
タスクの更新

この操作は、特定のタスクのプロパティを更新するために使用します。
タスクを作成する

この操作は、新しいタスクを作成するために使用します。
タスクを削除する

この操作は、タスクを削除するために使用します。
プロジェクトの作成

この操作は、新しい Teamwork プロジェクトを作成するために使用します。
プロジェクトの取得

この操作は、特定のプロジェクトに関連するすべてのプロパティを、そのプロジェクトの ID を使って返します。
プロジェクトを一覧表示する

この操作は、アカウントに関連付けられているすべてのプロジェクトの一覧を返します。
ユーザーの一覧

この操作は、特定のプロジェクトに関連するすべてのユーザーの一覧を返します。
ユーザーの取得

この操作は、ユーザーのすべての詳細を取得するために使用します。
ユーザーを作成

この操作は、新しいユーザーを作成するために使用します。

タスクの一覧表示

操作 ID:
ListTasks

この操作は、特定のプロジェクトのタスクのリストを返すために使用します。

パラメーター

名前 キー 必須 型 説明
プロジェクト ID
 projectId True string

プロジェクトを選択します。
タスク一覧 ID
 taskListId True string

タスク一覧を選択します。

戻り値

本文​​
ListTasks_Response

タスクの取得

操作 ID:
GetTask

この操作は、特定のタスクに関連するすべてのプロパティを、そのプロジェクトの ID を使って返します。

パラメーター

名前 キー 必須 型 説明
タスク ID
 taskId True string

タスクを表す一意の ID。

戻り値

特定のタスクに関連付けられた詳細。

本文​​
GetTask_Response

タスクの更新

操作 ID:
UpdateTask

この操作は、特定のタスクのプロパティを更新するために使用します。

パラメーター

名前 キー 必須 型 説明
タスク ID
 taskId True string

タスクを表す一意の ID。
件名
 content string

タスク名。
内容
 description string

タスクの説明。
進行状況
 progress string

0 から 90 までの整数。
割り当て先
 responsible-party-id string

ユーザーを選択します。
開始日
 start-date string

yyyy-MM-dd
期日
 due-date string

yyyy-MM-dd
推定時間
 estimated-minutes string

タスクを完了するまでの時間 (分)。
優先順位
 priority string

優先順位を選択します。
ユーザーに通知する
 notify boolean

このタスクに割り当てられているユーザーにメールで通知する場合は True。
非公開である
 private boolean

タスクをプライベートにする場合は True。
タグ
 tags string

タスクのタグのコンマ区切り一覧。

戻り値

本文​​
UpsertTask_Response

タスクを作成する

操作 ID:
CreateTask

この操作は、新しいタスクを作成するために使用します。

パラメーター

名前 キー 必須 型 説明
プロジェクト ID
 projectId True string

プロジェクトを選択します。
タスク一覧 ID
 taskListId True string

タスク一覧を選択します。
件名
 content True string

タスクのタイトル。
内容
 description string

タスクの詳細。
進行状況
 progress string

進行状況を 0 から 90 に設定します。
担当
 responsible-party-id string

ユーザーを選択します。
開始日
 start-date string

yyyy-MM-dd
期日
 due-date string

yyyy-MM-dd
推定時間 (分)
 estimated-minutes string

タスク完了までの推定時間。
優先順位
 priority string

優先順位を選択します。
ユーザーに通知する
 notify boolean

このタスクに割り当てられているユーザーにメールで通知する場合は True。
非公開である
 private boolean

タスクをプライベートにする場合は True。
タグ
 tags string

タスクのタグのコンマ区切り一覧。

戻り値

本文​​
UpsertTask_Response

タスクを削除する

操作 ID:
DeleteTask

この操作は、タスクを削除するために使用します。

パラメーター

名前 キー 必須 型 説明
タスク ID
 taskId True string

タスクを表す一意の ID。

戻り値

本文​​
DeleteTask_Response

プロジェクトの作成

操作 ID:
CreateProject

この操作は、新しい Teamwork プロジェクトを作成するために使用します。

パラメーター

名前 キー 必須 型 説明
件名
 name True string

プロジェクト名。
内容
 description string

プロジェクトの詳細。
カテゴリ ID
 category-id string

カテゴリを選択する
会社 ID
 companyId string

既存の会社を選びます。
新会社
 newCompany string

新しい外部会社の名前を入力します。
開始日
 startDate string

yyyy-MM-dd
終了日
 endDate string

yyyy-MM-dd
タグ
 tags string

プロジェクトのタグのコンマ区切り一覧。

戻り値

本文​​
CreateProject_Response

プロジェクトの取得

操作 ID:
GetProject

この操作は、特定のプロジェクトに関連するすべてのプロパティを、そのプロジェクトの ID を使って返します。

パラメーター

名前 キー 必須 型 説明
プロジェクト ID
 projectId True string

プロジェクトを表す一意の ID。

戻り値

本文​​
GetProject_Response

プロジェクトを一覧表示する

操作 ID:
ListProjects

この操作は、アカウントに関連付けられているすべてのプロジェクトの一覧を返します。

戻り値

本文​​
ListProjects_Response

ユーザーの一覧

操作 ID:
ListUsers

この操作は、特定のプロジェクトに関連するすべてのユーザーの一覧を返します。

パラメーター

名前 キー 必須 型 説明
プロジェクト ID
 projectId True string

プロジェクトを選択します。

戻り値

本文​​
ListUsers_Response

ユーザーの取得

操作 ID:
GetUser

この操作は、ユーザーのすべての詳細を取得するために使用します。

パラメーター

名前 キー 必須 型 説明
個人 ID
 personId True string

個人を表す一意の ID。

戻り値

本文​​
GetUser_Response

ユーザーを作成

操作 ID:
CreateUser

この操作は、新しいユーザーを作成するために使用します。

パラメーター

名前 キー 必須 型 説明
メール アドレス
 email-address True string

ユーザーのメール。
名
 first-name True string

ユーザーの名。
姓
 last-name True string

ユーザーの姓。
会社 ID
 company-id string

ユーザーの会社。
役職
 title string

ユーザーの役職。
Home キー
 phone-number-home string

ユーザーの自宅電話番号。
携帯電話
 phone-number-mobile string

ユーザーの携帯電話番号。
Office
 phone-number-office string

ユーザーのオフィスの電話番号。
オフィスの内線番号
 phone-number-office-ext string

ユーザーのオフィスの内線番号。
FAX
phone-number-fax string

ユーザーの FAX 番号。
ユーザー名
 user-name True string

ユーザーの表示名。

戻り値

本文​​
CreateUser_Response

トリガー

タスクが作成されたとき

この操作は、新しいタスクが作成されるとトリガーされます。
プロジェクトが作成されたとき

この操作は、新しいプロが作成されるとトリガーされます。
ユーザーが作成されたとき

この操作は、新しいユーザーが作成されるとトリガーされます。

タスクが作成されたとき

操作 ID:
WebhookCreateTask

この操作は、新しいタスクが作成されるとトリガーされます。

戻り値

本文​​
TaskResponse

プロジェクトが作成されたとき

操作 ID:
WebhookCreateProject

この操作は、新しいプロが作成されるとトリガーされます。

戻り値

本文​​
ProjectResponse

ユーザーが作成されたとき

操作 ID:
WebhookCreateUser

この操作は、新しいユーザーが作成されるとトリガーされます。

戻り値

本文​​
UserResponse

定義

ProjectResponse

名前 パス 型 説明
プロジェクト ID
 objectId string

プロジェクトを表す一意識別子。

TaskResponse

名前 パス 型 説明
タスク ID
 objectId string

タスクを表す一意の識別子です。

UserResponse

名前 パス 型 説明
ユーザー ID
 objectId string

ユーザーの一意識別子。

CreateProject_Response

名前 パス 型 説明
プロジェクト ID
 id string

プロジェクトを表す一意の ID。

ListProjects_Response

名前 パス 型 説明
プロジェクト一覧
 projects array of Project_Response

アカウントに関連付けられているすべてのプロジェクトの配列。

GetProject_Response

名前 パス 型 説明
プロジェクト
 project Project_Response

Project_Response

名前 パス 型 説明
ID
 category.id string

プロジェクト カテゴリの一意 ID。
件名
 category.name string

プロジェクト カテゴリの名前。
ID
 company.id string

会社を表す一意の ID。
件名
 company.name string

会社の名前。
作成日時
 created-on date-time

yyyy-MM-ddTHH:mm:ss.fffZ
内容
 description string

プロジェクトの詳細。
終了日時
 endDate string

yyyy-MM-dd
有効化されたタイマー
 harvest-timers-enabled boolean

Harvest タイマーが有効になっている場合は True。
プロジェクト ID
 id string

プロジェクトを表す一意の ID。
更新日時
 last-changed-on date-time

yyyy-MM-ddTHH:mm:ss.fffZ
ロゴ
 logo string

プロジェクトのロゴ。
件名
 name string

プロジェクト名。
概要ページ
 overview-start-page string

overview-start-page の URL。
有効化されたプライバシー
 privacyEnabled boolean

プライバシーが有効になっている場合は True。
スター付き
 starred boolean

プロジェクトにスターが付いている場合は True。
開始日時
 startDate string

yyyy-MM-dd
開始ページ
 start-page string

start-page の URL。
ステータス
 status string

プロジェクトの状態。
サブ状態
 subStatus string

プロジェクトのサブ状態。
タスク スタート ページ
 tasks-start-page string

tasks-start-page の URL。
タイプ
 type string

プロジェクトの種類。

UpsertTask_Response

名前 パス 型 説明
タスク ID
 id string

タスクを表す一意の ID。

ListTasks_Response

名前 パス 型 説明
todo-items
 todo-items array of Task_Response

タスクとそのプロパティの一覧。

GetTask_Response

特定のタスクに関連付けられた詳細。

名前 パス 型 説明
todo-item
 todo-item Task_Response

Task_Response

名前 パス 型 説明
完了可能
 canComplete boolean

タスクを完了できる場合は True。
編集可能
 canEdit boolean

タスクを編集できる場合は True。
時間を記録可能
 canLogTime boolean

タスクに時間を記録できる場合は True。
会社 ID
 company-id integer

会社を表す一意の ID。
会社名
 company-name string

会社の名前。
完了
 completed boolean

タスクが完了している場合は True。
件名
 content string

タスクのタイトル。
作成日時
 created-on date-time

yyyy-MM-ddTHH:mm:ss.fffZ
作成者のアバターの URL
 creator-avatar-url string

タスク作成者のアバターの URL。
作成者の名
 creator-firstname string

タスク作成者の名。
作成者 ID
 creator-id integer

作成者を表す一意の ID。
作成者の姓
 creator-lastname string

タスク作成者の姓。
内容
 description string

タスクの説明。
期日
 due-date string

yyyy-MM-dd
推定時間 (分)
 estimated-minutes integer

タスクの推定時間。
有効化された Harvest。
 harvest-enabled boolean

Harvest が有効になっている場合は True。
依存関係の数
 has-dependencies integer

タスクにある依存関係の数。
先行オペレーションあり
 has-predecessors integer

タスクにある先行オペレーションの数。
アラームあり
 has-reminders boolean

アラームが存在する場合は True。
チケットあり
 hasTickets boolean

チケットが存在する場合は True。
has-unread-comments
 has-unread-comments boolean

未読のコメントが存在する場合は True。
タスク ID
 id integer

タスクを表す一意の ID。
更新日時
 last-changed-on date-time

yyyy-MM-ddTHH:mm:ss.fffZ
ロック ダウン ID
 lockdownId string

ロック ダウンの一意の ID。
親タスク ID
 parentTaskId string

親タスクを表す一意の ID。
優先順位
 priority string

タスクの優先度です。
非公開企業
 private integer

タスクが非公開の場合は 1。
進行状況
 progress integer

0 から 90 までの整数。
プロジェクト ID
 project-id integer

プロジェクトを表す一意の ID。
プロジェクト名
 project-name string

プロジェクトの名前です。
開始日
 start-date string

yyyy-MM-dd
ステータス
 status string

削除済、完了済、再開済、または新規。
ToDo リスト ID
 todo-list-id integer

ToDo リストを表す一意の ID。
ToDo リスト名
 todo-list-name string

ToDo リストの名前。
変更をフォロー中
 userFollowingChanges boolean

ユーザーが変更をフォローしている場合は True。
コメントをフォロー中
 userFollowingComments boolean

ユーザーがコメントをフォローしている場合は True。

DeleteTask_Response

名前 パス 型 説明
タスク ID
 affectedTaskIds string

タスクを表す一意の ID。

CreateUser_Response

名前 パス 型 説明
ユーザー ID
 id string

ユーザーの一意識別子。

ListUsers_Response

名前 パス 型 説明
ユーザー
people array of User_Response

ユーザーの一覧。

GetUser_Response

名前 パス 型 説明
人
 person User_Response

User_Response

名前 パス 型 説明
アバターの URL
 avatar-url string

ユーザーのアバターの URL。
会社 ID
 company-id string

会社を表す一意の ID。
会社名
 company-name string

会社の名前。
メール アドレス
 email-address string

ユーザーのメール。
代替のメール 1
 email-alt-1 string

ユーザーの代替のメール。
名
 first-name string

ユーザーの名。
ユーザー ID
 id string

ユーザーを表す一意の ID。
姓
 last-name string

ユーザーの姓。
メモ
notes string

ユーザーについてのメモ。
オープン ID
 openId string

ユーザーのオープン ID。
FAX 番号
 phone-number-fax string

ユーザーの FAX 番号。
Home キー
 phone-number-home string

ユーザーの自宅電話番号。
携帯電話
 phone-number-mobile string

ユーザーの携帯電話番号。
国コード
 phone-number-mobile-parts.countryCode string

ユーザーの携帯電話番号。
電話
 phone-number-mobile-parts.phone string

ユーザーの携帯電話番号。
接頭辞
 phone-number-mobile-parts.prefix string

ユーザーの携帯電話番号。
Office
 phone-number-office string

ユーザーのオフィスの電話番号。
オフィスの内線番号
 phone-number-office-ext string

ユーザーのオフィスの電話番号。
PID
 pid string

ユーザーの PID。
敬称
 title string

ユーザーの役職。
Twitter
 twitter string

ユーザーの Twitter ハンドル。
ユーザー名
 user-name string

ユーザーの表示名。
タイプ
 user-type string

ユーザーの種類。
UUID
 userUUID string

ユーザーの UUID。