チームワーク プロジェクト (プレビュー)
チームのすべてのタスクを 1 か所に保持します。 リアルタイムで共同作業と作業を行い、実際の結果を得られます。 チームワーク プロジェクトは、チームと共同作業を行うための強力で簡単な方法です。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| コネクタ メタデータ | |
|---|---|
| Publisher | Microsoft |
| Website | https://www.teamwork.com/ |
| プライバシー ポリシー | https://www.teamwork.com/legal/privacy-policy/ |
この統合でトリガーを使用するには、まず、Teamwork Projects アカウントに対して Webhook を有効にする必要があります。 Webhook を有効にするには、Teamwork Projects アカウントの右上にある [設定] をクリックし、[サイトの設定] をクリックして [Webhook] タブを選択します。アカウントで設定が有効になると、トリガーを使用して Webhook が自動的に登録されます。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| ユーザー名 | 文字列 | この API のユーザー名 | 正しい |
| パスワード | securestring | この API のパスワード | 正しい |
| サイト URL | 文字列 | ルート サイトの URL (例: https://my.teamwork.com ) | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
| トリガーポーリングの頻度 | 1 | 1 秒 |
アクション
| タスクの作成 |
この操作は、新しいタスクを作成するために使用されます。 |
| タスクを一覧表示する |
この操作は、特定のプロジェクトのタスクの一覧を返すために使用されます。 |
| タスクを削除 |
この操作は、タスクを削除するために使用されます。 |
| タスクを取得する |
この操作は、ID を指定すると、特定のタスクに関連付けられたすべてのプロパティを返します。 |
| タスクを更新する |
この操作は、特定のタスクのプロパティを更新するために使用されます。 |
| プロジェクトを一覧表示する |
この操作により、アカウントに関連付けられているすべてのプロジェクトの一覧が返されます。 |
| プロジェクトを作成 |
この操作は、新しい Teamwork プロジェクトを作成するために使用されます。 |
| プロジェクトを取得する |
この操作は、ID を指定すると、特定のプロジェクトに関連付けられたすべてのプロパティを返します。 |
| ユーザーの作成 |
この操作は、新しいユーザーを作成するために使用されます。 |
| ユーザーを一覧表示する |
この操作は、特定のプロジェクトで割り当て済みのすべてのユーザーの一覧を返します。 |
| ユーザーを取得する |
この操作は、ユーザーのすべての詳細を取得するために使用されます。 |
タスクの作成
この操作は、新しいタスクを作成するために使用されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プロジェクト ID
|
projectId | True | string |
プロジェクトを選択します。 |
|
タスク リスト ID
|
taskListId | True | string |
タスク リストを選択します。 |
|
名前
|
content | True | string |
タスク タイトル。 |
|
Description
|
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
|
priority | string |
優先度を選択します。 |
|
|
ユーザーに通知する
|
notify | boolean |
True このタスクに割り当てられているユーザーに電子メールで通知します。 |
|
|
プライベートである
|
private | boolean |
True を指定すると、タスクがプライベートになります。 |
|
|
タグ
|
tags | string |
タスクのタグのコンマ区切りのリスト。 |
戻り値
- Body
- UpsertTask_Response
タスクを一覧表示する
この操作は、特定のプロジェクトのタスクの一覧を返すために使用されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プロジェクト ID
|
projectId | True | string |
プロジェクトを選択します。 |
|
タスク リスト ID
|
taskListId | True | string |
タスク リストを選択します。 |
戻り値
- Body
- ListTasks_Response
タスクを削除
この操作は、タスクを削除するために使用されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タスク ID
|
taskId | True | string |
タスクの一意の ID。 |
戻り値
- Body
- DeleteTask_Response
タスクを取得する
この操作は、ID を指定すると、特定のタスクに関連付けられたすべてのプロパティを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タスク ID
|
taskId | True | string |
タスクの一意の ID。 |
戻り値
特定のタスクに関連付けられている詳細。
- Body
- GetTask_Response
タスクを更新する
この操作は、特定のタスクのプロパティを更新するために使用されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タスク ID
|
taskId | True | string |
タスクの一意の ID。 |
|
名前
|
content | string |
タスク名。 |
|
|
Description
|
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
|
priority | string |
優先度を選択します。 |
|
|
ユーザーに通知する
|
notify | boolean |
True このタスクに割り当てられているユーザーに電子メールで通知します。 |
|
|
プライベートである
|
private | boolean |
True を指定すると、タスクがプライベートになります。 |
|
|
タグ
|
tags | string |
タスクのタグのコンマ区切りのリスト。 |
戻り値
- Body
- UpsertTask_Response
プロジェクトを一覧表示する
プロジェクトを作成
この操作は、新しい Teamwork プロジェクトを作成するために使用されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
名前
|
name | True | string |
プロジェクト名。 |
|
Description
|
description | string |
プロジェクトの詳細。 |
|
|
カテゴリ ID
|
category-id | string |
カテゴリを選択する |
|
|
会社 ID
|
companyId | string |
既存の会社を選択します。 |
|
|
新しい会社
|
newCompany | string |
新しい外部企業の名前を入力します。 |
|
|
開始日
|
startDate | string |
yyyy-MM-dd |
|
|
終了日
|
endDate | string |
yyyy-MM-dd |
|
|
タグ
|
tags | string |
プロジェクトのタグのコンマ区切りのリスト。 |
戻り値
プロジェクトを取得する
この操作は、ID を指定すると、特定のプロジェクトに関連付けられたすべてのプロパティを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プロジェクト ID
|
projectId | True | string |
プロジェクトの一意の ID。 |
戻り値
- Body
- GetProject_Response
ユーザーの作成
この操作は、新しいユーザーを作成するために使用されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
メール アドレス
|
email-address | True | string |
ユーザーの電子メール。 |
|
名前
|
first-name | True | string |
ユーザーの名。 |
|
姓
|
last-name | True | string |
ユーザーの姓。 |
|
会社 ID
|
company-id | string |
ユーザーの会社。 |
|
|
役職
|
title | string |
ユーザーのタイトル。 |
|
|
ホーム
|
phone-number-home | string |
ユーザーの自宅電話。 |
|
|
モバイル
|
phone-number-mobile | string |
ユーザーの携帯電話。 |
|
|
Office
|
phone-number-office | string |
ユーザーの会社の電話。 |
|
|
Office 拡張機能
|
phone-number-office-ext | string |
ユーザーの会社の電話番号の拡張機能。 |
|
|
ファクス
|
phone-number-fax | string |
ユーザーの FAX 番号。 |
|
|
ユーザー名
|
user-name | True | string |
ユーザーの表示名。 |
戻り値
- Body
- CreateUser_Response
ユーザーを一覧表示する
この操作は、特定のプロジェクトで割り当て済みのすべてのユーザーの一覧を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プロジェクト ID
|
projectId | True | string |
プロジェクトを選択します。 |
戻り値
- Body
- ListUsers_Response
ユーザーを取得する
この操作は、ユーザーのすべての詳細を取得するために使用されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
人物 ID
|
personId | True | string |
ユーザーの一意の ID。 |
戻り値
- Body
- GetUser_Response
トリガー
| タスクが作成されたとき |
この操作は、新しいタスクが作成されたときにトリガーされます。 |
| プロジェクトの作成時 |
この操作は、新しいプロジェクトが作成されたときにトリガーされます。 |
| ユーザーが作成されたとき |
この操作は、新しいユーザーが作成されたときにトリガーされます。 |
タスクが作成されたとき
プロジェクトの作成時
ユーザーが作成されたとき
定義
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 |
会社の名前。 |
|
作成された Date-Time
|
created-on | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Description
|
description | string |
プロジェクトの詳細。 |
|
End Date-Time
|
endDate | string |
yyyy-MM-dd |
|
タイマーが有効
|
harvest-timers-enabled | boolean |
True の 場合は、ハーベスト タイマーが有効です。 |
|
プロジェクト ID
|
id | string |
プロジェクトの一意の ID。 |
|
更新された Date-Time
|
last-changed-on | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Logo
|
logo | string |
プロジェクトのロゴ。 |
|
名前
|
name | string |
プロジェクト名。 |
|
[概要] ページ
|
overview-start-page | string |
overview-start-page の URL。 |
|
プライバシーの有効化
|
privacyEnabled | boolean |
プライバシーが有効な場合は True。 |
|
主演
|
starred | boolean |
プロジェクトが星付きである場合は True。 |
|
Date-Time を開始する
|
startDate | string |
yyyy-MM-dd |
|
開始ページ
|
start-page | string |
スタート ページの URL。 |
|
ステータス
|
status | string |
プロジェクトの状態。 |
|
副状態
|
subStatus | string |
プロジェクトの副ステータス。 |
|
[タスクの開始] ページ
|
tasks-start-page | string |
タスクの開始ページの 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 |
タスクのタイトル。 |
|
作成された Date-Time
|
created-on | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Creator Avatar URL
|
creator-avatar-url | string |
タスク作成者のアバター URL。 |
|
作成者名
|
creator-firstname | string |
タスク作成者の名。 |
|
Creator Id
|
creator-id | integer |
作成者の一意の ID。 |
|
作成者の姓
|
creator-lastname | string |
タスク作成者の姓。 |
|
Description
|
description | string |
タスクの説明。 |
|
期日
|
due-date | string |
yyyy-MM-dd |
|
推定時間 (分)
|
estimated-minutes | integer |
タスクの時間の見積もり。 |
|
Harvest Enabled。
|
harvest-enabled | boolean |
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。 |
|
更新された Date-Time
|
last-changed-on | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
ロックダウン ID
|
lockdownId | string |
ロックダウンの一意の ID。 |
|
親タスク ID
|
parentTaskId | string |
親タスクの一意の ID。 |
|
Priority
|
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 |
ユーザーに関するメモ。 |
|
Open Id
|
openId | string |
ユーザーの開いている ID。 |
|
FAX 番号
|
phone-number-fax | string |
ユーザーの FAX 番号。 |
|
ホーム
|
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 |
ユーザーのオフィスの電話番号。 |
|
Office 拡張機能
|
phone-number-office-ext | string |
ユーザーのオフィスの電話番号。 |
|
Pid
|
pid | string |
ユーザーの pid。 |
|
Title
|
title | string |
ユーザーのタイトル。 |
|
ツイッター
|
string |
ユーザーの Twitter ハンドル。 |
|
|
ユーザー名
|
user-name | string |
ユーザーの表示名。 |
|
タイプ
|
user-type | string |
ユーザーの種類。 |
|
UUID(ユニバーサリー・ユニーク・アイデンティファイア)
|
userUUID | string |
ユーザーの UUID。 |