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 の場合のみ使用できます。