calendarPermission リソースの種類

名前空間: microsoft.graph

予定表が共有または委任されたユーザーのアクセス許可は、Outlookです。

予定表のアクセス許可のリスト、作成、取得、更新、および削除は、予定表の所有者にのみ代わってサポートされます。

共有者または代理人に代わって予定表の予定表のアクセス許可を取得すると、空の予定表アクセス許可コレクションが返されます。

予定表に対して共有者または代理人が設定された後は 、role プロパティのみを更新して、共有者または代理人のアクセス許可を変更できます。 allowedRoles、emailAddress、isInsideOrganization、isRemovable プロパティ は更新 できません。 これらのプロパティを変更するには、対応 する calendarPermission オブジェクトを削除し、別の共有または代理人をクライアントに作成Outlookがあります。

メソッド

メソッド 戻り値の型 説明
List calendarPermission calendarPermission オブジェクトのコレクションを取得し、指定した予定表が共有または委任されたユーザーの ID と役割を説明します。
Create calendarPermission calendarPermission オブジェクトを作成します。
予定表の取得Permission calendarPermission calendarPermission オブジェクトのプロパティとリレーションシップを読み取ります。
Update calendarPermission calendarPermission オブジェクトを更新します。
削除 なし calendarPermission オブジェクトを削除します。

プロパティ

プロパティ 種類 説明
allowedRoles calendarRoleType コレクション 予定表の許可された共有または委任のアクセス許可レベルの一覧。 可能な値は、nonefreeBusyReadlimitedReadreadwritedelegateWithoutPrivateEventAccessdelegateWithPrivateEventAccesscustom です。
emailAddress emailAddress 予定表にアクセスできる共有者または代理人を表します。 "My Organization" 共有の場合 、address プロパティは null です。 読み取り専用。
id String 予定表が共有されているユーザー (共有または代理人) の一意の識別子。 読み取り専用。
isInsideOrganization ブール型 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"
}