名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
sharingLink リソースは、リンク関連のデータ項目を 1 つの構造にグループ化します。
アクセス許可リソースに null 以外の sharingLink ファセットがある場合、そのアクセス許可は共有リンクを表します (ユーザーまたはグループに付与されるアクセス許可とは対照)。
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| 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 では使用できません。 |
スコープ オプション
次の表に、 スコープ プロパティで指定できる値を定義します。
| 値 | 説明 |
|---|---|
anonymous |
リンクを知っているすべてのユーザーは、サインインするこなくアクセスできます。 これには、組織外のユーザーも含まれる場合があります。 |
organization |
組織 (テナント) にサインインしているユーザーは、リンクを使用してアクセスできます。 OneDrive for Business および SharePoint の場合のみ使用できます。 |
existingAccess |
このリンクを使用して、他の方法でアイテムへのアクセスを既に許可されているユーザーのみがアイテムにアクセスできます。 OneDrive for Business および SharePoint の場合のみ使用できます。 |
users |
リンクは、特定のユーザーのリストにのみアクセスを許可します。 OneDrive for Business および SharePoint の場合のみ使用できます。 |
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"application": { "@odata.type": "microsoft.graph.identity" },
"preventsDownload": false,
"type": "view | edit | embed",
"scope": "anonymous | organization",
"webHtml": "string",
"webUrl": "url"
}