outlookTask リソースの種類（非推奨）

名前空間: microsoft.graph

重要

Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。

注意事項

Outlook タスク API は、2022 年 8 月 20 日に廃止され、データを返さなくなります。 新しい To Do API をご使用ください。 詳細については、「パブリックプレビューでの To Do API 」を参照してください。

作業アイテムを追跡することができる Outlook アイテム。

タスクを使用すると、開始日時、期限日時、実際の完了日時、進行状況や状態、定期的かどうか、通知が必要かどうかを追跡できます。

outlookTask リソースの日付関連プロパティには次が含まれます。

• completedDateTime
• createdDateTime
• dueDateTime
• lastModifiedDateTime
• reminderDateTime
• startDateTime

既定では、POST、GET、PATCH、および complete 操作は、REST 応答の日付関連プロパティを UTC で返します。Prefer: outlook.timezoneヘッダーを使用して、応答内のすべての日付関連プロパティを UTC 以外のタイム ゾーンで表すことができます。 次の例では、対応する応答の日付関連プロパティが EST で返されています。

Prefer: outlook.timezone="Eastern Standard Time"

メソッド

メソッド	戻り値の型	説明
outlookTask を取得する	outlookTask	ユーザーのメールボックスにある Outlook タスクのプロパティとリレーションシップを取得します。
更新する	outlookTask	Outlook タスクの書き込み可能なプロパティを変更します。
削除する	なし	ユーザーのメールボックス内の指定されたタスクを削除します。
完了する	outlookTask コレクション	completedDateTime プロパティを現在の日付に設定し、status プロパティを completed に設定する Outlook タスクを完了します。
添付ファイル
添付ファイルを一覧表示する	attachment コレクション	Outlook タスクのすべての添付ファイルを取得します。
添付ファイルを追加する	attachment	タスクへの添付としてファイル、アイテム (メッセージ、イベント、連絡先)、またはファイルへのリンクを追加します。
拡張プロパティ
単一値の拡張プロパティを作成する	outlookTask	新規または既存の Outlook タスクに、1 つ以上の単一値の拡張プロパティを作成します。
単一値の拡張プロパティを持つタスクを取得する	outlookTask	$expand または $filter を使用して、単一値の拡張プロパティを含む Outlook タスクを取得します。
複数値の拡張プロパティを作成する	outlookTask	新規または既存の Outlook タスクに、1 つ以上の複数値の拡張プロパティを作成します。
複数値の拡張プロパティを持つタスクの取得	outlookTask	$expand を使用して、複数値の拡張プロパティを含む Outlook タスクを取得します。

プロパティ

プロパティ	種類	説明
assignedTo	String	Outlook でタスクが割り当てられているユーザーの名前。読み取り専用。
body	itemBody	通常はタスクに関する情報を含むタスク本体。HTML 型のみがサポートされていることに注意してください。
categories	String コレクション	タスクに関連付けられたカテゴリ。 各カテゴリは、ユーザーが定義した outlookCategory の displayName プロパティに対応しています。
changeKey	String	タスクのバージョン。
completedDateTime	dateTimeTimeZone	タスクが終了した日付 (指定のタイム ゾーン)。
createdDateTime	DateTimeOffset	タスクが作成された日時。 既定では、UTC 時間です。 要求ヘッダーでカスタム タイム ゾーンを使用できます。 プロパティの値は、ISO 8601 形式を使用します。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
dueDateTime	dateTimeTimeZone	タスクが終了する予定の日時 (指定のタイム ゾーン)。
hasAttachments	Boolean	タスクに添付ファイルが含まれている場合、true に設定します。
id	String	タスクの一意識別子。 By default, this value changes when the item is moved from one container (such as a folder or calendar) to another. To change this behavior, use the Prefer: IdType="ImmutableId" header. See Get immutable identifiers for Outlook resources for more information. 読み取り専用です。
importance	重要度	イベントの重要度。 可能な値は、low、normal、high です。
isReminderOn	Boolean	ユーザーにタスクを通知するアラートを設定する場合は、true に設定します。
lastModifiedDateTime	DateTimeOffset	タスクが最後に変更された日時。 既定では、UTC 時間です。 要求ヘッダーでカスタム タイム ゾーンを使用できます。 プロパティの値は、ISO 8601 形式を使って表され、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
owner	String	タスクを作成したユーザーの名前。
parentFolderId	String	タスクの親フォルダーの一意の識別子。
recurrence	patternedRecurrence	タスクの繰り返しパターン。
reminderDateTime	dateTimeTimeZone	タスクのアラーム通知を行う日時。
sensitivity	sensitivity	タスクのプライバシーのレベルを示します。 使用可能な値は、normal、personal、private、confidential です。
startDateTime	dateTimeTimeZone	タスクを開始する日付 (指定のタイム ゾーン)。
status	taskStatus	タスクの状態または進行状況を示します。 可能な値は、notStarted、inProgress、completed、waitingOnOthers、deferred です。
subject	String	タスクのタイトルまたは簡単な説明。

リレーションシップ

リレーションシップ	型	説明
attachments	attachment コレクション	タスクの fileAttachment、itemAttachment、referenceAttachment の各添付ファイルのコレクション。 読み取り専用です。 Null 許容型。
multiValueExtendedProperties	multiValueLegacyExtendedProperty コレクション	タスクに対して定義された複数値拡張プロパティのコレクション。読み取りり専用。Null 許容。
singleValueExtendedProperties	singleValueLegacyExtendedProperty コレクション	タスクに対して定義された単一値の拡張プロパティのコレクション。読み取り専用。Null 許容。

JSON 表記

以下は、リソースの JSON 表記です。

{
  "assignedTo": "String",
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "categories": ["String"],
  "changeKey": "String",
  "completedDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "createdDateTime": "String (timestamp)",
  "dueDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "hasAttachments": true,
  "id": "String (identifier)",
  "importance": "string",
  "isReminderOn": true,
  "lastModifiedDateTime": "String (timestamp)",
  "owner": "String",
  "parentFolderId": "String",
  "recurrence": {"@odata.type": "microsoft.graph.patternedRecurrence"},
  "reminderDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "sensitivity": "string",
  "startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "status": "string",
  "subject": "String"
}