「東雲 忠太郎」の平凡な日常のできごと

SharePoint REST API を使用してファイルを共有するためのエンドポイントは、ShareObject エンドポイントです。以下は、このエンドポイントの使用例です。

http

Copy code

POST https://<site-url>/_api/web/GetFileByServerRelativeUrl('<server-relative-url>')/ShareObject

Content-Type: application/json

Authorization: Bearer <access-token>

{

  "url": "<link-to-share>",

  "role": <role-id>,

  "emailBody": "<email-body>",

  "sendEmail": true|false,

  "emailSubject": "<email-subject>",

  "groupId": <group-id>,

  "useSimplifiedRoles": true|false

}

このリクエストは、指定されたサーバー上の相対URLにあるファイルを共有します。<site-url> は、SharePoint サイトのURL、<server-relative-url> はファイルのサーバー上の相対URL、<access-token> は適切な認証トークンに置き換えます。

リクエストの JSON ボディには、共有するファイルのリンク (url)、ロール (role)、メールの本文 (emailBody)、メールを送信するかどうか (sendEmail)、メールの件名 (emailSubject)、グループの ID (groupId)、単純化されたロールを使用するかどうか (useSimplifiedRoles) などのパラメータが含まれます。

role パラメータは、共有するロールを示す整数値であり、例えば 0 が閲覧者 (Viewer)、1 が編集者 (Editor) を表します。groupId パラメータは、共有するユーザーグループの ID です。

このリクエストの応答は、共有したファイルの詳細を含む JSON オブジェクトが返されることが期待されます。