Microsoft To-Do (Business)

  • リファレンス

Microsoft To Do は、1 日の計画と管理を簡単にする、インテリジェントなタスク管理アプリです。 Microsoft To Do に接続して、さまざまなサービスからタスクを管理します。 タスクを作成するなどのアクションが実行されます。

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

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate 標準 以下を除くすべての Power Automate 地域 :
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
Power Apps 標準 以下を除くすべての Power Apps 地域 :
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
連絡先
件名 Microsoft
URL Microsoft LogicApps サポート
Microsoft Power Automate サポート
Microsoft Power Apps サポート
コネクタ メタデータ
発行者 Microsoft
Web サイト https://todo.microsoft.com/tasks/

既知の問題と制限事項

To Do API には、Outlook タスク 機能のほとんどがあります。 outlookTaskGroup エンティティ、拡張プロパティと assignedTo、outlookTask エンティティ の所有者プロパティは、To Do API では使用できません。

Outlook タスク API の非推奨

グラフ Outlook タスク API は、2023 年 2 月 20 日以降データを返さなくなります。

ここにリストされている操作は、API の非推奨の影響を受け、2023 年 2 月 20 日以降データを返さなくなります。

ここにリストされている操作は、API の非推奨の影響を受けません。

To Do API リリースに関する開発ブログ

調整制限

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

アクション

To Do の削除 [DEPRECATED]

このアクションは非推奨になりました。 代わりに、To Do を削除 (V2) を使用してください。

この操作は、タスクを削除するために使用します。
To Do の更新 [DEPRECATED]

このアクションは非推奨になりました。 代わりに、To Do を更新 (V2) を使用してください。

この操作は、特定の To Do を更新するために使用します。
To do を削除する (V2)

この操作は、タスクを削除するために使用します。
To Do を取得する (V3)

この操作は、指定された ID の To Do を取得するために使用します。
To Do を更新する (V2)

この操作は、特定の To Do を更新するために使用します。
To Do を追加 (V2) [DEPRECATED]

このアクションは非推奨になりました。 代わりに、To Do を追加 (V3) を使用してください。

この操作は、指定した To Do リストの To Do を作成するために使用します (既定値は To-Do)。
To Do を追加 [DEPRECATED]

このアクションは非推奨になりました。 代わりに、To Do を追加 (V3) を使用してください。

この操作は、指定した To Do リストの To Do を作成するために使用します (既定値は To-Do)。
To Do を追加する (V3)

この操作は、指定した To Do リストの To Do を作成するために使用します。
To Do リストを作成 [DEPRECATED]

このアクションは非推奨になりました。 代わりに、To Do リストを作成 (V2) を使用してください。

この操作は、新しい To Do リストを作成するために使用します。
To Do リストを作成する (V2)

この操作は、新しい To Do リストを作成するために使用します。
To Do リストを削除する

この操作は、特定の To Do リストを削除するために使用します。
To Do リストを取得 (V2) [DEPRECATED]

このアクションは非推奨になりました。 代わりに、To Do を取得 (V3) を使用してください。

この操作は、指定された ID の To Do を取得するために使用します。
To Do リストを取得 [DEPRECATED]

このアクションは非推奨になりました。 代わりに、To Do を取得 (V3) を使用してください。

この操作は、指定された ID の To Do を取得するために使用します。
To Do リストを取得 [DEPRECATED]

このアクションは非推奨になりました。 代わりに、To Do リストを取得 (V2) を使用してください。

この操作は、特定の To Do リストを取得するために使用します。
To Do リストを取得する (V2)

この操作は、特定の To Do リストを取得するために使用します。
To Do リストを更新する

この操作は、特定の To Do リストを更新するために使用します。
すべての To do の項目を一覧表示 [非推奨]

この操作は、すべてのリストからすべての To Do を取得するために使用します。
すべての To do リストを一覧表示 [DEPRECATED]

このアクションは非推奨になりました。 代わりに、To Do リストを一覧表示 (V2) を使用してください。

すべての To Do リストの一覧を返します。
すべての To do リストを一覧表示する (V2)

すべての To Do リストの一覧を返します。
フォルダー別に To Do を一覧表示 [DEPRECATED]

このアクションは非推奨になりました。 代わりに、フォルダーで To Do の項目を一覧表示 (V2) を使用してください。

この操作は、特定のリストからすべての To Do を取得するために使用します。
フォルダー別に To Do を一覧表示する (V2)

この操作は、特定のリストからすべての To Do を取得するために使用します。

To Do の削除 [DEPRECATED]

操作 ID:
DeleteToDo

このアクションは非推奨になりました。 代わりに、To Do を削除 (V2) を使用してください。

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

パラメーター

名前 キー 必須 型 説明
To Do リスト
 folderId True string

To Do リスト
To Do タスク
 id True string

To Do タスク

To Do の更新 [DEPRECATED]

操作 ID:
UpdateToDo

このアクションは非推奨になりました。 代わりに、To Do を更新 (V2) を使用してください。

この操作は、特定の To Do を更新するために使用します。

パラメーター

名前 キー 必須 型 説明
To Do リスト
 folderId True string

To Do リスト
To Do タスク
 id True string

To Do タスク
期日
 DateTime date-time

YYYY-MM-DD または YYYY-MM-DDThh:mm:ssZ (時刻部分は無視されます)
リマインダーの日時
 DateTime date-time

YYYY-MM-DDThh:mm:ssZ (UTC 形式)
開始日
 DateTime date-time

YYYY-MM-DD または YYYY-MM-DDThh:mm:ssZ (時刻部分は無視されます)
重要度
 Importance string

低、標準、高。
情報カテゴリ
 Subject string

To Do の簡単な説明またはタイトル。
ステータス
 Status string

To Do の状態または進行状況を示します - 未開始、進行中、完了、待機中、遅延。
秘密度
 Sensitivity string

イベントのプライバシーのレベルを示します。
Content Type
 ContentType string

Text=0、HTML=1
コンテンツ
 Content string

テキストまたは HTML コンテンツです。
カテゴリー
 Categories array of string

To Do に関連付けられているカテゴリ名のコレクションです。
アラーム設定済みである
 IsReminderOn boolean

To Do をユーザーに通知するようにアラートが設定されている場合は true。

戻り値

Microsoft To-Do オブジェクト。

Body
ToDo

To do を削除する (V2)

操作 ID:
DeleteToDoV2

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

パラメーター

名前 キー 必須 型 説明
To Do リスト
 folderId True string

To Do リスト
To Do タスク
 id True string

To Do タスク

To Do を取得する (V3)

操作 ID:
GetToDoV3

この操作は、指定された ID の To Do を取得するために使用します。

パラメーター

名前 キー 必須 型 説明
To Do リスト
 folderId True string

To Do リスト
To Do タスク
 id True string

To Do タスク

戻り値

Microsoft To-Do オブジェクト。

本文​​
ToDo_V2

To Do を更新する (V2)

操作 ID:
UpdateToDoV2

この操作は、特定の To Do を更新するために使用します。

パラメーター

名前 キー 必須 型 説明
To Do リスト
 folderId True string

To Do リスト
To Do タスク
 id True string

To Do タスク
期日
 dateTime date-time

YYYY-MM-DDThh:mm:ss
リマインダーの日時
 dateTime date-time

YYYY-MM-DDThh:mm:ss
重要度
 importance string

低、標準、高。
敬称
 title string

To Do の簡単な説明またはタイトル。
ステータス
 status string

To Do の状態または進行状況を示します - 未開始、進行中、完了、待機中、遅延。
内容
 content html

項目のコンテンツです。
アラーム設定済みである
 isReminderOn boolean

To Do をユーザーに通知するようにアラートが設定されている場合は true。

戻り値

Microsoft To-Do オブジェクト。

本文​​
ToDo_V2

To Do を追加 (V2) [DEPRECATED]

操作 ID:
CreateToDoV2

このアクションは非推奨になりました。 代わりに、To Do を追加 (V3) を使用してください。

この操作は、指定した To Do リストの To Do を作成するために使用します (既定値は To-Do)。

パラメーター

名前 キー 必須 型 説明
To Do リスト
 folderId string

To Do リスト
期日
 DateTime date-time

YYYY-MM-DD または YYYY-MM-DDThh:mm:ssZ (時刻部分は無視されます)
リマインダーの日時
 DateTime date-time

YYYY-MM-DDThh:mm:ssZ (UTC 形式)
開始日
 DateTime date-time

YYYY-MM-DD または YYYY-MM-DDThh:mm:ssZ (時刻部分は無視されます)
重要度
 Importance string

低、標準、高。
情報カテゴリ
 Subject True string

To Do の簡単な説明またはタイトル。
ステータス
 Status string

To Do の状態または進行状況を示します - 未開始、進行中、完了、待機中、遅延。
秘密度
 Sensitivity string

イベントのプライバシーのレベルを示します。
コンテンツ
 Content html

コンテンツ。
カテゴリー
 Categories array of string

To Do に関連付けられているカテゴリ名のコレクションです。
アラーム設定済みである
 IsReminderOn boolean

To Do をユーザーに通知するようにアラートが設定されている場合は true。

戻り値

Microsoft To-Do オブジェクト。

Body
ToDoHtml

To Do を追加 [DEPRECATED]

操作 ID:
CreateToDo

このアクションは非推奨になりました。 代わりに、To Do を追加 (V3) を使用してください。

この操作は、指定した To Do リストの To Do を作成するために使用します (既定値は To-Do)。

パラメーター

名前 キー 必須 型 説明
To Do リスト
 folderId string

To Do リスト
期日
 DateTime date-time

YYYY-MM-DD または YYYY-MM-DDThh:mm:ssZ (時刻部分は無視されます)
リマインダーの日時
 DateTime date-time

YYYY-MM-DDThh:mm:ssZ (UTC 形式)
開始日
 DateTime date-time

YYYY-MM-DD または YYYY-MM-DDThh:mm:ssZ (時刻部分は無視されます)
重要度
 Importance string

低、標準、高。
情報カテゴリ
 Subject True string

To Do の簡単な説明またはタイトル。
ステータス
 Status string

To Do の状態または進行状況を示します - 未開始、進行中、完了、待機中、遅延。
秘密度
 Sensitivity string

イベントのプライバシーのレベルを示します。
Content Type
 ContentType string

Text=0、HTML=1
コンテンツ
 Content string

テキストまたは HTML コンテンツです。
カテゴリー
 Categories array of string

To Do に関連付けられているカテゴリ名のコレクションです。
アラーム設定済みである
 IsReminderOn boolean

To Do をユーザーに通知するようにアラートが設定されている場合は true。

戻り値

Microsoft To-Do オブジェクト。

本文​​
ToDo

To Do を追加する (V3)

操作 ID:
CreateToDoV3

この操作は、指定した To Do リストの To Do を作成するために使用します。

パラメーター

名前 キー 必須 型 説明
To Do リスト
 folderId True string

To Do リスト
期日
 dateTime date-time

YYYY-MM-DDThh:mm:ss
リマインダーの日時
 dateTime date-time

YYYY-MM-DDThh:mm:ss
重要度
 importance string

低、標準、高。
敬称
 title True string

To Do の簡単な説明またはタイトル。
ステータス
 status string

To Do の状態または進行状況を示します - 未開始、進行中、完了、待機中、遅延。
内容
 content html

項目のコンテンツです。
アラーム設定済みである
 isReminderOn boolean

To Do をユーザーに通知するようにアラートが設定されている場合は true。

戻り値

Microsoft To-Do オブジェクト。

本文​​
ToDo_V2

To Do リストを作成 [DEPRECATED]

操作 ID:
CreateToDoList

このアクションは非推奨になりました。 代わりに、To Do リストを作成 (V2) を使用してください。

この操作は、新しい To Do リストを作成するために使用します。

パラメーター

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

リスト名

戻り値

Microsoft To-Do リスト。

Body
TodoList

To Do リストを作成する (V2)

操作 ID:
CreateToDoListV2

この操作は、新しい To Do リストを作成するために使用します。

パラメーター

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

リスト名

戻り値

Microsoft To-Do リスト。

Body
TodoList_V2

To Do リストを削除する

操作 ID:
DeleteToDoList

この操作は、特定の To Do リストを削除するために使用します。

パラメーター

名前 キー 必須 型 説明
To Do リスト
 folderId True string

To Do リスト

To Do リストを取得 (V2) [DEPRECATED]

操作 ID:
GetToDoV2

このアクションは非推奨になりました。 代わりに、To Do を取得 (V3) を使用してください。

この操作は、指定された ID の To Do を取得するために使用します。

パラメーター

名前 キー 必須 型 説明
To Do リスト
 folderId True string

To Do リスト
To Do タスク
 id True string

To Do タスク

戻り値

Microsoft To-Do オブジェクト。

Body
ToDo

To Do リストを取得 [DEPRECATED]

操作 ID:
GetToDo

このアクションは非推奨になりました。 代わりに、To Do を取得 (V3) を使用してください。

この操作は、指定された ID の To Do を取得するために使用します。

パラメーター

名前 キー 必須 型 説明
To Do ID
 id True string

To Do ID

戻り値

Microsoft To-Do オブジェクト。

本文​​
ToDo

To Do リストを取得 [DEPRECATED]

操作 ID:
GetToDoList

このアクションは非推奨になりました。 代わりに、To Do リストを取得 (V2) を使用してください。

この操作は、特定の To Do リストを取得するために使用します。

パラメーター

名前 キー 必須 型 説明
To Do リスト
 id True string

To Do リスト

戻り値

Microsoft To-Do リスト。

Body
TodoList

To Do リストを取得する (V2)

操作 ID:
GetToDoListV2

この操作は、特定の To Do リストを取得するために使用します。

パラメーター

名前 キー 必須 型 説明
To Do リスト
 folderId True string

To Do リスト

戻り値

Microsoft To-Do リスト。

Body
TodoList_V2

To Do リストを更新する

操作 ID:
UpdateToDoList

この操作は、特定の To Do リストを更新するために使用します。

パラメーター

名前 キー 必須 型 説明
To Do リスト
 folderId True string

To Do リスト
件名
 displayName True string

リスト名

戻り値

Microsoft To-Do リスト。

本文​​
TodoList_V2

すべての To do の項目を一覧表示 [非推奨]

操作 ID:
ListAllToDos

この操作は、すべてのリストからすべての To Do を取得するために使用します。

パラメーター

名前 キー 必須 型 説明
上から順に取得
 $top integer

取得するエントリの合計数 (既定 = 10、最大 = 999)。

戻り値

応答
array of ToDo

すべての To do リストを一覧表示 [DEPRECATED]

操作 ID:
GetAllTodoLists

このアクションは非推奨になりました。 代わりに、To Do リストを一覧表示 (V2) を使用してください。

すべての To Do リストの一覧を返します。

戻り値

返答
array of TodoList

すべての To do リストを一覧表示する (V2)

操作 ID:
GetAllTodoListsV2

すべての To Do リストの一覧を返します。

戻り値

返答
array of TodoList_V2

フォルダー別に To Do を一覧表示 [DEPRECATED]

操作 ID:
ListToDosByFolder

このアクションは非推奨になりました。 代わりに、フォルダーで To Do の項目を一覧表示 (V2) を使用してください。

この操作は、特定のリストからすべての To Do を取得するために使用します。

パラメーター

名前 キー 必須 型 説明
To Do リスト
 folderId True string

To Do リスト
上から順に取得
 $top integer

取得するエントリの合計数 (既定 = 10、最大 = 999)。

戻り値

返答
array of ToDo

フォルダー別に To Do を一覧表示する (V2)

操作 ID:
ListToDosByFolderV2

この操作は、特定のリストからすべての To Do を取得するために使用します。

パラメーター

名前 キー 必須 型 説明
To Do リスト
 folderId True string

To Do リスト
上から順に取得
 $top integer

取得するエントリの合計数 (既定 = 10、最大 = 999)。

戻り値

応答
array of ToDo_V2

トリガー

To Do が更新されたとき [DEPRECATED]

To Do が更新されたときにトリガーされます。
新しい To Do が作成されたとき [DEPRECATED]

新しい To Do 作成されたときにトリガーされます。
特定のフォルダーで新しい To Do が作成されたとき (V2)

特定のフォルダー内に新しい To Do が作成されたときにトリガーします。
特定のフォルダー内に新しい To Do が作成されたとき [DEPRECATED]

このアクションは非推奨になりました。 代わりに、特定のフォルダーで新しい To Do が作成されたとき (V2) を使用してください。

特定のフォルダー内に新しい To Do が作成されたときにトリガーします。
特定のフォルダー内の To Do が更新されたとき (V2)

特定のフォルダー内の To Do が更新されたときにトリガーします。
特定のフォルダー内の To Do が更新されたとき [DEPRECATED]

このアクションは非推奨になりました。 代わりに、特定のフォルダーで新しい To Do が更新されたとき (V2) を使用してください。

特定のフォルダー内の To Do が更新されたときにトリガーします。

To Do が更新されたとき [DEPRECATED]

操作 ID:
OnUpdateToDo

To Do が更新されたときにトリガーされます。

戻り値

Microsoft To-Do オブジェクト。

本文​​
ToDo

新しい To Do が作成されたとき [DEPRECATED]

操作 ID:
OnNewToDo

新しい To Do 作成されたときにトリガーされます。

戻り値

Microsoft To-Do オブジェクト。

本文​​
ToDo

特定のフォルダーで新しい To Do が作成されたとき (V2)

操作 ID:
OnNewToDoInFolderV2

特定のフォルダー内に新しい To Do が作成されたときにトリガーします。

パラメーター

名前 キー 必須 型 説明
To Do リスト
 folderId True string

To Do リスト

戻り値

Microsoft To-Do オブジェクト。

本文​​
ToDo_V2

特定のフォルダー内に新しい To Do が作成されたとき [DEPRECATED]

操作 ID:
OnNewToDoInFolder

このアクションは非推奨になりました。 代わりに、特定のフォルダーで新しい To Do が作成されたとき (V2) を使用してください。

特定のフォルダー内に新しい To Do が作成されたときにトリガーします。

パラメーター

名前 キー 必須 型 説明
To Do リスト
 folderId True string

To Do リスト

戻り値

Microsoft To-Do オブジェクト。

本文​​
ToDo

特定のフォルダー内の To Do が更新されたとき (V2)

操作 ID:
OnUpdateToDoInFolderV2

特定のフォルダー内の To Do が更新されたときにトリガーします。

パラメーター

名前 キー 必須 型 説明
To Do リスト
 folderId True string

To Do リスト

戻り値

Microsoft To-Do オブジェクト。

本文​​
ToDo_V2

特定のフォルダー内の To Do が更新されたとき [DEPRECATED]

操作 ID:
OnUpdateToDoInFolder

このアクションは非推奨になりました。 代わりに、特定のフォルダーで新しい To Do が更新されたとき (V2) を使用してください。

特定のフォルダー内の To Do が更新されたときにトリガーします。

パラメーター

名前 キー 必須 型 説明
To Do リスト
 folderId True string

To Do リスト

戻り値

Microsoft To-Do オブジェクト。

本文​​
ToDo

定義

ToDo

Microsoft To-Do オブジェクト。

名前 パス 型 説明
ID
 id string

To Do の一意識別子です。
作成日時
 createdDateTime date-time

YYYY-MM-DDThh:mm:ssZ (UTC 形式)
変更日時
 lastModifiedDateTime date-time

YYYY-MM-DDThh:mm:ssZ (UTC 形式)
カテゴリ
 categories array of string

To Do に関連付けられているカテゴリ名のコレクションです。
割り当て先
 assignedTo string

To Do を割り当てられた人の名前です。
コンテンツ タイプ
 body.contentType string

Text=0、HTML=1
内容
 body.content string

テキストまたは HTML コンテンツです。
日時
 completedDateTime.dateTime date-time

YYYY-MM-DDThh:mm:ssZ (UTC 形式)
日
 dueDateTime.dateTime date-time

YYYY-MM-DDThh:mm:ssZ (UTC 形式)
重要度
 importance string

低、標準、高。
アラーム オン
 isReminderOn boolean

To Do をユーザーに通知するようにアラートが設定されている場合は true。
担当者
 owner string

To Do の作成者の名前です。
親フォルダーの識別子
 parentFolderId string

親フォルダーの一意識別子です。
日時
 reminderDateTime.dateTime date-time

YYYY-MM-DDThh:mm:ssZ (UTC 形式)
日
 startDateTime.dateTime date-time

YYYY-MM-DDThh:mm:ssZ (UTC 形式)
ステータス
 status string

To Do の状態または進行状況を示します - 未開始、進行中、完了、待機中、遅延。
情報カテゴリ
 subject string

To Do の簡単な説明またはタイトル。

ToDoHtml

Microsoft To-Do オブジェクト。

名前 パス 型 説明
ID
 id string

To Do の一意識別子です。
作成日時
 createdDateTime date-time

YYYY-MM-DDThh:mm:ssZ (UTC 形式)
変更日時
 lastModifiedDateTime date-time

YYYY-MM-DDThh:mm:ssZ (UTC 形式)
カテゴリ
 categories array of string

To Do に関連付けられているカテゴリ名のコレクションです。
割り当て先
 assignedTo string

To Do を割り当てられた人の名前です。
内容
 body.content html

コンテンツ。
日時
 completedDateTime.dateTime date-time

YYYY-MM-DDThh:mm:ssZ (UTC 形式)
日
 dueDateTime.dateTime date-time

YYYY-MM-DDThh:mm:ssZ (UTC 形式)
重要度
 importance string

低、標準、高。
アラーム オン
 isReminderOn boolean

To Do をユーザーに通知するようにアラートが設定されている場合は true。
担当者
 owner string

To Do の作成者の名前です。
親フォルダーの識別子
 parentFolderId string

親フォルダーの一意識別子です。
日時
 reminderDateTime.dateTime date-time

YYYY-MM-DDThh:mm:ssZ (UTC 形式)
日
 startDateTime.dateTime date-time

YYYY-MM-DDThh:mm:ssZ (UTC 形式)
ステータス
 status string

To Do の状態または進行状況を示します - 未開始、進行中、完了、待機中、遅延。
情報カテゴリ
 subject string

To Do の簡単な説明またはタイトル。

TodoList

Microsoft To-Do リスト。

名前 パス 型 説明
ID
 id string

To Do リストの一意識別子。
件名
 name string

To Do リストの名前。
既定
 isDefaultFolder boolean

既定の To Do リストである場合は true。

TodoList_V2

Microsoft To-Do リスト。

名前 パス 型 説明
ID
 id string

To Do リストの一意識別子。
件名
 displayName string

To Do リストの名前。
既知の名前
 wellknownListName string

指定されたリストが既知のリストである場合に、既知のリスト名を示すプロパティ。 可能な値は、none、defaultList、flaggedEmails、unknownFutureValue です。
所有者である
 isOwner boolean

このユーザーが指定したタスク一覧の所有者である場合は True。
共有済みである
 isShared boolean

タスク一覧を他のユーザーと共有している場合は True。

ToDo_V2

Microsoft To-Do オブジェクト。

名前 パス 型 説明
ID
 id string

To Do の一意識別子です。
作成日時
 createdDateTime date-time

YYYY-MM-DDThh:mm:ssZ (UTC 形式)
変更日時
 lastModifiedDateTime date-time

YYYY-MM-DDThh:mm:ssZ (UTC 形式)
コンテンツ タイプ
 body.contentType string

コンテンツ タイプ。 可能な値はテキストと HTML です。
内容
 body.content string

項目のコンテンツです。
変更日時
 bodyLastModifiedDateTime date-time

YYYY-MM-DDThh:mm:ssZ (UTC 形式)
日
 completedDateTime.dateTime date-time

YYYY-MM-DDThh:mm:ss
日
 dueDateTime.dateTime date-time

YYYY-MM-DDThh:mm:ss
重要度
 importance string

低、標準、高。
アラーム オン
 isReminderOn boolean

To Do をユーザーに通知するようにアラートが設定されている場合は true。
日時
 reminderDateTime.dateTime date-time

YYYY-MM-DDThh:mm:ss
ステータス
 status string

To Do の状態または進行状況を示します - 未開始、進行中、完了、待機中、遅延。
敬称
 title string

To Do の簡単な説明またはタイトル。