calendarPermission リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Outlook クライアントで予定表が共有または委任されているユーザーのアクセス許可。
予定表のアクセス許可の一覧表示、作成、取得、更新、削除は、予定表の所有者に代わってサポートされます。
共有受信者または代理人に代わって予定表の予定表のアクセス許可を取得すると、空の予定表アクセス許可コレクションが返されます。
共有受信者または代理人が予定表に設定されたら、ロール プロパティのみを更新して、共有受信者または代理人のアクセス許可を変更できます。 allowedRoles、emailAddress、isInsideOrganization、または isRemovable プロパティを更新することはできません。 これらのプロパティを変更するには、対応する calendarPermission オブジェクトを削除し、Outlook クライアントで別の共有受信者または代理人を作成する必要があります。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| List | calendarPermission | 指定した予定表が共有または委任されたユーザーの ID とロールを記述する calendarPermission オブジェクトのコレクションを取得します。 |
| Create | calendarPermission | calendarPermission オブジェクトをCreateします。 |
| Get | calendarPermission | calendarPermission オブジェクトのプロパティとリレーションシップを読み取ります。 |
| Update | calendarPermission | calendarPermission オブジェクトを更新します。 |
| Delete | なし | calendarPermission オブジェクトを削除します。 |
プロパティ
| プロパティ | 種類 | 説明 |
|---|---|---|
| allowedRoles | calendarRoleType コレクション | 予定表の許可された共有または委任のアクセス許可レベルの一覧。 可能な値は、none、freeBusyRead、limitedRead、read、write、delegateWithoutPrivateEventAccess、delegateWithPrivateEventAccess、custom です。 |
| emailAddress | emailAddress | 予定表にアクセスできる共有受信者または代理人を表します。 "My Organization" 共有受信者の場合、 address プロパティは null です。 読み取り専用です。 |
| id | String | 予定表が共有されているユーザー (共有受信者または代理人) の一意の識別子。 読み取り専用です。 |
| isInsideOrganization | ブール型 | True を指定すると、コンテキスト内のユーザー (共有受信者または代理人) が予定表の所有者と同じorganization内にあります。 |
| isRemovable | ブール値 |
True 指定した予定表の受信者または代理人の一覧からユーザーを削除できる場合は 。 false それ以外の場合は 。 "マイ organization" ユーザーは、organization内の他のユーザーが指定した予定表に対して持つアクセス許可を決定します。 予定表の受信者として "マイ organization" を削除することはできません。 |
| role | calendarRoleType | 予定表共有の受信者または代理人の現在のアクセス許可レベル。 |
calendarRoleType 値
| メンバー | 説明 |
|---|---|
| none | 予定表はユーザーと共有されません。 |
| freeBusyRead | ユーザーは、予定表で所有者の空き時間情報の状態を表示できる共有受信者です。 |
| limitedRead | ユーザーは、空き時間情報の状態と、予定表のイベントのタイトルと場所を表示できる共有受信者です。 |
| read | ユーザーは、所有者のプライベート イベントを除き、予定表でイベントのすべての詳細を表示できる共有受信者です。 |
| write | ユーザーは共有受信者であり、すべての詳細 (プライベート イベントを除く) を表示し、予定表のイベントを編集できます。 |
| delegateWithoutPrivateEventAccess | ユーザーは、書き込みアクセス権を持つが、予定表で所有者のプライベート イベントの情報を表示できない代理人です。 |
| delegateWithPrivateEventAccess | ユーザーは、書き込みアクセス権を持ち、予定表で所有者のプライベート イベントの情報を表示できる代理人です。 |
| カスタム | ユーザーは、予定表に対するカスタム アクセス許可を持っています。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"allowedRoles": ["string"],
"emailAddress": {"@odata.type": "microsoft.graph.emailAddress"},
"id": "String (identifier)",
"isInsideOrganization": "boolean",
"isRemovable": "boolean",
"role": "string"
}