プランナー
Microsoft Planner を使用すると、チーム、タスク、ドキュメント、会話を簡単にまとめ、より良い結果を得ることができます。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Standard | 次を除くすべての Power Automate リージョン : - 21Vianet が運営する China Cloud |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure China リージョン |
| Power Apps | Standard | 次を除くすべての Power Apps リージョン : - 21Vianet が運営する China Cloud |
| Power Automate | Standard | 次を除くすべての Power Automate リージョン : - 21Vianet が運営する China Cloud |
| コネクタ メタデータ | |
|---|---|
| Publisher | Microsoft |
| Web サイト | https://planner.cloud.microsoft |
詳細については、Planner API Docs を参照してください。
既知の問題と制限事項
Important
Planner コネクタは現在、基本プランのみをサポートしています。
一部のアクションとトリガーではGroup Idを指定する必要がありますが、これは他の依存ドロップダウンを設定する目的でのみ行われます (たとえば、タスク アクションを作成すると、指定したGroup Idに基づいてPlan Idドロップダウンが設定されます)。 依存ドロップダウンが設定されると、 Group Id フィールドに任意の値を挿入できます。コネクタが Group Id フィールドに関して警告を表示しても、アクションは引き続き正常に動作します。
上記が適用されるアクション/トリガーの完全な一覧を次に示します。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
| トリガーポーリングの頻度 | 1 | 60 秒 |
アクション
| グループのプランを一覧表示する |
指定されたグループが所有するプランを一覧表示します。 |
| タスクから担当者を削除する |
既存の Planner タスクから担当者を削除します。 |
| タスクに担当者を追加する |
既存の Planner タスクに担当者を追加します。 |
| タスクの一覧表示 [非推奨] |
このアクションは非推奨になりました。 代わりに List タスク を使用してください。
|
| タスクの一覧表示 [非推奨] |
このアクションは非推奨になりました。 代わりに List タスク を使用してください。
|
| タスクの作成 (プレビュー) |
Planner で新しいタスクを作成します。 |
| タスクの作成 [非推奨] |
このアクションは非推奨になりました。 代わりに、[ タスクの作成] を 使用してください。
|
| タスクの作成 [非推奨] |
このアクションは非推奨になりました。 代わりに、[ タスクの作成] を 使用してください。
|
| タスクの取得 [非推奨] |
このアクションは非推奨になりました。 代わりに [タスクを取得]を 使用してください。
|
| タスクの更新 (V2) (プレビュー) |
既存の Planner タスクを更新します。 |
| タスクの更新 [非推奨] |
このアクションは非推奨になりました。 代わりに、 タスクの更新 (V2) を使用してください。
|
| タスクの詳細の取得 [非推奨] |
このアクションは非推奨になりました。 代わりに 、[タスクの詳細を取得] を使用してください。
|
| タスクの詳細の更新 [非推奨] |
このアクションは非推奨になりました。 代わりに、[ タスクの詳細の更新] を使用してください。
|
| タスクの詳細を取得する |
既存のタスクのタスクの詳細を取得します。 |
| タスクの詳細を更新する |
既存のタスクのタスクの詳細を更新します。 |
| タスクを一覧表示する |
プラン内のタスクを一覧表示します。 |
| タスクを作成する |
Planner で新しいタスクを作成します。 |
| タスクを削除する (プレビュー) |
既存の Planner タスクを削除します。 |
| タスクを取得する |
既存の Planner タスクを取得します。 |
| タスクを更新する |
既存の Planner タスクを更新します。 |
| バケットの一覧表示 [非推奨] |
このアクションは非推奨になりました。 代わりに 、リスト バケットを 使用してください。
|
| バケットの一覧表示 [非推奨] |
このアクションは非推奨になりました。 代わりに 、リスト バケットを 使用してください。
|
| バケットを一覧表示する |
プラン内のバケットを一覧表示します。 |
| バケットを作成する |
Planner で、指定したプランとグループのバケットを作成します。 |
| バケットを作成する [非推奨] |
このアクションは非推奨になりました。 代わりに、 バケットの作成を 使用してください。
|
| プランの詳細を取得する (プレビュー) |
タスクが属するプランの詳細を取得する |
| プランを一覧表示する [非推奨] |
ユーザーがサブスクライブしたプランを一覧表示します。 |
| プランを一覧表示する [非推奨] |
ユーザーがサブスクライブしたプランを一覧表示します。 |
| 自分のタスクを一覧表示する |
自分に割り当てられているタスクを一覧表示します。 |
| 自分のタスクを一覧表示する [非推奨] |
このアクションは非推奨になりました。 代わりに、[ 自分のタスクを一覧表示する ] を使用してください。
|
グループのプランを一覧表示する
指定されたグループが所有するプランを一覧表示します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
グループの ID。 |
戻り値
- Body
- ListMyPlans_Response
タスクから担当者を削除する
既存の Planner タスクから担当者を削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タスク ID
|
id | True | string |
更新するタスクの一意識別子。 |
|
割り当てられたユーザーを削除する
|
assignments | True | string |
このタスクに割り当て解除する必要があるユーザーのセミコロンで区切られた ID または電子メール アドレス。 |
戻り値
- Body
- GetTask_Response_V2
タスクに担当者を追加する
既存の Planner タスクに担当者を追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タスク ID
|
id | True | string |
更新するタスクの一意識別子。 |
|
割り当てられたユーザー ID
|
assignments | True | string |
このタスクに割り当てる必要があるユーザーのセミコロン区切り ID または電子メール アドレス。 |
戻り値
- Body
- GetTask_Response_V2
タスクの一覧表示 [非推奨]
このアクションは非推奨になりました。 代わりに List タスク を使用してください。
プラン内のタスクを一覧表示します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プラン ID
|
id | True | string |
プランの一意識別子。 |
戻り値
- Body
- ListTasks_Response
タスクの一覧表示 [非推奨]
このアクションは非推奨になりました。 代わりに List タスク を使用してください。
プラン内のタスクを一覧表示します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プラン ID
|
id | True | string |
プランの一意識別子。 |
戻り値
タスクの作成 (プレビュー)
Planner で新しいタスクを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
プランを取得するグループ。 |
|
プラン ID
|
planId | True | string |
新しいタスクの計画。 |
|
Title
|
title | True | string |
新しいタスクのタイトル (最大 255 文字)。 |
|
バケット ID
|
bucketId | string |
このタスクを配置するバケット。 |
|
|
開始日時
|
startDateTime | date-time |
タスクが開始される日時 (例: '2018-04-13T00:42:19.284Z')。 |
|
|
期限の時刻
|
dueDateTime | date-time |
タスクの期限である日時 (例: '2018-04-13T00:42:19.284Z')。 |
|
|
割り当てられたユーザー ID
|
assignments | string |
このタスクを割り当てるユーザーのセミコロンで区切られた ID または電子メール アドレス。 |
|
|
ピンク
|
category1 | boolean |
True の場合、タスクにピンクのカテゴリがあります。 |
|
|
Red
|
category2 | boolean |
True のタスクが赤のカテゴリを持っている場合。 |
|
|
Yellow
|
category3 | boolean |
True の タスクに黄色のカテゴリがある場合です。 |
|
|
Green
|
category4 | boolean |
True の場合、タスクに緑のカテゴリがあります。 |
|
|
Blue
|
category5 | boolean |
True の場合、タスクに青のカテゴリがあります。 |
|
|
Purple
|
category6 | boolean |
True の タスクに紫色のカテゴリがある場合です。 |
|
|
銅
|
category7 | boolean |
True の タスクにブロンズ カテゴリがある場合です。 |
|
|
ライム
|
category8 | boolean |
True の タスクに Lime カテゴリがある場合。 |
|
|
Aqua
|
category9 | boolean |
タスクに Aqua カテゴリがある場合は True です。 |
|
|
Gray
|
category10 | boolean |
True の 場合は、タスクが灰色のカテゴリです。 |
|
|
シルバー
|
category11 | boolean |
True の タスクに Silver カテゴリがある場合。 |
|
|
褐色
|
category12 | boolean |
True の場合、タスクに Brown カテゴリがあります。 |
|
|
クランベリー
|
category13 | boolean |
タスクにクランベリー カテゴリがある場合は True。 |
|
|
オレンジ
|
category14 | boolean |
True の タスクにオレンジ色のカテゴリがある場合です。 |
|
|
桃
|
category15 | boolean |
タスクに Peach カテゴリがある場合は True。 |
|
|
マリーゴールド
|
category16 | boolean |
True の 場合、タスクは、マリーゴールド カテゴリです。 |
|
|
浅緑
|
category17 | boolean |
True の タスクに明るい緑のカテゴリがある場合です。 |
|
|
濃い緑
|
category18 | boolean |
True の タスクに濃い緑のカテゴリがある場合。 |
|
|
ティール色
|
category19 | boolean |
タスクに Teal カテゴリがある場合は True。 |
|
|
水色
|
category20 | boolean |
True の タスクに水色のカテゴリがある場合です。 |
|
|
濃紺
|
category21 | boolean |
True の タスクに濃い青色のカテゴリがある場合。 |
|
|
ラベンダー
|
category22 | boolean |
タスクにラベンダー カテゴリがある場合は True。 |
|
|
李
|
category23 | boolean |
True の 場合、タスクは、Plum カテゴリです。 |
|
|
ライトグレー
|
category24 | boolean |
True の タスクに薄い灰色のカテゴリがある場合。 |
|
|
ダークグレー
|
category25 | boolean |
True の タスクに濃い灰色のカテゴリがある場合。 |
|
|
Priority
|
priority | integer |
タスクの優先度。 有効な値の範囲は 0 ~ 10 (両端を含む) で、値を大きくすると優先度が低くなります (0 は最も高い優先順位を持ち、10 は優先順位が最も低くなります)。 現在、Planner では、値 0 と 1 は "緊急"、2 と 3、4 は "重要"、5、6、および 7 は "medium"、8、9、および 10 は "low" と解釈されます。 現在、Planner では値 1 を "緊急" に、3 を "重要" に、5 を "medium" に、9 を "low" に設定しています。 |
戻り値
- Body
- GetTask_Response_V3
タスクの作成 [非推奨]
このアクションは非推奨になりました。 代わりに、[ タスクの作成] を 使用してください。
Planner で新しいタスクを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プラン ID
|
planId | True | string |
新しいタスクの計画。 |
|
Title
|
title | True | string |
新しいタスクのタイトル。 |
|
バケット ID
|
bucketId | string |
このタスクを配置するバケット。 |
|
|
開始日時
|
startDateTime | date-time |
タスクが開始される日時 (例: '2018-04-13T00:42:19.284Z')。 |
|
|
期限の時刻
|
dueDateTime | date-time |
タスクの期限である日時 (例: '2018-04-13T00:42:19.284Z')。 |
|
|
割り当てられたユーザー ID
|
assignments | string |
このタスクを割り当てるユーザーのセミコロンで区切った ID またはメール アドレス。 |
戻り値
- Body
- GetTask_Response_V2
タスクの作成 [非推奨]
このアクションは非推奨になりました。 代わりに、[ タスクの作成] を 使用してください。
Planner で新しいタスクを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プラン ID
|
planId | True | string |
新しいタスクの計画。 |
|
Title
|
title | True | string |
新しいタスクのタイトル。 |
|
バケット ID
|
bucketId | string |
このタスクを配置するバケット。 |
|
|
開始日時
|
startDateTime | date-time |
タスクが開始される日時 (例: '2018-04-13T00:42:19.284Z')。 |
|
|
期限の時刻
|
dueDateTime | date-time |
タスクの期限である日時 (例: '2018-04-13T00:42:19.284Z')。 |
|
|
割り当てられたユーザー ID
|
assignments | string |
このタスクを割り当てるユーザーの ID または電子メール アドレス。 |
戻り値
- Body
- GetTask_Response
タスクの取得 [非推奨]
このアクションは非推奨になりました。 代わりに [タスクを取得]を 使用してください。
既存の Planner タスクを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タスク ID
|
id | True | string |
タスクの一意の識別子。 |
戻り値
- Body
- GetTask_Response
タスクの更新 (V2) (プレビュー)
既存の Planner タスクを更新します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タスク ID
|
id | True | string |
更新するタスクの一意識別子。 |
|
Title
|
title | string |
プランのタイトル (最大 255 文字)。 |
|
|
期限 Date-Time
|
dueDateTime | date-time |
タスクの期限である日時 (例: '2018-04-13T00:42:19.284Z')。 |
|
|
Date-Time を開始する
|
startDateTime | date-time |
タスクが開始される日時 (例: '2018-04-13T00:42:19.284Z')。 |
|
|
完了率
|
percentComplete | integer |
タスクの完了率。 |
|
|
バケット ID
|
bucketId | string |
このタスクを配置するバケット。 |
|
|
ピンク
|
category1 | boolean |
True の場合、タスクにピンクのカテゴリがあります。 |
|
|
Red
|
category2 | boolean |
True のタスクが赤のカテゴリを持っている場合。 |
|
|
Yellow
|
category3 | boolean |
True の タスクに黄色のカテゴリがある場合です。 |
|
|
Green
|
category4 | boolean |
True の場合、タスクに緑のカテゴリがあります。 |
|
|
Blue
|
category5 | boolean |
True の場合、タスクに青のカテゴリがあります。 |
|
|
Purple
|
category6 | boolean |
True の タスクに紫色のカテゴリがある場合です。 |
|
|
銅
|
category7 | boolean |
True の タスクにブロンズ カテゴリがある場合です。 |
|
|
ライム
|
category8 | boolean |
True の タスクに Lime カテゴリがある場合。 |
|
|
Aqua
|
category9 | boolean |
タスクに Aqua カテゴリがある場合は True です。 |
|
|
Gray
|
category10 | boolean |
True の 場合は、タスクが灰色のカテゴリです。 |
|
|
シルバー
|
category11 | boolean |
True の タスクに Silver カテゴリがある場合。 |
|
|
褐色
|
category12 | boolean |
True の場合、タスクに Brown カテゴリがあります。 |
|
|
クランベリー
|
category13 | boolean |
タスクにクランベリー カテゴリがある場合は True。 |
|
|
オレンジ
|
category14 | boolean |
True の タスクにオレンジ色のカテゴリがある場合です。 |
|
|
桃
|
category15 | boolean |
タスクに Peach カテゴリがある場合は True。 |
|
|
マリーゴールド
|
category16 | boolean |
True の 場合、タスクは、マリーゴールド カテゴリです。 |
|
|
浅緑
|
category17 | boolean |
True の タスクに明るい緑のカテゴリがある場合です。 |
|
|
濃い緑
|
category18 | boolean |
True の タスクに濃い緑のカテゴリがある場合。 |
|
|
ティール色
|
category19 | boolean |
タスクに Teal カテゴリがある場合は True。 |
|
|
水色
|
category20 | boolean |
True の タスクに水色のカテゴリがある場合です。 |
|
|
濃紺
|
category21 | boolean |
True の タスクに濃い青色のカテゴリがある場合。 |
|
|
ラベンダー
|
category22 | boolean |
タスクにラベンダー カテゴリがある場合は True。 |
|
|
李
|
category23 | boolean |
True の 場合、タスクは、Plum カテゴリです。 |
|
|
ライトグレー
|
category24 | boolean |
True の タスクに薄い灰色のカテゴリがある場合。 |
|
|
ダークグレー
|
category25 | boolean |
True の タスクに濃い灰色のカテゴリがある場合。 |
戻り値
- Body
- GetTask_Response_V2
タスクの更新 [非推奨]
このアクションは非推奨になりました。 代わりに、 タスクの更新 (V2) を使用してください。
既存の Planner タスクを更新します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タスク ID
|
id | True | string |
更新する美味しいユーザーの一意識別子。 |
|
Title
|
title | string |
プランのタイトル。 |
|
|
期限 Date-Time
|
dueDateTime | date-time |
タスクの期限である日時 (例: '2018-04-13T00:42:19.284Z')。 |
|
|
Date-Time を開始する
|
startDateTime | date-time |
タスクが開始される日時 (例: '2018-04-13T00:42:19.284Z')。 |
|
|
進捗
|
percentComplete | string |
タスクの進行状況。 |
|
|
Assisgned ユーザー ID
|
assignments | string |
このタスクを割り当てるユーザーの ID または電子メール アドレス。 |
戻り値
- Body
- GetTask_Response
タスクの詳細の取得 [非推奨]
このアクションは非推奨になりました。 代わりに 、[タスクの詳細を取得] を使用してください。
既存のタスクのタスクの詳細を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タスク ID
|
id | True | string |
タスクの一意の識別子。 |
戻り値
タスクの詳細の更新 [非推奨]
このアクションは非推奨になりました。 代わりに、[ タスクの詳細の更新] を使用してください。
既存のタスクのタスクの詳細を更新します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タスク ID
|
id | True | string |
タスクの一意の識別子。 |
|
Description
|
description | string |
タスクの説明です。 |
|
|
エイリアス
|
alias | string |
参照を説明する名前エイリアス。 |
|
|
リソース リンク
|
resourceLink | True | uri |
HTTP/HTTPS プロトコルに基づく有効な URL。 |
|
参照の種類
|
type |
参照の型を記述するために使用されます。 |
||
|
ID (アイディー)
|
id | True | string |
チェックリスト項目を表す数値。 |
|
Title
|
title | True | string |
チェックリスト項目の名前。 |
|
チェックされている
|
isChecked | True | boolean |
項目がチェックされているかどうか。 |
戻り値
タスクの詳細を取得する
既存のタスクのタスクの詳細を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タスク ID
|
id | True | string |
更新するタスクの一意識別子。 |
戻り値
タスクの詳細を更新する
既存のタスクのタスクの詳細を更新します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タスク ID
|
id | True | string |
更新するタスクの一意識別子。 |
|
Description
|
description | string |
タスクの説明です。 |
|
|
エイリアス
|
alias | string |
参照を説明する名前エイリアス。 |
|
|
リソース リンク
|
resourceLink | True | uri |
HTTP/HTTPS プロトコルに基づく有効な URL。 |
|
参照の種類
|
type |
参照の型を記述するために使用されます。 |
||
|
ID (アイディー)
|
id | True | string |
チェックリスト項目を表す数値。 |
|
Title
|
title | True | string |
チェックリスト項目の名前。 |
|
チェックされている
|
isChecked | True | boolean |
項目がチェックされているかどうか。 |
戻り値
タスクを一覧表示する
プラン内のタスクを一覧表示します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
プランを取得するグループ。 |
|
プラン ID
|
id | True | string |
プランの一意識別子。 |
戻り値
タスクを作成する
Planner で新しいタスクを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
プランを取得するグループ。 |
|
プラン ID
|
planId | True | string |
新しいタスクの計画。 |
|
Title
|
title | True | string |
新しいタスクのタイトル (最大 255 文字)。 |
|
バケット ID
|
bucketId | string |
このタスクを配置するバケット。 |
|
|
開始日時
|
startDateTime | date-time |
タスクが開始される日時 (例: '2018-04-13T00:42:19.284Z')。 |
|
|
期限の時刻
|
dueDateTime | date-time |
タスクの期限である日時 (例: '2018-04-13T00:42:19.284Z')。 |
|
|
割り当てられたユーザー ID
|
assignments | string |
このタスクを割り当てるユーザーのセミコロンで区切られた ID または電子メール アドレス。 |
|
|
ピンク
|
category1 | boolean |
True の場合、タスクにピンクのカテゴリがあります。 |
|
|
Red
|
category2 | boolean |
True のタスクが赤のカテゴリを持っている場合。 |
|
|
Yellow
|
category3 | boolean |
True の タスクに黄色のカテゴリがある場合です。 |
|
|
Green
|
category4 | boolean |
True の場合、タスクに緑のカテゴリがあります。 |
|
|
Blue
|
category5 | boolean |
True の場合、タスクに青のカテゴリがあります。 |
|
|
Purple
|
category6 | boolean |
True の タスクに紫色のカテゴリがある場合です。 |
|
|
銅
|
category7 | boolean |
True の タスクにブロンズ カテゴリがある場合です。 |
|
|
ライム
|
category8 | boolean |
True の タスクに Lime カテゴリがある場合。 |
|
|
Aqua
|
category9 | boolean |
タスクに Aqua カテゴリがある場合は True です。 |
|
|
Gray
|
category10 | boolean |
True の 場合は、タスクが灰色のカテゴリです。 |
|
|
シルバー
|
category11 | boolean |
True の タスクに Silver カテゴリがある場合。 |
|
|
褐色
|
category12 | boolean |
True の場合、タスクに Brown カテゴリがあります。 |
|
|
クランベリー
|
category13 | boolean |
タスクにクランベリー カテゴリがある場合は True。 |
|
|
オレンジ
|
category14 | boolean |
True の タスクにオレンジ色のカテゴリがある場合です。 |
|
|
桃
|
category15 | boolean |
タスクに Peach カテゴリがある場合は True。 |
|
|
マリーゴールド
|
category16 | boolean |
True の 場合、タスクは、マリーゴールド カテゴリです。 |
|
|
浅緑
|
category17 | boolean |
True の タスクに明るい緑のカテゴリがある場合です。 |
|
|
濃い緑
|
category18 | boolean |
True の タスクに濃い緑のカテゴリがある場合。 |
|
|
ティール色
|
category19 | boolean |
タスクに Teal カテゴリがある場合は True。 |
|
|
水色
|
category20 | boolean |
True の タスクに水色のカテゴリがある場合です。 |
|
|
濃紺
|
category21 | boolean |
True の タスクに濃い青色のカテゴリがある場合。 |
|
|
ラベンダー
|
category22 | boolean |
タスクにラベンダー カテゴリがある場合は True。 |
|
|
李
|
category23 | boolean |
True の 場合、タスクは、Plum カテゴリです。 |
|
|
ライトグレー
|
category24 | boolean |
True の タスクに薄い灰色のカテゴリがある場合。 |
|
|
ダークグレー
|
category25 | boolean |
True の タスクに濃い灰色のカテゴリがある場合。 |
戻り値
- Body
- GetTask_Response_V2
タスクを削除する (プレビュー)
既存の Planner タスクを削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タスク ID
|
id | True | string |
削除するタスクの一意識別子。 |
タスクを取得する
既存の Planner タスクを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タスク ID
|
id | True | string |
更新するタスクの一意識別子。 |
戻り値
- Body
- GetTask_Response_V2
タスクを更新する
既存の Planner タスクを更新します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タスク ID
|
id | True | string |
更新するタスクの一意識別子。 |
|
Title
|
title | string |
プランのタイトル。 |
|
|
期限 Date-Time
|
dueDateTime | date-time |
タスクの期限である日時 (例: '2018-04-13T00:42:19.284Z')。 |
|
|
Date-Time を開始する
|
startDateTime | date-time |
タスクが開始される日時 (例: '2018-04-13T00:42:19.284Z')。 |
|
|
進捗
|
percentComplete | string |
タスクの進行状況。 |
|
|
割り当てられたユーザーを追加する
|
assignments | string |
このタスクに割り当てる必要があるユーザーのセミコロン区切り ID または電子メール アドレス。 |
|
|
割り当てられたユーザーを削除する
|
unassignedUsers | string |
このタスクから割り当てを解除する必要があるユーザーのセミコロンで区切られた ID またはメール アドレス。 |
戻り値
- Body
- GetTask_Response_V2
バケットの一覧表示 [非推奨]
このアクションは非推奨になりました。 代わりに 、リスト バケットを 使用してください。
プラン内のバケットを一覧表示します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プラン ID
|
id | True | string |
プランの一意識別子。 |
戻り値
- Body
- ListBuckets_Response
バケットの一覧表示 [非推奨]
このアクションは非推奨になりました。 代わりに 、リスト バケットを 使用してください。
プラン内のバケットを一覧表示します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プラン ID
|
id | True | string |
プランの一意識別子。 |
戻り値
- Body
- ListBuckets_Response
バケットを一覧表示する
プラン内のバケットを一覧表示します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
プランを取得するグループ。 |
|
プラン ID
|
id | True | string |
プランの一意識別子。 |
戻り値
- Body
- ListBuckets_Response
バケットを作成する
Planner で、指定したプランとグループのバケットを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
名前
|
name | True | string |
バケットの名前 |
|
グループ ID
|
groupId | True | string |
プランを取得するグループ。 |
|
プラン ID
|
planId | True | string |
新しいバケットの計画。 |
戻り値
バケットを作成する [非推奨]
このアクションは非推奨になりました。 代わりに、 バケットの作成を 使用してください。
Planner でバケットを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
名前
|
name | True | string |
バケットの名前 |
|
プラン ID
|
planId | True | string |
新しいバケットの計画 |
戻り値
プランの詳細を取得する (プレビュー)
タスクが属するプランの詳細を取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プラン ID
|
id | True | string |
一意のプラン ID。 |
戻り値
プランを一覧表示する [非推奨]
プランを一覧表示する [非推奨]
自分のタスクを一覧表示する
自分のタスクを一覧表示する [非推奨]
このアクションは非推奨になりました。 代わりに、[ 自分のタスクを一覧表示する ] を使用してください。
自分に割り当てられているタスクを一覧表示します。
戻り値
- Body
- ListTasks_Response
トリガー
| タスクが完了したとき |
この操作は、タスクが完了したときにトリガーされます。 |
| タスクが完了したとき [非推奨] |
このアクションは非推奨になりました。 タスク が完了したら 、代わりに使用してください。
|
| タスクが完了したとき [非推奨] |
このアクションは非推奨になりました。 タスク が完了したら 、代わりに使用してください。
|
| タスクが自分に割り当てられている場合 |
この操作は、タスクが自分に割り当てられるときにトリガーされます。 |
| タスクが自分に割り当てられている場合 [非推奨] |
このアクションは非推奨になりました。 代わりに タスクが自分に割り当てられている場合に 使用してください。
|
| 新しいタスクが作成されたとき |
この操作は、新しいタスクが作成されたときにトリガーされます。 |
| 新しいタスクが作成されたとき [非推奨] |
このアクションは非推奨になりました。 代わりに 、新しいタスクが作成されたときに 使用してください。
|
| 新しいタスクが作成されたとき [非推奨] |
このアクションは非推奨になりました。 代わりに 、新しいタスクが作成されたときに 使用してください。
|
タスクが完了したとき
この操作は、タスクが完了したときにトリガーされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
プランを取得するグループ。 |
|
プラン ID
|
id | True | string |
プランの一意識別子。 |
戻り値
タスクが完了したとき [非推奨]
このアクションは非推奨になりました。 タスク が完了したら 、代わりに使用してください。
この操作は、タスクが完了したときにトリガーされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プラン ID
|
id | True | string |
プランの一意識別子。 |
戻り値
タスクが完了したとき [非推奨]
このアクションは非推奨になりました。 タスク が完了したら 、代わりに使用してください。
この操作は、タスクが完了したときにトリガーされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プラン ID
|
id | True | string |
プランの一意識別子。 |
戻り値
- Body
- ListTasks_Response
タスクが自分に割り当てられている場合
タスクが自分に割り当てられている場合 [非推奨]
このアクションは非推奨になりました。 代わりに タスクが自分に割り当てられている場合に 使用してください。
この操作は、タスクが自分に割り当てられるときにトリガーされます。
戻り値
- Body
- ListTasks_Response
新しいタスクが作成されたとき
この操作は、新しいタスクが作成されたときにトリガーされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
プランを取得するグループ。 |
|
プラン ID
|
id | True | string |
プランの一意識別子。 |
戻り値
新しいタスクが作成されたとき [非推奨]
このアクションは非推奨になりました。 代わりに 、新しいタスクが作成されたときに 使用してください。
この操作は、新しいタスクが作成されたときにトリガーされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プラン ID
|
id | True | string |
プランの一意識別子。 |
戻り値
新しいタスクが作成されたとき [非推奨]
このアクションは非推奨になりました。 代わりに 、新しいタスクが作成されたときに 使用してください。
この操作は、新しいタスクが作成されたときにトリガーされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プラン ID
|
id | True | string |
プランの一意識別子。 |
戻り値
- Body
- ListTasks_Response
定義
ListBuckets_Response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
value
|
value | array of object | |
|
名前
|
value.name | string |
バケットの名前。 |
|
プラン ID
|
value.planId | string |
このバケットが属するプランの ID。 |
|
ID (アイディー)
|
value.id | string |
バケットの ID。 |
ListMyPlans_Response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
value
|
value | array of object | |
|
Title
|
value.title | string |
プランのタイトル。 |
|
ID (アイディー)
|
value.id | string |
プランの ID。 |
GetTaskDetails_Response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Description
|
description | string |
タスクの説明です。 |
|
ID (アイディー)
|
id | string |
タスクの ID。 |
|
References
|
references | array of object |
タスクの参照のコレクション |
|
リソース リンク
|
references.resourceLink | uri |
HTTP/HTTPS プロトコルに基づく有効な URL。 |
|
エイリアス
|
references.value.alias | string |
参照を説明する名前エイリアス。 |
|
参照の種類
|
references.value.type |
参照の型を記述するために使用されます。 |
|
|
Checklist
|
checklist | array of object |
タスクのチェックリスト項目のコレクション。 |
|
ID (アイディー)
|
checklist.id | string |
チェックリスト項目を表す数値。 |
|
Title
|
checklist.value.title | string |
チェックリスト項目の名前。 |
|
チェックされている
|
checklist.value.isChecked | boolean |
項目がチェックされているかどうか。 |
CreateBucket_Response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
名前
|
name | string |
バケットの名前 |
|
プラン ID
|
planId | string |
バケットが属するプラン ID |
|
注文ヒント
|
orderHint | string |
リスト ビューでこの種類のアイテムを並べ替えるために使用されるヒント |
|
ID (アイディー)
|
id | string |
バケットの ID |
GetTask_Response_V2
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
表示される名前
|
createdBy.user.displayName | string |
このタスクを作成したユーザーの表示名。 |
|
ID (アイディー)
|
createdBy.user.id | string |
このタスクを作成したユーザーの ID。 |
|
プラン ID
|
planId | string |
このタスクが属するプランの ID。 |
|
バケット ID
|
bucketId | string |
このタスクが属するバケットの ID。 |
|
Title
|
title | string |
タスクのタイトル。 |
|
完了率
|
percentComplete | integer |
タスクの完了率。 |
|
開始日時
|
startDateTime | date-time |
タスクの開始日時。 |
|
作成日時
|
createdDateTime | date-time |
タスクが作成された日時。 |
|
期限の時刻
|
dueDateTime | date-time |
タスクの期限の日時。 |
|
説明あり
|
hasDescription | boolean |
タスクに説明がある場合は true に設定します。 |
|
完了日時
|
completedDateTime | date-time |
タスクが完了した日時。 |
|
参照カウント
|
referenceCount | integer |
タスクに存在する外部参照の数。 |
|
ID (アイディー)
|
id | string |
タスクの ID。 |
|
appliedCategories
|
appliedCategories | AppliedCategories |
タスクが適用されているカテゴリ。 |
|
assignments
|
_assignments | array of object | |
|
ユーザー ID に割り当て済み
|
_assignments.userId | string |
このタスクが割り当てられたユーザーの ID。 |
|
ユーザー ID によって割り当てられます
|
_assignments.value.assignedBy.user.id | string |
このタスクを割り当てたユーザーの ID。 |
|
割り当てられた日時
|
_assignments.value.assignedDateTime | date-time |
タスクが割り当てられた日時。 |
|
注文ヒント
|
_assignments.value.orderHint | string |
注文ヒント |
GetTask_Response_V3
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
表示される名前
|
createdBy.user.displayName | string |
このタスクを作成したユーザーの表示名。 |
|
ID (アイディー)
|
createdBy.user.id | string |
このタスクを作成したユーザーの ID。 |
|
プラン ID
|
planId | string |
このタスクが属するプランの ID。 |
|
バケット ID
|
bucketId | string |
このタスクが属するバケットの ID。 |
|
Title
|
title | string |
タスクのタイトル。 |
|
完了率
|
percentComplete | integer |
タスクの完了率。 |
|
開始日時
|
startDateTime | date-time |
タスクの開始日時。 |
|
作成日時
|
createdDateTime | date-time |
タスクが作成された日時。 |
|
期限の時刻
|
dueDateTime | date-time |
タスクの期限の日時。 |
|
説明あり
|
hasDescription | boolean |
タスクに説明がある場合は true に設定します。 |
|
完了日時
|
completedDateTime | date-time |
タスクが完了した日時。 |
|
参照カウント
|
referenceCount | integer |
タスクに存在する外部参照の数。 |
|
ID (アイディー)
|
id | string |
タスクの ID。 |
|
appliedCategories
|
appliedCategories | AppliedCategories |
タスクが適用されているカテゴリ。 |
|
Priority
|
priority | integer |
タスクの優先度。 有効な値の範囲は 0 ~ 10 (両端を含む) で、値を大きくすると優先度が低くなります (0 は最も高い優先順位を持ち、10 は優先順位が最も低くなります)。 現在、Planner では、値 0 と 1 は "緊急"、2 と 3、4 は "重要"、5、6、および 7 は "medium"、8、9、および 10 は "low" と解釈されます。 現在、Planner では値 1 を "緊急" に、3 を "重要" に、5 を "medium" に、9 を "low" に設定しています。 |
|
assignments
|
_assignments | array of object | |
|
ユーザー ID に割り当て済み
|
_assignments.userId | string |
このタスクが割り当てられたユーザーの ID。 |
|
ユーザー ID によって割り当てられます
|
_assignments.value.assignedBy.user.id | string |
このタスクを割り当てたユーザーの ID。 |
|
割り当てられた日時
|
_assignments.value.assignedDateTime | date-time |
タスクが割り当てられた日時。 |
|
注文ヒント
|
_assignments.value.orderHint | string |
注文ヒント |
ListTasks_Response_V2
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
value
|
value | array of GetTask_Response_V2 |
AppliedCategories
タスクが適用されているカテゴリ。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ピンク
|
category1 | boolean |
True の場合、タスクにピンクのカテゴリがあります。 |
|
Red
|
category2 | boolean |
True のタスクが赤のカテゴリを持っている場合。 |
|
Yellow
|
category3 | boolean |
True の タスクに黄色のカテゴリがある場合です。 |
|
Green
|
category4 | boolean |
True の場合、タスクに緑のカテゴリがあります。 |
|
Blue
|
category5 | boolean |
True の場合、タスクに青のカテゴリがあります。 |
|
Purple
|
category6 | boolean |
True の タスクに紫色のカテゴリがある場合です。 |
|
銅
|
category7 | boolean |
True の タスクにブロンズ カテゴリがある場合です。 |
|
ライム
|
category8 | boolean |
True の タスクに Lime カテゴリがある場合。 |
|
Aqua
|
category9 | boolean |
タスクに Aqua カテゴリがある場合は True です。 |
|
Gray
|
category10 | boolean |
True の 場合は、タスクが灰色のカテゴリです。 |
|
シルバー
|
category11 | boolean |
True の タスクに Silver カテゴリがある場合。 |
|
褐色
|
category12 | boolean |
True の場合、タスクに Brown カテゴリがあります。 |
|
クランベリー
|
category13 | boolean |
タスクにクランベリー カテゴリがある場合は True。 |
|
オレンジ
|
category14 | boolean |
True の タスクにオレンジ色のカテゴリがある場合です。 |
|
桃
|
category15 | boolean |
タスクに Peach カテゴリがある場合は True。 |
|
マリーゴールド
|
category16 | boolean |
True の 場合、タスクは、マリーゴールド カテゴリです。 |
|
浅緑
|
category17 | boolean |
True の タスクに明るい緑のカテゴリがある場合です。 |
|
濃い緑
|
category18 | boolean |
True の タスクに濃い緑のカテゴリがある場合。 |
|
ティール色
|
category19 | boolean |
タスクに Teal カテゴリがある場合は True。 |
|
水色
|
category20 | boolean |
True の タスクに水色のカテゴリがある場合です。 |
|
濃紺
|
category21 | boolean |
True の タスクに濃い青色のカテゴリがある場合。 |
|
ラベンダー
|
category22 | boolean |
タスクにラベンダー カテゴリがある場合は True。 |
|
李
|
category23 | boolean |
True の 場合、タスクは、Plum カテゴリです。 |
|
ライトグレー
|
category24 | boolean |
True の タスクに薄い灰色のカテゴリがある場合。 |
|
ダークグレー
|
category25 | boolean |
True の タスクに濃い灰色のカテゴリがある場合。 |
GetTask_Response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
表示される名前
|
createdBy.user.displayName | string |
このタスクを作成したユーザーの表示名。 |
|
ID (アイディー)
|
createdBy.user.id | string |
このタスクを作成したユーザーの ID。 |
|
プラン ID
|
planId | string |
このタスクが属するプランの ID。 |
|
バケット ID
|
bucketId | string |
このタスクが属するバケットの ID。 |
|
Title
|
title | string |
タスクのタイトル。 |
|
完了率
|
percentComplete | integer |
タスクの完了率。 |
|
開始日時
|
startDateTime | date-time |
タスクの開始日時。 |
|
作成日時
|
createdDateTime | date-time |
タスクが作成された日時。 |
|
期限の時刻
|
dueDateTime | date-time |
タスクの期限の日時。 |
|
説明あり
|
hasDescription | boolean |
タスクに説明がある場合は true に設定します。 |
|
完了日時
|
completedDateTime | date-time |
タスクが完了した日時。 |
|
参照カウント
|
referenceCount | integer |
タスクに存在する外部参照の数。 |
|
ID (アイディー)
|
id | string |
タスクの ID。 |
ListTasks_Response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
value
|
value | array of object | |
|
表示名で作成
|
value.createdBy.user.displayName | string |
このタスクを作成したユーザーの表示名。 |
|
ID (アイディー)
|
value.createdBy.user.id | string |
このタスクを作成したユーザーの ID。 |
|
表示名で完了
|
value.completedBy.user.displayName | string |
ディスプレイ名 |
|
id
|
value.completedBy.user.id | string |
id |
|
プラン ID
|
value.planId | string |
このタスクが属するプランの ID。 |
|
バケット ID
|
value.bucketId | string |
このタスクが属するバケットの ID。 |
|
Title
|
value.title | string |
タスクのタイトル。 |
|
完了率
|
value.percentComplete | integer |
タスクの完了率。 |
|
開始日時
|
value.startDateTime | date-time |
タスクの開始日時。 |
|
作成日時
|
value.createdDateTime | date-time |
タスクが作成された日時。 |
|
期限の時刻
|
value.dueDateTime | date-time |
タスクの期限の日時。 |
|
説明あり
|
value.hasDescription | boolean |
タスクに説明がある場合は True に設定します。 |
|
完了日時
|
value.completedDateTime | date-time |
タスクが完了した日時。 |
|
参照カウント
|
value.referenceCount | integer |
タスクに存在する外部参照の数。 |
|
ID (アイディー)
|
value.id | string |
タスクの ID。 |
GetPlanDetails_Response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
カテゴリ 1
|
categoryDescriptions.category1 | string |
カテゴリ 1。 |
|
カテゴリ 2
|
categoryDescriptions.category2 | string |
カテゴリ 2。 |
|
カテゴリ 3
|
categoryDescriptions.category3 | string |
カテゴリ 3。 |
|
カテゴリ 4
|
categoryDescriptions.category4 | string |
カテゴリ 4。 |
|
カテゴリ 5
|
categoryDescriptions.category5 | string |
カテゴリ 5。 |
|
カテゴリ 6
|
categoryDescriptions.category6 | string |
カテゴリ 6。 |
|
カテゴリ 7
|
categoryDescriptions.category7 | string |
カテゴリ 7。 |
|
カテゴリ 8
|
categoryDescriptions.category8 | string |
カテゴリ 8。 |
|
カテゴリ 9
|
categoryDescriptions.category9 | string |
カテゴリ 9。 |
|
カテゴリ 10
|
categoryDescriptions.category10 | string |
カテゴリ 10。 |
|
カテゴリ 11
|
categoryDescriptions.category11 | string |
カテゴリ 11。 |
|
カテゴリ 12
|
categoryDescriptions.category12 | string |
カテゴリ 12。 |
|
カテゴリ 13
|
categoryDescriptions.category13 | string |
カテゴリ 13。 |
|
カテゴリ 14
|
categoryDescriptions.category14 | string |
カテゴリ 14。 |
|
カテゴリ 15
|
categoryDescriptions.category15 | string |
カテゴリ 15。 |
|
カテゴリ 16
|
categoryDescriptions.category16 | string |
カテゴリ 16。 |
|
カテゴリ 17
|
categoryDescriptions.category17 | string |
カテゴリ 17。 |
|
カテゴリ 18
|
categoryDescriptions.category18 | string |
カテゴリ 18。 |
|
カテゴリ 19
|
categoryDescriptions.category19 | string |
カテゴリ 19。 |
|
カテゴリ 20
|
categoryDescriptions.category20 | string |
カテゴリ 20。 |
|
カテゴリ 21
|
categoryDescriptions.category21 | string |
カテゴリ 21。 |
|
カテゴリ 22
|
categoryDescriptions.category22 | string |
カテゴリ 22。 |
|
カテゴリ 23
|
categoryDescriptions.category23 | string |
カテゴリ 23。 |
|
カテゴリ 24
|
categoryDescriptions.category24 | string |
カテゴリ 24。 |
|
カテゴリ 25
|
categoryDescriptions.category25 | string |
カテゴリ 25。 |
|
ID (アイディー)
|
id | string |
プランの詳細の ID |