---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# WSD シフト API

# WSD シフト API {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分

ワークプレイスサービスデリバリ (WSD) シフト API は、指定された日時のシフトタイムスパンを返すエンドポイントを提供します。
この API にアクセスするには、発信者に sn_wsd_core.workplace_user ロールが必要であり、ワークプレイス安全管理 (sn_wsd_core) プラグインとワークプレイス予約管理 (sn_wsd_rsv) プラグインがアクティブ化されている必要があります。

この API は `sn_wsd_rsv` 名前空間で実行されます。

ワークプレイス予約管理の詳細については、「[ワークプレイス予約管理](https://www.servicenow.com/docs/access?context=workplace-rsv-mgmt-feat&version=australia&pubname=australia-employee-service-management&ft:locale=en-US)」を参照してください。

## WSD シフト:GET /api/sn_wsd_rsv/wsd_shift/{shift_id}/timespan {#ariaid-title2}

指定された日時とシフトのシフトタイムスパンを返します。
<br />

### URL 形式

バージョニングされた URL: /api/sn_wsd_rsv/{api_version}/wsd_shift/{shift_id}/timespan

デフォルト URL: /api/sn_wsd_rsv/wsd_shift/{shift_id}/timespan  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

{#wsd_shift-GET-timespan__entry__2}{#wsd_shift-GET-timespan__version-not_optional-RESTAPI}

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| shift_id | タイムスパンを取得するシフトのSys_id。 シフトベースの予約の詳細については、「 [シフトベースの予約を有効にする」](https://www.servicenow.com/docs/access?context=wsd-reservation-setup&version=australia&pubname=australia-employee-service-management&ft:locale=en-US)を参照してください。 データタイプ：文字列 テーブル:シフト \[sn_wsd_core_shift\] |
[表 : 1. パスパラメーター]

{#wsd_shift-GET-timespan__entry__8}

| 名前 | 説明 |
|-|-|
| attempt_earlier_start | 指定された開始値がシフトのタイムスパン内にある場合に早期開始時間を設定するかどうかを示すフラグ。 有効な値： * true:指定されたシフトに start パラメーターで指定された日付/時刻が含まれている場合は、指定された開始日時をタイムスパンの開始として返します。 * false:関連するレコードで定義されているシフトタイムスパンを返します。 データタイプ：ブーリアン デフォルト値：false |
| 開始 | 必須です。シフトの開始日時が戻るまでの時間スパン。 形式:UTC - yyyy-mm-ddThh:mm:ssZ (例: 2022-05-23T08:00:00Z) |
| タイムゾーン | ECT や PST など、シフトのタイムスパンを認定するときに使用するタイムゾーン。また、このタイムゾーンのシフトタイムスパンを返します。 形式:UTC データタイプ：文字列 デフォルト:ユーザーのタイムゾーン |
[表 : 2. クエリパラメーター]

{#wsd_shift-GET-timespan__entry__16}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 3. 要求本文のパラメーター]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#wsd_shift-GET-timespan__entry__20}{#wsd_shift-GET-timespan__accept-reserv-entry}

| ヘッダー | 説明 |
|-|-|
| 承認 | 要求本文のデータ形式。サポートされているタイプ: application/json、 application/xml 、または text/xml。 デフォルト： application/json |
[表 : 4. 要求ヘッダー]

{#wsd_shift-GET-timespan__entry__24}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 5. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#wsd_shift-GET-timespan__entry__28}{#wsd_shift-GET-timespan__entry-200-status-code}{#wsd_shift-GET-timespan__entry-401-status-code}{#wsd_shift-GET-timespan__entry-404-status-code}{#wsd_shift-GET-timespan__entry-500-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 6. ステータスコード]

### 応答本文のパラメーター

{#wsd_shift-GET-timespan__entry__38}

| 名前 | 説明 |
|-|-|
| result | 検索条件に一致したシフトタイムスパンに関する詳細。 データタイプ: オブジェクト "result":{ "end": "String", "start": "String" } |
| result.end | 指定されたタイムゾーンでのシフトタイムスパンの終了日時。 形式:UTC:yyyy-mm-ddThh:mm:ssZ (例: 2022-05-23T08:00:00Z) データタイプ：文字列 |
| result.start | 指定されたタイムゾーンでのシフトタイムスパンの開始日時。 形式:UTC:yyyy-mm-ddThh:mm:ssZ (例: 2022-05-23T08:00:00Z) データタイプ：文字列 |
[ ]

### cURL 要求

次のコード例は、シフトのタイムスパンを取得する方法を示しています。

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/wsd_shift/e5d23acfdb42a01097acc9003996193a/timespan?attempt_earlier_start=true&start=2022-05-23T08:00:00Z&timezone=ECT" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

結果を返します:

    {
      "result": {
        "start": "2022-05-23T08:00:00Z",
        "end": "2022-05-23T15:00:00Z"
      }
    }