SharingLink リソースの種類

SharingLink リソースは、リンク関連のデータ項目を 1 つの構造にグループ化します。

Permission リソースが非 null の sharingLink ファセットを持つ場合、アクセス許可は (ユーザーやグループに与えられているアクセス許可ではなく) 共有リンクを表します。

JSON 表記

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

{
  "application": { "@odata.type": "microsoft.graph.identity" },
  "type": "view | edit | embed",
  "scope": "anonymous | organization",
  "webHtml": "string",
  "webUrl": "url"
}

プロパティ

プロパティ	型	説明
application	identity	リンクが関連付けられているアプリケーションです。
type	String	作成されたリンクの種類。
scope	String	このアクセス許可によって表されるリンクの範囲です。 値 anonymous は、すべてのユーザーがリンクを使用できることを示し、organization は同じテナントにサインインしたユーザーのみがリンクを使用できることを示します。
webHtml	String	embed リンクの場合、このプロパティには、Web ページに項目を埋め込む <iframe> 要素の HTML コードが格納されます。
webUrl	String	OneDrive の web サイト上で、項目をブラウザーに開く URL です。

型オプション

この表は、type プロパティの可能な値を定義します。

値	ロール	説明
view	read	読み取り専用のアクセスを許可する、閲覧専用の共有リンクです。
edit	write	読み取り/書き込みのアクセスを許可する、編集共有リンクです。
embed	read	ホスト Web ページにコンテンツを埋め込むために使用できる、表示専用共有リンクです。 埋め込みリンクは、OneDrive for Business または SharePoint では使用できません。

スコープ オプション

値	説明
anonymous	リンクを知っているすべてのユーザーは、サインインするこなくアクセスできます。 これには、組織外のユーザーも含まれる場合があります。
organization	組織 (テナント) にサインインしているユーザーは、リンクを使用してアクセスできます。 OneDrive for Business および SharePoint の場合のみ使用できます。