次の方法で共有


sharingLink リソースの種類

名前空間: microsoft.graph

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

アクセス許可リソースに null 以外の sharingLink ファセットがある場合、アクセス許可は共有リンクを表します (個人またはグループに付与されるアクセス許可とは対照的)。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

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

プロパティ

プロパティ 説明
application identity リンクが関連付けられているアプリケーションです。
preventsDownload ブール型 true の場合、ユーザーはこのリンクを使用して Web 上のアイテムを表示することしかできず、アイテムの内容をダウンロードするために使用することはできません。 OneDrive for Businessと SharePoint の場合のみ。
scope String このアクセス許可によって表されるリンクの範囲です。 値 anonymous は、すべてのユーザーがリンクを使用できることを示し、organization は同じテナントにサインインしたユーザーのみがリンクを使用できることを示します。
type String 作成されたリンクの種類。
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 の場合のみ使用できます。
existingAccess このリンクを使用してアイテムにアクセスできるのは、他の方法でアイテムへのアクセス権が既に付与されているユーザーのみです。 OneDrive for Business および SharePoint の場合のみ使用できます。
users リンクは、特定のユーザーのリストにのみアクセスを許可します。 OneDrive for Business および SharePoint の場合のみ使用できます。