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]

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

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

パラメーター

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

To Do リスト

To Do タスク
id True string

To Do タスク

To Do の更新 [DEPRECATED]

このアクションは非推奨になりました。 代わりに、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)

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

パラメーター

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

To Do リスト

To Do タスク
id True string

To Do タスク

To Do を取得する (V3)

この操作は、指定された 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)

この操作は、特定の 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]

このアクションは非推奨になりました。 代わりに、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]

このアクションは非推奨になりました。 代わりに、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)

この操作は、指定した 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]

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

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

パラメーター

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

リスト名

戻り値

Microsoft To-Do リスト。

Body
TodoList

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

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

パラメーター

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

リスト名

戻り値

Microsoft To-Do リスト。

To Do リストを削除する

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

パラメーター

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

To Do リスト

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

このアクションは非推奨になりました。 代わりに、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]

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

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

パラメーター

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

To Do ID

戻り値

Microsoft To-Do オブジェクト。

本文​​
ToDo

To Do リストを取得 [DEPRECATED]

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

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

パラメーター

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

To Do リスト

戻り値

Microsoft To-Do リスト。

Body
TodoList

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

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

パラメーター

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

To Do リスト

戻り値

Microsoft To-Do リスト。

To Do リストを更新する

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

パラメーター

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

To Do リスト

件名
displayName True string

リスト名

戻り値

Microsoft To-Do リスト。

本文​​
TodoList_V2

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

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

パラメーター

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

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

戻り値

応答
array of ToDo

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

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

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

戻り値

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

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

戻り値

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

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

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

パラメーター

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

To Do リスト

上から順に取得
$top integer

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

戻り値

返答
array of ToDo

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

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

パラメーター

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

To Do リスト

上から順に取得
$top integer

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

戻り値

トリガー

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]

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

戻り値

Microsoft To-Do オブジェクト。

本文​​
ToDo

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

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

戻り値

Microsoft To-Do オブジェクト。

本文​​
ToDo

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

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

パラメーター

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

To Do リスト

戻り値

Microsoft To-Do オブジェクト。

本文​​
ToDo_V2

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

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

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

パラメーター

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

To Do リスト

戻り値

Microsoft To-Do オブジェクト。

本文​​
ToDo

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

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

パラメーター

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

To Do リスト

戻り値

Microsoft To-Do オブジェクト。

本文​​
ToDo_V2

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

このアクションは非推奨になりました。 代わりに、特定のフォルダーで新しい 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 の簡単な説明またはタイトル。