calendarPermission リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。
予定表が共有または委任されたユーザーのアクセス許可は、Outlookです。
予定表のアクセス許可のリスト、作成、取得、更新、および削除は、予定表の所有者にのみ代わってサポートされます。
共有者または代理人に代わって予定表の予定表のアクセス許可を取得すると、空の予定表アクセス許可コレクションが返されます。
予定表に対して共有者または代理人が設定された後は 、role プロパティのみを更新して、共有者または代理人のアクセス許可を変更できます。 allowedRoles、emailAddress、isInsideOrganization、isRemovable プロパティ は更新 できません。 これらのプロパティを変更するには、対応 する calendarPermission オブジェクトを削除し、別の共有または代理人をクライアントに作成Outlookがあります。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| List | calendarPermission | calendarPermission オブジェクトのコレクションを取得し、指定した予定表が共有または委任されたユーザーの ID と役割を説明します。 |
| Create | calendarPermission | calendarPermission オブジェクトを作成します。 |
| 予定表の取得Permission | calendarPermission | calendarPermission オブジェクトのプロパティとリレーションシップを読み取ります。 |
| 更新する | calendarPermission | calendarPermission オブジェクトを更新します。 |
| 削除 | なし | calendarPermission オブジェクトを削除します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| allowedRoles | calendarRoleType コレクション | 予定表の許可された共有または委任のアクセス許可レベルの一覧。 可能な値は、none、freeBusyRead、limitedRead、read、write、delegateWithoutPrivateEventAccess、delegateWithPrivateEventAccess、custom です。 |
| emailAddress | emailAddress | 予定表にアクセスできる共有者または代理人を表します。 "My Organization" 共有の場合 、address プロパティは null です。 読み取り専用。 |
| id | 文字列 | 予定表が共有されているユーザー (共有または代理人) の一意の識別子。 読み取り専用。 |
| isInsideOrganization | Boolean | True の場合、コンテキスト内のユーザー (共有または代理人) は、予定表の所有者と同じ組織内です。 |
| isRemovable | ブール値 | True 指定した予定表の共有または代理人の一覧からユーザーを削除できる場合は、それ以外の場合 false 。 "自分の組織" ユーザーは、組織内の他のユーザーが指定した予定表に対して持つアクセス許可を決定します。 予定表の共有者として "自分の組織" を削除することはできません。 |
| 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"
}
フィードバック
フィードバックの送信と表示