スケジュール: 共有schedule: share

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported.

スケジュールの時間範囲をスケジュールのメンバーと共有します。Share a schedule time range with schedule members. 指定されたチームメンバーによって表示可能なスケジュールの指定された時間範囲で、 Shifttimeoffの各アイテムのコレクションを作成します (従業員とマネージャーを含む)。Make the collections of shift and timeOff items in the specified time range of the schedule viewable by the specified team members, including employees and managers. スケジュール内の各シフトおよびtimeoffインスタンスでは、アイテムの下書きバージョンと共有バージョンがサポートされています。Each shift and timeOff instance in a schedule supports a draft version and a shared version of the item. 下書きバージョンは、管理者のみが表示でき、共有バージョンは従業員とマネージャーに表示されます。The draft version is viewable by only managers, and the shared version is viewable by employees and managers. 指定した時間範囲の各シフトtimeoffのインスタンスについては、共有アクションは下書きバージョンの共有バージョンを更新するので、マネージャーに加えて、アイテムに関する最新情報を表示することもできます。For each shift and timeOff instance in the specified time range, the share action updates the shared version from the draft version, so that in addition to managers, employees can also view the most current information about the item. Notifyteamパラメーターは、アイテムを表示できる従業員をさらに指定します。The notifyTeam parameter further specifies which employees can view the item.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) Group.ReadWrite.AllGroup.ReadWrite.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされていません。Not supported.
アプリケーションApplication サポートされていません。Not supported.

: この API は、管理者のアクセス許可をサポートします。Note: This API supports admin permissions. グローバル管理者は、所属していないグループにアクセスできます。Global admins can access groups that they are not a member of.

HTTP 要求HTTP request

POST /teams/{teamId}/schedule/share

要求ヘッダーRequest headers

ヘッダーHeader Value
AuthorizationAuthorization ベアラー {トークン}。必須。Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

要求本文Request body

要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。In the request body, provide a JSON object with the following parameters.

パラメーターParameter Type 説明Description
notifyTeamnotifyTeam Boolean チーム全体がこのアクションの通知を表示するかどうかを指定します。または、共有されていた交代が割り当てられた従業員のみを取得します。Indicates whether the entire team should get a visible notification of this action, or only employees that have a shift assigned to them that was shared. 必須です。Required.
startDateTimestartDateTime DateTimeOffset スケジュールの開始時刻を開始する時刻。The start time to share shifts on the schedule from. 必須です。Required.
endDateTimeendDateTime DateTimeOffset スケジュールによる移動を終了するまでの終了時刻。The end time to share shifts on the schedule until.

応答Response

成功した場合、このメソッドは 204 No Content 応答コードを返します。応答本文には何も返されません。If successful, this method returns a 204 No Content response code. It does not return anything in the response body.

Example

要求Request

要求の例を次に示します。The following is an example of the request.

POST https://graph.microsoft.com/beta/teams/{teamId}/schedule/share
Content-type: application/json

{
  "notifyTeam": true,
  "startDateTime": "2018-10-08T00:00:00.000Z",
  "endDateTime": "2018-10-15T00:00:00.000Z"
}

応答Response

応答の例を次に示します。The following is an example of the response.

HTTP/1.1 204 No content