名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
ユーザーのメールボックス内の個人用配布リストを表します。 配布リストを使用すると、ユーザーは電子メール受信者をグループ化できるため、各アドレスを個別に入力しなくても、すべてのメンバーに一度にメッセージを送信できます。
outlookItem から継承します。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List | distributionList コレクション | ユーザーのメールボックス内の distributionList オブジェクトの一覧を取得します。 |
| Create | distributionList | ユーザーのメールボックスに新しい distributionList を作成します。 |
| Get | distributionList | 配布リスト オブジェクトのプロパティと関係を読み取ります。 |
| Update | distributionList | distributionList オブジェクトのプロパティを更新します。 |
| Delete | なし | distributionList オブジェクトを削除します。 |
| メンバーの追加 | distributionList | distributionList にメンバーを追加します。 |
| メンバーを削除する | distributionList | distributionList からメンバーを削除します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| categories | String collection | 配布リストに関連付けられているカテゴリ。 outlookItem から継承されます。 |
| changeKey | String |
If-Match ヘッダーを使用したオプティミスティック同時実行制御に使用されるバージョン識別子。 読み取り専用です。
outlookItem から継承されます。 |
| createdDateTime | DateTimeOffset | 配布リストが作成された日時。 タイムスタンプの種類は、ISO 8601 形式を使用して、常に UTC 形式の日付と時刻情報を表します。 たとえば、2024 年 1 月 1 日の午前 0 時 UTC は 2024-01-01T00:00:00Z です。 読み取り専用です。
outlookItem から継承されます。 |
| displayName | 文字列 | 配布リストの表示名。 |
| id | 文字列 | 配布リストの一意識別子。 読み取り専用です。 outlookItem から継承されます。 |
| lastModifiedDateTime | DateTimeOffset | 配布リストが最後に変更された日時。 タイムスタンプの種類は、ISO 8601 形式を使用して、常に UTC 形式の日付と時刻情報を表します。 たとえば、2024 年 1 月 1 日の午前 0 時 UTC は 2024-01-01T00:00:00Z です。 読み取り専用です。
outlookItem から継承されます。 |
| notes | String | 配布リストに関する注意事項。 |
| personIdentifier | 文字列 | メールボックス内の配布リストの一意識別子。 読み取り専用です。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| members | distributionListMember コレクション | 配布リストのメンバー。 既定では返されません。 $expand=members を使用して含めます。 読み取り専用です。 |
| singleValueExtendedProperties | singleValueLegacyExtendedProperty コレクション | 配布リストに定義されている単一値の拡張プロパティのコレクション。 読み取り専用です。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.distributionList",
"id": "string (identifier)",
"createdDateTime": "string (timestamp)",
"lastModifiedDateTime": "string (timestamp)",
"changeKey": "string",
"categories": [
"string"
],
"displayName": "string",
"notes": "string",
"personIdentifier": "string"
}