名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
注意
Outlook tasks API は非推奨となり、2022 年 8 月 20 日にデータの返しを停止しました。 代わりに To Do API を 使用します。
Outlook タスク ( outlookTask オブジェクトのコレクション) を含むフォルダー。
Outlook では、既定のタスク グループ My Tasks には、ユーザーのメールボックス用の既定のタスク フォルダー Tasks が含まれています。
これらの既定のタスク グループまたはフォルダーの名前を変更または削除することはできませんが、新しいタスク グループとフォルダーを作成することはできます。
メソッド
| メソッド | 戻り値の型 | 説明 | |||
|---|---|---|---|---|---|
| Get | outlookTaskFolder | 指定した Outlook タスク フォルダーのプロパティとリレーションシップを取得します。 | |||
| グループ内のタスク フォルダーを作成する | outlookTask | 指定したタスク フォルダーに Outlook タスクを作成します。 | |||
| グループ内のタスク フォルダーを一覧表示する | outlookTask コレクション | 指定したフォルダー内のすべての Outlook タスクを取得します。 | |||
| Update | outlookTaskFolder | Outlook タスク フォルダーの書き込み可能なプロパティを更新します。 | |||
| Delete | なし | 指定した Outlook タスク フォルダーを削除します。 | |||
| 完全に削除 | なし | Outlook タスクを完全に削除し、ユーザーのメールボックスの [回復可能なアイテム] フォルダーの [消去] フォルダーに配置します。 | ](../api/outlooktaskfolder-permanentdelete.md) | なし | Outlook タスク フォルダーを完全に削除し、そのアイテムをユーザーのメールボックスから削除します。 |
| 拡張プロパティ | |||||
| 単一値のプロパティを作成する | outlookTaskFolder | 新しいまたは既存の Outlook タスク フォルダーに 1 つ以上の単一値拡張プロパティを作成します。 | |||
| 単一値のプロパティを取得する | outlookTaskFolder |
$expandまたは$filterを使用して、単一値の拡張プロパティを含む Outlook タスク フォルダーを取得します。 |
|||
| 複数値のプロパティを作成する | outlookTaskFolder | 新しいまたは既存の Outlook タスク フォルダーに 1 つ以上の複数値拡張プロパティを作成します。 | |||
| 複数値のプロパティを取得する | outlookTaskFolder |
$expandを使用して、複数値の拡張プロパティを含む Outlook タスク フォルダーを取得します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| changeKey | String | タスク フォルダーのバージョン。 |
| id | String | ユーザーのメールボックス内で一意のタスク フォルダーの識別子。 読み取り専用です。 |
| isDefaultFolder | ブール型 | フォルダーが既定のタスク フォルダーである場合は true。 |
| name | String | タスク フォルダーの名前。 |
| parentGroupKey | Guid | タスク フォルダーの親グループの一意の GUID 識別子。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| multiValueExtendedProperties | multiValueLegacyExtendedProperty コレクション | タスク フォルダーに対して定義されている複数値の拡張プロパティのコレクション。 読み取り専用です。 Null 許容型。 |
| singleValueExtendedProperties | singleValueLegacyExtendedProperty コレクション | タスク フォルダーに対して定義された単一値の拡張プロパティのコレクション。 読み取り専用です。 Null 許容型。 |
| tasks | outlookTask コレクション | 対象タスク フォルダー内のタスク。 読み取り専用です。 Null 許容型。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"changeKey": "String",
"id": "String (identifier)",
"isDefaultFolder": true,
"name": "String",
"parentGroupKey": "Guid"
}