sharingLink リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

sharingLink リソースは、リンク関連のデータ項目を 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	リンクが関連付けられているアプリケーションです。
type	String	作成されたリンクの種類。
scope	String	このアクセス許可によって表されるリンクの範囲です。 値 anonymous は、すべてのユーザーがリンクを使用できることを示し、organization は同じテナントにサインインしたユーザーのみがリンクを使用できることを示します。
preventsDownload	ブール型	true の場合、ユーザーはこのリンクを使用して Web 上のアイテムを表示することしかできず、アイテムの内容をダウンロードするために使用することはできません。 OneDrive for Businessと SharePoint の場合のみ。
webHtml	String	embed リンクの場合、このプロパティには、Web ページに項目を埋め込む <iframe> 要素の HTML コードが格納されます。
webUrl	String	OneDrive の web サイト上で、項目をブラウザーに開く URL です。

型オプション

次の表は、 type プロパティに使用できる値を定義しています。

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

スコープ オプション

次の表では、 scope プロパティに使用できる値を定義します。

値	説明
anonymous	リンクを知っているすべてのユーザーは、サインインするこなくアクセスできます。 これには、組織外のユーザーも含まれる場合があります。
organization	組織 (テナント) にサインインしているユーザーは、リンクを使用してアクセスできます。 OneDrive for Business および SharePoint の場合のみ使用できます。
existingAccess	このリンクを使用してアイテムにアクセスできるのは、他の方法でアイテムへのアクセス権が既に付与されているユーザーのみです。 OneDrive for Business および SharePoint の場合のみ使用できます。
users	リンクは、特定のユーザーのリストにのみアクセスを許可します。 OneDrive for Business および SharePoint の場合のみ使用できます。