WSD Search API
ワークプレイスサービスデリバリ (WSD) 検索 API は、予約可能、予約可能モジュール、利用可能なシフトなど、利用可能な場所と職場アイテムを検索するためのエンドポイントを提供します。
この API にアクセスするには、問い合わせユーザーに sn_wsd_core.workplace_user ロールが必要であり、Workplace Safety Management (sn_wsd_core) と Workplace Reservation Management (sn_wsd_rsv) プラグインを有効にする必要があります。
この API は sn_wsd_rsv 名前空間で実行されます。
ワークプレイス予約管理の詳細については、「ワークプレイス予約管理」を参照してください。
WSD Search - GET /api/sn_wsd_rsv/search/availability
指定された可能な予約が、指定された時間に利用可能かどうかをチェックします。
URL 形式
バージョニングされている URL:/api/sn_wsd_rsv/{api_version}/search/availability
デフォルトの URL:/api/sn_wsd_rsv/search/availability
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ:文字列 |
| 名前 | 説明 |
|---|---|
| end | 必須です。利用可能な予約可能モジュールを検索するために使用する終了時間。この値は、start パラメーターで指定された値よりも後でなければなりません。 データタイプ:文字列 形式:UTC または現地時間 (yyyy-mm-dd hh:mm:ss) |
| include_reservations_within_days | 1 日の各予約可能項目について、応答で利用可能な時間のすべての空きスロットを返すかどうかを示すフラグ。 有効な値:
データタイプ:ブーリアン デフォルト値:false |
| reservable_ids | 必須。使用可否を評価する予約可能 sys_id のカンマ区切りリスト。 データタイプ:文字列 テーブル:職場の場所 [sn_wsd_core_workplace_location] |
| reservation_ids | 既存の予約sys_idsのカンマ区切りリスト。関連する予約を編集する場合は、このパラメーターを渡します。 対応する予約可能項目のこれらの sys_id に対してブロックされた時間は、利用可能として扱われます。 データタイプ:文字列 デフォルト:なし テーブル:職場予約 [sn_wsd_rsv_reservation] |
| reservable_module | 必須です。検索に含める予約可能なモジュールの sys_id。予約可能モジュールは、類似タイプの職場アイテムをグループ化します。 データタイプ:文字列 テーブル:予約可能なモジュール [sn_wsd_rsv_reservable_module] |
| schedule_view_obj | 返されるスケジュールビューの詳細。1 日を超える予約に対して 24 時間の可用性データが必要な場合は、このオブジェクトを渡します。返される結果には、指定された日付の利用可能な時間と予約のみが含まれます。 この機能を正しく動作させるには、パラメーター ignore_same_day_validation と include_reservations_within_days を true に設定する必要があります。 データタイプ: オブジェクト |
| schedule_view_obj.schedule_view_date | 予約可用性の返却を開始する日付。この日付は、 schedule_view_obj.timezone パラメーターで指定されたタイムゾーンである必要があります。 データタイプ:文字列 形式:YYYY-MM-DD |
| schedule_view_obj.timezone | 返される予約可用性データを決定するために使用する建物のタイムゾーン。例:米国/太平洋。 データタイプ:文字列 |
| シフト | 指定された予約可能なモジュールがシフトに基づいている場合は必須です。 予約に関連付けるシフトの sys_id。このパラメーターが渡される場合、 end パラメーターは必要ありません。 シフトベースの予約の詳細については、「 シフトベースの予約を有効にする」を参照してください。 データタイプ:文字列 テーブル:シフト [sn_wsd_core_shift] |
| start | 必須です。利用可能な予約可能モジュールを検索するために使用する開始時間。この値は、end パラメーターで指定された値よりも前でなければなりません。 データタイプ:文字列 形式:UTC または現地時間 (yyyy-mm-dd hh:mm:ss) |
| 名前 | 説明 |
|---|---|
| なし |
ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 要求本文のデータ形式。サポートされるタイプ:application/json、application/xml、または text/xml。 デフォルト: application/json |
| ヘッダー | 説明 |
|---|---|
| なし |
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 200 | 成功。要求が正常に処理されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 |
| 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 |
応答本文のパラメーター
| 名前 | 説明 |
|---|---|
| result | 指定された時間に利用可能なすべての可能な予約のリスト。 データタイプ:オブジェクトのアレイ |
| result.availableTimes | 関連する予約可能項目が使用可能な日時のリスト。 データタイプ:アレイ |
| result.building | 可能な予約に関連付けられている建物の詳細。 データタイプ:オブジェクト |
| result.building.display_value | 建物の表示値。 データタイプ:文字列 |
| result.building.name | 建物の名前。 データタイプ:文字列 |
| result.building.sys_id | 関連付けられた建物レコードの sys_id。 データタイプ:文字列 |
| result.campus | 可能な予約に関連付けられている敷地の詳細。 データタイプ:オブジェクト |
| result.campus.display_value | 予約可能項目が存在する敷地の表示数 (イーストベイなど)。 データタイプ:文字列 |
| result.campus.name | 敷地の名前。 データタイプ:文字列 |
| result.campus.sys_id | 関連レコードの sys_id。 データタイプ:文字列 テーブル:敷地 [sn_wsd_core_campus] |
| result.email | 関連する可能な予約のメールアドレス。 データタイプ:文字列 |
| result.floor | 予約に関連付けられているフロアの詳細。 データタイプ:オブジェクト |
| result.floor.display_value | 予約可能項目が存在するフロアの階数を表示します (12 など)。 データタイプ:文字列 |
| result.floor.name | 予約可能項目が存在するフロアの名前。 データタイプ:文字列 |
| result.floor.sys_id | 関連レコードの sys_id。 データタイプ:文字列 テーブル:フロア [sn_wsd_core_floor] |
| result.is_available | 予約可能項目が使用可能かどうかを示すフラグ。 有効な値:
データタイプ:ブール |
| result.name | 予約可能項目の名前。 データタイプ:文字列 |
| result.reservations | 関連付けられている予約の詳細。 データタイプ:オブジェクトのアレイ |
| result.reservations.configuration_item | 予約に対応する構成アイテム。 データタイプ:文字列 テーブル:構成アイテム [cmdb_ci] |
| result.reservations.end | 予約の終了日時。 データタイプ:文字列 形式:UTC:yyyy-mm-ddThh:mm:ssZ (2021-02-05T18:00:00Z など) |
| result.reservations.is_collided | 予約が検索の開始時間と終了時間と競合するかどうかを示すフラグ。 これは、関連する予約可能な場所が指定された検索タイムスパンで既に予約されていることを示します。 可能な値:
データタイプ:ブール |
| result.reservations.location | 予約の場所の詳細。 データタイプ:オブジェクト |
| result.reservations.location.location | 関連付けられた場所レコードの sys_id。 データタイプ:文字列 テーブル:職場の場所 [sn_wsd_core_workplace_location] |
| result.reservations.location.timezone | 場所に関連付けられたタイムゾーンに関する詳細。 データタイプ:オブジェクト |
| result.reservations.location.timezone.displayValue | この場所が属するタイムゾーンの表示値。 データタイプ:文字列 |
| result.reservations.location.timezone.value | この場所が属するタイムゾーンの内部値。 データタイプ:文字列 |
| result.reservations.number | 予約番号。 データタイプ:文字列 |
| result.reservations.requested_for | 代理で予約が要求されたユーザーの詳細。 データタイプ:オブジェクト |
| result.reservations.requested_for.name | 予約が要求されたユーザーの名前。 データタイプ:文字列 |
| result.reservations.requested_for.sys_id | 予約が要求されているユーザーの sys_id。 データタイプ:文字列 テーブル: ユーザー [sys_user] |
| result.reservations.reservation_purpose | 予約の目的の詳細。 データタイプ:オブジェクト |
| result.reservations.reservation_purpose.display_value | 会社の会議などの予約の目的の表示値。 データタイプ:文字列 |
| result.reservations.reservation_purpose.value | company_meeting などの予約の目的の内部値。 データタイプ:文字列 |
| result.reservations.start | 予約の開始日時。 データタイプ:文字列 形式:UTC:yyyy-mm-ddThh:mm:ssZ (2021-02-05T18:00:00Z など) |
| result.reservations.state | 場所の予約のステータスの詳細。 データタイプ:オブジェクト |
| result.reservations.state.display_value | 予約の現在のステータスの表示値 (確定済みなど)。 データタイプ:文字列 |
| result.reservations.state.value | 予約の現在のステータスの内部値 (2 など)。 データタイプ:文字列 |
| result.reservations.subject | 予約の件名。 データタイプ:文字列 |
| result.reservations.sys_id | 必須です。 予約レコードの sys_id。 データタイプ:文字列 テーブル:職場予約 [sn_wsd_rsv_reservation] |
cURL 要求
次のコード例は、このエンドポイントを呼び出す方法を示しています。注:読みやすくするために、クエリパラメーターに改行が追加されました。
curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/availability?
reservable_module=5db44502dbb650106c731dcd13961937&
start=2023-10-12T11:00:00Z&
end=2023-10-15T12:00:00Z&
reservable_ids=adb35f1977220110b3d7be377b5a99fc&
reservation_ids=undefined&
shift=undefined&
schedule_view_obj={"schedule_view_date":"2023-10-12","timezone":"Europe/Paris"}&
timezone=Europe/Paris&
include_reservations_within_days=true&
ignore_same_day_validation=true&
include_unavailable_items=true" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
返される結果:
{
"result": [
{
"sys_id": "fe1f744edb7650106c731dcd139619ca",
"email": null,
"name": "Aspen",
"is_available": true,
"availableTimes": [
[
"2022-04-23 07:00:00",
"2022-04-23 08:30:00"
],
[
"2022-04-23 09:30:00",
"2022-04-23 23:00:00"
],
[
"2022-04-24 00:00:00",
"2022-04-24 06:59:59"
]
],
"floor": {
"sys_id": "2f554296dbba10106c731dcd139619ed",
"display_value": "Floor 2",
"name": "Floor 2"
},
"building": {
"sys_id": "94e264cedb3650106c731dcd13961919",
"display_value": "CAL-B1",
"name": "CAL-B1"
},
"campus": {
"sys_id": "82b2a0cedb3650106c731dcd139619e9",
"display_value": "California Campus",
"name": "California Campus"
},
"reservations": [
{
"sys_id": "5fe65830874bc9106342b846dabb352b",
"number": "WRES0001001",
"location": {
"location": "fe1f744edb7650106c731dcd139619ca",
"timezone": {
"value": "US/Pacific",
"displayValue": "US/Pacific"
}
},
"configuration_item": null,
"start": "2022-04-23T08:30:00Z",
"end": "2022-04-23T09:30:00Z",
"subject": null,
"reservation_purpose": {
"value": "meeting",
"display_value": "Meeting"
},
"state": {
"value": "confirmed",
"display_value": "Confirmed"
},
"is_collided": false,
"requested_for": {
"sys_id": "2de07e1887cb89106342b846dabb35fe",
"name": "Workplace User"
}
}
]
}
]
}
WSD Search - GET /api/sn_wsd_rsv/search/best_match
指定された検索条件に基づいて、最も一致する予約可能なアイテムを検索します。
URL 形式
バージョニングされている URL:/api/sn_wsd_rsv/{api_version}/search/best_match
デフォルトの URL:/api/sn_wsd_rsv/search/best_match
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ:文字列 |
| 名前 | 説明 |
|---|---|
| best_match_count | 返される最も一致した可能な予約の数。 データタイプ:数値 デフォルト値:1 |
| end | 必須です。利用可能な予約可能モジュールを検索するために使用する終了時間。この値は、start パラメーターで指定された値よりも後でなければなりません。 データタイプ:文字列 形式:UTC または現地時間 (yyyy-mm-dd hh:mm:ss) |
| include_reservable_purposes | 返される結果で各予約可能項目の職場の場所を予約する目的を返すかどうかを示すフラグ。 有効な値:
データタイプ:ブーリアン デフォルト値:false テーブル:予約可能な目的 [sn_wsd_rsv_reservable_purpose] |
| include_reservations_within_days | 1 日の各予約可能項目について、応答で利用可能な時間のすべての空きスロットを返すかどうかを示すフラグ。 有効な値:
データタイプ:ブーリアン デフォルト値:false |
| include_standard_services | 応答で標準サービス情報を返すかどうかを示すフラグ。この情報は、標準サービス [sn_wsd_rsv_standard_service] テーブルにあります。 標準サービスでは、ホワイトボード、追加のモニター、および類似サービスなど、予約時に予約可能な職場アイテムで利用可能な基本的なプロビジョニングについて説明します。標準サービスの詳細については、「 標準サービス」を参照してください。 有効な値:
データタイプ:ブーリアン デフォルト値:false |
| q | 必須です。返された検索結果をフィルタリングするために使用するエンコードされたクエリ。このクエリ内では、建物の sys_id を指定する必要があり、floor、area、capacity、standard services、reservable_purposes などのパラメーターを指定できます。 数値である capacity を除いて、渡すパラメーターはすべて sys_id である必要があります。 例: この情報は、次のテーブルにあります。
データタイプ:文字列 |
| reservable_module | 必須です。検索に含める予約可能なモジュールの sys_id。予約可能モジュールは、類似タイプの職場アイテムをグループ化します。 データタイプ:文字列 テーブル:予約可能なモジュール [sn_wsd_rsv_reservable_module] |
| start | 必須です。利用可能な予約可能モジュールを検索するために使用する開始時間。この値は、end パラメーターで指定された値よりも前でなければなりません。 データタイプ:文字列 形式:UTC または現地時間 (yyyy-mm-dd hh:mm:ss) |
| time_slot | 最も一致する可能な予約の検索を試みているタイムスロットレコードの sys_id。 データタイプ:文字列 デフォルト:なし テーブル:タイムスロット [sn_wsd_rsv_time_slot] |
| タイムゾーン | 優先タイムゾーン (ヨーロッパ/アムステルダムなど)。 データタイプ:文字列 デフォルト:なし |
| ヘッダー | 説明 |
|---|---|
| なし |
ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml。 デフォルト: application/json |
| ヘッダー | 説明 |
|---|---|
| なし |
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 200 | 成功。要求が正常に処理されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 |
| 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 |
応答本文のパラメーター
| 名前 | 説明 |
|---|---|
| result | 最も一致する可能な予約の結果を返します。 データタイプ:オブジェクト |
| result.floorsOfSelectedBuilding | 可能な予約があるフロアの詳細。 データタイプ:オブジェクトのアレイ |
| result.floorsOfSelectedBuilding.display_value | 予約可能項目が存在するフロアの階数を表示します (12 など)。 データタイプ:文字列 |
| result.floorsOfSelectedBuilding.external_id | フロアの外部識別子。 データタイプ:文字列 |
| result.floorsOfSelectedBuilding.name | 予約可能項目が存在するフロアの名前。 データタイプ:文字列 |
| result.floorsOfSelectedBuilding.sys_id | 関連レコードの sys_id。 データタイプ:文字列 テーブル:フロア [sn_wsd_core_floor] |
| result.hasMore | 返される結果にさらに予約可能項目が含まれているかどうかを示すフラグ。 可能な値:
データタイプ:ブール |
| result.nextItemIndex | フェッチする次の予約可能レコードのインデックス。予約可能レコードをページネーションするときに、この値を使用します。 データタイプ:数値 |
| result.reservableContainers | selection_type フィールドが container に設定されている予約可能モジュールに対してのみ返されます。コンテナーは、デスクのグループなど、類似のアイテムをグループ化したものです。 データタイプ:オブジェクトのアレイ |
| result.reservableContainers.building | 予約可能コンテナーに関連付けられている建物の詳細。 データタイプ:オブジェクト |
| result.reservableContainers.building.display_value | 建物の表示値。 データタイプ:文字列 |
| result.reservableContainers.building.name | 建物の名前。 データタイプ:文字列 |
| result.reservableContainers.building.sys_id | 関連付けられた建物レコードの sys_id。 データタイプ:文字列 |
| result.reservableContainers.campus | 予約可能項目がある敷地の詳細。
データタイプ: オブジェクト
テーブル:敷地 [sn_wsd_core_campus] |
| result.reservableContainers.campus.display_value | 予約可能項目が存在する敷地の表示数 (イーストベイなど)。 データタイプ:文字列 |
| result.reservableContainers.campus.name | 敷地の名前。 データタイプ:文字列 |
| result.reservableContainers.campus.sys_id | 関連レコードの sys_id。 データタイプ:文字列 テーブル:敷地 [sn_wsd_core_campus] |
| result.reservableContainers.capacity | 予約可能項目の参加者の最大人数。 データタイプ:数値 |
| result.reservableContainers.display_value | 予約可能コンテナーの表示値。 データタイプ:文字列 |
| result.reservableContainers.floor | 予約可能コンテナーに関連付けられているフロアの詳細。 データタイプ:オブジェクト |
| result.reservableContainers.floor.display_value | 予約可能項目が存在するフロアの階数を表示します (12 など)。 データタイプ:文字列 |
| result.reservableContainers.floor.name | 予約可能項目が存在するフロアの名前。 データタイプ:文字列 |
| result.reservableContainers.floor.sys_id | 関連レコードの sys_id。 データタイプ:文字列 テーブル:フロア [sn_wsd_core_floor] |
| result.reservableContainers.image | 関連する予約可能項目のレイアウトを表す画像の詳細。 データタイプ: オブジェクト テーブル:画像 [db_image] |
| result.reservableContainers.image.link | この予約可能項目のレイアウトを表す画像へのリンク。 データタイプ:文字列 テーブル:画像 [db_image] |
| result.reservableContainers.image.sys_id | 関連する画像レコードの sys_id。 データタイプ:文字列 |
| result.reservableContainers.sys_id | 関連コンテナーレコードの sys_id。 データタイプ:文字列 テーブル:これが存在するテーブルは、任意のコンテナタイプに対して構成できます。デフォルトでは、エリア [sn_wsd_core_Area] テーブルにあります。 |
| result.reservableUnits | 指定された検索条件に一致する予約可能ユニットに関する詳細。予約可能ユニットは、机や椅子などの単一の予約可能アイテムです。 データタイプ:オブジェクトのアレイ |
| result.reservableUnits.area | 予約可能モジュールがあるエリアの詳細。 データタイプ: オブジェクト テーブル:エリア [sn_wsd_core_area] |
| result.reservableUnits.area.display_value | 予約可能モジュールエリアの表示値。 データタイプ:文字列 |
| result.reservableUnits.area.sys_id | 予約可能項目に関連するエリアレコードの sys_id。 データタイプ:文字列 |
| result.reservableUnits.availableTimes | 関連する予約可能項目が使用可能な日時のリスト。 データタイプ:アレイ |
| result.reservableUnits.building | 予約可能項目がある建物の詳細。 データタイプ: オブジェクト テーブル:建物 [sn_wsd_core_building] |
| result.reservableUnits.building.display_value | 建物の表示値。 データタイプ:文字列 |
| result.reservableUnits.building.sys_id | 関連付けられた建物レコードの sys_id。 データタイプ:文字列 |
| result.reservableUnits.campus | 予約可能項目がある敷地の詳細。
データタイプ: オブジェクト
テーブル:敷地 [sn_wsd_core_campus] |
| result.reservableUnits.campus.display_value | 予約可能項目が存在する敷地の表示数 (イーストベイなど)。 データタイプ:文字列 |
| result.reservableUnits.campus.sys_id | 関連レコードの sys_id。 データタイプ:文字列 テーブル:敷地 [sn_wsd_core_campus] |
| result.reservableUnits.capacity | 予約可能項目の参加者の最大人数。 データタイプ:数値 |
| result.reservableUnits.defaultPrivacyValue | 予約可能項目のデフォルトのプライバシー設定を示すフラグ。 これらのプライバシー設定の詳細については、「 場所のプライバシー設定と影響」を参照してください。 可能な値:
データタイプ:ブーリアン |
| result.reservableUnits.description | 予約可能項目の簡単な説明。 データタイプ:文字列 |
| result.reservableUnits.email | 予約可能項目のメールアドレス。 データタイプ:文字列 |
| result.reservableUnits.external_id | CMS でマッピングされたスペースを同期するために使用される予約可能項目の外部 ID。この値は、この場所に関連付けられたマップがある場合にのみ入力されます。 データタイプ:文字列 |
| result.reservableUnits.floor | 可能な予約があるフロアの詳細。
データタイプ: オブジェクト
テーブル:フロア [sn_wsd_core_floor] |
| result.reservableUnits.floor.display_value | 予約可能項目が存在するフロアの階数を表示します (12 など)。 データタイプ:文字列 |
| result.reservableUnits.floor.sys_id | 関連レコードの sys_id。 データタイプ:文字列 テーブル:フロア [sn_wsd_core_floor] |
| result.reservableUnits.image | 関連する予約可能項目のレイアウトを表す画像の詳細。 データタイプ: オブジェクト テーブル:画像 [db_image] |
| result.reservableUnits.image.link | この予約可能項目のレイアウトを表す画像へのリンク。 データタイプ:文字列 テーブル:画像 [db_image] |
| result.reservableUnits.image.sys_id | 関連する画像レコードの sys_id。 データタイプ:文字列 |
| result.reservableUnits.includedInResult | 現在の予約可能項目が返される結果に含まれているかどうかを示すフラグ。 有効な値:
データタイプ:ブール |
| result.reservableUnits.is_available | 予約可能項目が使用可能かどうかを示すフラグ。 有効な値:
データタイプ:ブール |
| result.reservableUnits.is_favorite | 予約可能項目が関連するユーザーのお気に入りの 1 つとしてフラグ付けされているかどうかを示すフラグ。 有効な値:
データタイプ:ブール |
| result.reservableUnits.is_reservable | この予約を予約できるかどうかを示すフラグ。 注: include_unavailable_items クエリパラメーターが true に設定されている場合は、利用できない場所も返されます。この場合、場所が既に予約されている場合、is_available パラメーターは false ですが、is_reservable は true です。 有効な値:
データタイプ:ブール |
| result.reservableUnits.is_reserved | 予約可能項目が既に予約されているかどうかを示すフラグ。 有効な値:
データタイプ:ブール |
| result.reservableUnits.is_selected | 予約可能項目が既に予約されているかどうかを示すフラグ。 有効な値:
データタイプ:ブール |
| result.reservableUnits.location_type | 予約可能項目の場所のタイプに関する詳細 (workplace/desk、cafe、gym など)。 データタイプ: オブジェクト テーブル:職場の場所 [sn_wsd_core_workplace_location] |
| result.reservableUnits.location_type.display_value | 場所タイプの表示値。 データタイプ:文字列 |
| result.reservableUnits.location_type.name | 地下やストレージなどの場所タイプの名前。表示値と同じです。 データタイプ:文字列 |
| result.reservableUnits.location_type.sys_id | 関連レコードの sys_id。 データタイプ:文字列 テーブル:スペースタイプ [sn_wsd_core_space_type] |
| result.reservableUnits.name | 予約可能項目の名前。 データタイプ:文字列 |
| result.reservableUnits.number | 予約可能項目の一意の識別子。この値は、sys_id よりも人間が判読しやすい値です。 データタイプ:文字列 |
| result.reservableUnits.order | 予約可能項目の注文番号。 データタイプ:数値 |
| result.reservableUnits.require_approval | 予約可能項目の予約に承認が必要かどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン |
| result.reservableUnits.requires_check_in | 予約でユーザーのチェックインが必要かどうかを示すフラグ。 有効な値:
データタイプ:ブーリアン |
| result.reservableUnits.reservable_purposes | 関連する予約可能項目の予約の目的に関する詳細。 データタイプ:オブジェクトのアレイ |
| result.reservableUnits.reservable_purposes.name | 予約可能項目の名前。 データタイプ:文字列 |
| result.reservableUnits.reservable_purposes.short_description | 予約可能項目の簡単な説明。 データタイプ:文字列 |
| result.reservableUnits.reservable_purposes.sys_id | 予約可能な目的レコードの sys_id。 データタイプ:文字列 テーブル:予約可能な目的 [sn_wsd_rsv_reservable_purpose] |
| result.reservableUnits.reservations | 予約可能項目に関連付けられている予約に関する詳細。include_reservations_within_days クエリパラメーターが true で、reservation_ids パラメーターに予約 ID が含まれている場合にのみ入力されます。これは、この予約可能項目の予約が既に存在することを意味します。 データタイプ:オブジェクトのアレイ |
| result.reservableUnits.reservations.configuration_item | 予約に対応する構成アイテム。 データタイプ:文字列 テーブル:構成アイテム [cmdb_ci] |
| result.reservableUnits.reservations.end | 予約の終了日時。 データタイプ:文字列 形式:UTC:yyyy-mm-ddThh:mm:ssZ (2021-02-05T18:00:00Z など) |
| result.reservableUnits.reservations.is_collided | 予約が検索の開始時間と終了時間と競合するかどうかを示すフラグ。 これは、関連する予約可能な場所が指定された検索タイムスパンで既に予約されていることを示します。 可能な値:
データタイプ:ブール |
| result.reservableUnits.reservations.location | 予約の場所の詳細。 データタイプ:オブジェクト |
| result.reservableUnits.reservations.location.location | 関連付けられた場所レコードの sys_id。 データタイプ:文字列 テーブル:職場の場所 [sn_wsd_core_workplace_location] |
| result.reservableUnits.reservations.location.timezone | 場所に関連付けられたタイムゾーンに関する詳細。 データタイプ:オブジェクト |
| result.reservableUnits.reservations.location.timezone.displayValue | この場所が属するタイムゾーンの表示値。 データタイプ:文字列 |
| result.reservableUnits.reservations.location.timezone.value | この場所が属するタイムゾーンの内部値。 データタイプ:文字列 |
| result.reservableUnits.reservations.number | 予約可能項目の一意の識別子。この値は、sys_id よりも人間が判読しやすい値です。 データタイプ:文字列 |
| result.reservableUnits.reservations.requested_for | 代理で予約が要求されたユーザーの詳細。 データタイプ:オブジェクト |
| result.reservableUnits.reservations.requested_for.name | 予約が要求されたユーザーの名前。 データタイプ:文字列 |
| result.reservableUnits.reservations.requested_for.sys_id | 予約が要求されているユーザーの sys_id。 データタイプ:文字列 テーブル: ユーザー [sys_user] |
| result.reservableUnits.reservations.reservation_purpose | 予約の目的の詳細。 データタイプ:オブジェクト |
| result.reservableUnits.reservations.reservation_purpose.display_value | 会社の会議などの予約の目的の表示値。 データタイプ:文字列 |
| result.reservableUnits.reservations.reservation_purpose.value | company_meeting などの予約の目的の内部値。 データタイプ:文字列 |
| result.reservableUnits.reservations.start | 予約の開始日時。 データタイプ:文字列 形式:UTC:yyyy-mm-ddThh:mm:ssZ (2021-02-05T18:00:00Z など) |
| result.reservableUnits.reservations.state | 場所の予約のステータスの詳細。 データタイプ:オブジェクト |
| result.reservableUnits.reservations.state.display_value | 予約の現在のステータスの表示値 (確定済みなど)。 データタイプ:文字列 |
| result.reservableUnits.reservations.state.value | 予約の現在のステータスの内部値 (2 など)。 データタイプ:文字列 |
| result.reservableUnits.reservations.subject | 予約の件名。 データタイプ:文字列 |
| result.reservableUnits.reservations.sys_id | 必須です。 予約レコードの sys_id。 データタイプ:文字列 テーブル:職場予約 [sn_wsd_rsv_reservation] |
| result.reservableUnits.reservable_quantity | 関連する予約可能項目を同じ時間に予約できる最大回数。この値は、エリアに近隣スペースをアサインするときに使用されます。 データタイプ:整数 |
| result.reservableUnits.showPrivacyOption | 従業員が関連する予約可能項目のプライバシー設定を上書きできるかどうかを示すフラグ。 これらのプライバシー設定の詳細については、「 場所のプライバシー設定と影響」を参照してください。 有効な値:
データタイプ:ブーリアン |
| result.reservableUnits.site | 予約可能項目が存在するサイトの詳細。 データタイプ: オブジェクト テーブル:サイト [sn_wsd_core_site] |
| result.reservableUnits.site.display_value | サイトの表示値。 データタイプ:文字列 |
| result.reservableUnits.site.sys_id | 関連付けられたサイトレコードのSys_id。 データタイプ:文字列 テーブル:サイト [sn_wsd_core_site] |
| result.reservableUnits.standard_services | フリップチャート、プロジェクタースクリーン、ホワイトボードとマーカーなどの関連する標準サービス。 データタイプ:オブジェクトのアレイ
|
| result.reservableUnits.standard_services.font_awesome_icon | 標準サービスに関連付けられたサムネイルアイコンの名前。 データタイプ:文字列 |
| result.reservableUnits.standard_services.name | 標準サービスに関連付けられたサムネイルアイコンの名前。 データタイプ:文字列 |
| result.reservableUnits.standard_services.short_description | 標準サービスの簡単な説明。 データタイプ:文字列 |
| result.reservableUnits.standard_services.sys_id | 標準サービスレコードの sys_id。 データタイプ:文字列 テーブル:標準サービス [sn_wsd_rsv_standard_service] |
| result.reservableUnits.sys_id | 予約可能レコードの sys_id。 データタイプ:文字列 テーブル:職場の場所 [sn_wsd_core_workplace_location] |
| result.reservableUnits.tableName | 予約可能項目レコードが存在するテーブルの名前。 データタイプ:文字列 |
| result.reservableUnits.title | 予約可能項目のタイトル。 データタイプ:文字列 |
cURL 要求
次のコード例は、このエンドポイントを呼び出す方法を示しています。
curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/best_match?q=building%3D9e0364cedb3650106c731dcd1396192b&start=2023-01-04T07%3A00%3A00Z&time_slot=d5331cf2dbb5f01038e42b24ca961906&end=2023-01-04T17%3A00%3A00Z&best_match_count=1&reservable_module=2b636b7e1b4e60103523ff751a4bcbe2&timezone=Europe%2FAmsterdam" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
返される結果:
{
"result": {
"hasMore": false,
"reservableUnits": [
{
"sys_id": "fe1f744edb7650106c731dcd139619ca",
"external_id": null,
"email": null,
"name": "Aspen",
"title": "Aspen",
"description": "A room with large windows, dark leather seats and a large wooden table.",
"image": {
"sys_id": "41c74902dbb650106c731dcd13961944",
"link": "41c74902dbb650106c731dcd13961944.iix"
},
"number": "ROOM0000903",
"site": {
"sys_id": "628eec06db7650106c731dcd139619dd",
"display_value": "North America"
},
"campus": {
"sys_id": "82b2a0cedb3650106c731dcd139619e9",
"display_value": "California Campus"
},
"building": {
"sys_id": "94e264cedb3650106c731dcd13961919",
"display_value": "CAL-B1"
},
"floor": {
"sys_id": "2f554296dbba10106c731dcd139619ed",
"display_value": "Floor 2"
},
"area": null,
"capacity": "16",
"reservable_quantity": null,
"location_type": {
"sys_id": "20713b83eb512010b89bfdfc9c522899",
"display_value": "Room",
"name": "Room"
},
"order": null,
"requires_check_in": null,
"is_reservable": "1",
"tableName": "sn_wsd_core_room",
"require_approval": false,
"standard_services": [
{
"sys_id": "abd0c18edb7650106c731dcd13961965",
"name": "Projector screen",
"short_description": "Connect laptop to screen (HDMI and DVI)",
"font_awesome_icon": "fa-caret-square-o-right"
}
],
"reservable_purposes": [
{
"sys_id": "18f4c3cd1ba4e01051848489cc4bcb82",
"name": "Board room",
"short_description": null
}
],
"is_available": true,
"reservations": [
{
"sys_id": "5fe65830874bc9106342b846dabb352b",
"number": "WRES0001001",
"location": {
"location": "fe1f744edb7650106c731dcd139619ca",
"timezone": {
"value": "US/Pacific",
"displayValue": "US/Pacific"
}
},
"configuration_item": null,
"start": "2022-04-23T08:30:00Z",
"end": "2022-04-23T09:30:00Z",
"subject": null,
"reservation_purpose": {
"value": "meeting",
"display_value": "Meeting"
},
"state": {
"value": "confirmed",
"display_value": "Confirmed"
},
"is_collided": false,
"requested_for": {
"sys_id": "2de07e1887cb89106342b846dabb35fe",
"name": "Workplace User"
}
},
{
"sys_id": "af075c30874bc9106342b846dabb3572",
"number": "WRES0001002",
"location": {
"location": "fe1f744edb7650106c731dcd139619ca",
"timezone": {
"value": "US/Pacific",
"displayValue": "US/Pacific"
}
},
"configuration_item": null,
"start": "2022-04-23T23:00:00Z",
"end": "2022-04-24T00:00:00Z",
"subject": null,
"reservation_purpose": {
"value": "meeting",
"display_value": "Meeting"
},
"state": {
"value": "confirmed",
"display_value": "Confirmed"
},
"is_collided": false,
"requested_for": {
"sys_id": "2de07e1887cb89106342b846dabb35fe",
"name": "Workplace User"
}
}
],
"availableTimes": [
[
"2022-04-23 07:00:00",
"2022-04-23 08:30:00"
],
[
"2022-04-23 09:30:00",
"2022-04-23 23:00:00"
],
[
"2022-04-24 00:00:00",
"2022-04-24 06:59:59"
]
],
"is_favorite": false
}
],
"reservableContainers": [],
"nextItemIndex": -1,
"floorsOfSelectedBuilding": [
{
"sys_id": "2f554296dbba10106c731dcd139619ed",
"display_value": "Floor 2",
"external_id": null,
"name": "Floor 2"
}
]
}
}{
"result": {
"hasMore": false,
"reservableUnits": [
{
"sys_id": "32f2a98adb7210106c731dcd13961972",
"external_id": null,
"wsd_email": null,
"name": "B1-03-04",
"title": "B1-03-04",
"description": "Desk reserved for the Team-C. After 10am, free to reserve for everyone.",
"image": {
"sys_id": "57b42dcadb7210106c731dcd13961945",
"link": "57b42dcadb7210106c731dcd13961945.iix"
},
"number": "SPCE0009018",
"site": {
"sys_id": "b17220cedb3650106c731dcd1396197a",
"display_value": "Western Europe"
},
"campus": {
"sys_id": "44d2e0cedb3650106c731dcd13961988",
"display_value": "Amsterdam Campus"
},
"building": {
"sys_id": "9e0364cedb3650106c731dcd1396192b",
"display_value": "AMS-B1"
},
"floor": {
"sys_id": "5373a8cedb3650106c731dcd1396198a",
"display_value": "Floor 3"
},
"area": {
"sys_id": "410ff04edb7650106c731dcd13961973",
"display_value": "Desks C1"
},
"capacity": "1",
"reservable_quantity": null,
"location_type": {
"sys_id": "5f017383eb512010b89bfdfc9c5228c8",
"display_value": "Workspace/Desk",
"name": "Workspace/Desk"
},
"order": null,
"requires_check_in": null,
"is_reservable": "1",
"tableName": "sn_wsd_core_space",
"require_approval": false,
"is_available": true,
"reservations": [],
"availableTimes": [
[
"2023-01-04 07:00:00",
"2023-01-04 17:00:00"
]
],
"showPrivacyOption": false,
"defaultPrivacyValue": false,
"container": {
"sys_id": "410ff04edb7650106c731dcd13961973",
"display_value": "Desks C1",
"floor": {
"sys_id": "5373a8cedb3650106c731dcd1396198a",
"display_value": "Floor 3",
"name": "Floor 3"
},
"building": {
"sys_id": "9e0364cedb3650106c731dcd1396192b",
"display_value": "AMS-B1",
"name": "AMS-B1"
},
"campus": {
"sys_id": "44d2e0cedb3650106c731dcd13961988",
"display_value": "Amsterdam Campus",
"name": "Amsterdam Campus"
},
"capacity": 6,
"image": {
"sys_id": "d52c27b21b8e60103523ff751a4bcb49",
"link": "d52c27b21b8e60103523ff751a4bcb49.iix"
}
},
"includedInResult": true,
"is_favorite": true
}
],
"reservableContainers": [
{
"sys_id": "410ff04edb7650106c731dcd13961973",
"display_value": "Desks C1",
"floor": {
"sys_id": "5373a8cedb3650106c731dcd1396198a",
"display_value": "Floor 3",
"name": "Floor 3"
},
"building": {
"sys_id": "9e0364cedb3650106c731dcd1396192b",
"display_value": "AMS-B1",
"name": "AMS-B1"
},
"campus": {
"sys_id": "44d2e0cedb3650106c731dcd13961988",
"display_value": "Amsterdam Campus",
"name": "Amsterdam Campus"
},
"capacity": 6,
"image": {
"sys_id": "d52c27b21b8e60103523ff751a4bcb49",
"link": "d52c27b21b8e60103523ff751a4bcb49.iix"
}
}
],
"nextItemIndex": -1,
"floorsOfSelectedBuilding": [
{
"sys_id": "5373a8cedb3650106c731dcd1396198a",
"display_value": "Floor 3",
"external_id": null,
"name": "Floor 3"
}
]
}
WSD 検索:GET /api/sn_wsd_rsv/search/overlapping_reservation
渡されたパラメーターに基づいて、重複予約が存在するかどうかを判断します。
URL 形式
バージョニングされた URL: /api/sn_wsd_rsv/{api_version}/search/overlapping_reservation
デフォルト URL: /api/sn_wsd_rsv/search/overlapping_reservation
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ:文字列 |
| 名前 | 説明 |
|---|---|
| 終了 | 必須。予約の重複を確認するために使用する終了時間。 データタイプ:文字列 形式:YYYY-MM-DDTHH:MM:SSZ |
| recurring_pattern | 予約の繰り返し発生するパターンの詳細。 データタイプ: オブジェクト |
| recurring_pattern.duration | 確認する時間の長さ。 データタイプ:数値 単位:秒 |
| recurring_pattern.options | 繰り返し予約に関連付けられたオプションの詳細。 データタイプ: オブジェクト |
| recurring_pattern.options.count | パターンが繰り返される回数。 データタイプ:数値 |
| recurring_pattern.options.daysOfWeek | 重複をチェックする曜日。 有効な値:
たとえば、火曜日、木曜日、金曜日を指定するには、245 (区切り文字なし) を渡します。 データタイプ:文字列 |
| recurring_pattern.options.every | チェックするパターン繰り返し間隔。たとえば、この値が 2 の場合、 repeats パラメーターの選択に基づいて、1 日ごとや隔週など、繰り返しパターンがチェックされます。 データタイプ:数値 |
| recurring_pattern.options.repeats | 予約重複チェックの繰り返しパターン。 可能な値:(大文字と小文字を区別)
データタイプ:文字列 |
| reservable_id | 重複予約をチェックする予約可能モジュールのSys_id。 データタイプ:文字列 テーブル:予約可能なモジュール [sn_wsd_rsv_reservable_module] |
| reservation_id | 重複をチェックする予約のSys_id。この値は、複数/グループの親の編集フローで必要です。 データタイプ:文字列 テーブル:職場予約 [sn_wsd_rsv_reservation] |
| shift_info_object | 重複をチェックするシフトの詳細。 シフトベースの予約の詳細については、「 シフトベースの予約を有効にする」を参照してください。 データタイプ: オブジェクト |
| shift_info_object.applyToShift | 予約可能モジュールに対してシフトベースの予約が有効かどうかを示すフラグ。 有効な値:
データタイプ:ブーリアン |
| shift_info_object.shift | 予約に関連付けるシフトの sys_id。このパラメーターが渡される場合、 end パラメーターは必要ありません。 データタイプ:文字列 テーブル:シフト [sn_wsd_core_shift] |
| shift_info_object.timezone | 重複をチェックするシフトのタイムゾーン。 データタイプ:文字列 |
| start | 必須。予約の重複をチェックするために使用する開始時間。 データタイプ:文字列 形式:YYY-MM-DDTHH:MM:SSZ |
| user_id | 必須。予約の重複を確認するユーザーのSys_id。 データタイプ:文字列 テーブル: ユーザー [sys_user] |
| 名前 | 説明 |
|---|---|
| なし |
ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml。 デフォルト: application/json |
| ヘッダー | 説明 |
|---|---|
| なし |
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 |
| 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 |
応答本文のパラメーター (JSON または XML)
| 名前 | 説明 |
|---|---|
| 結果 | 重複チェックの結果の詳細。 データタイプ: オブジェクト |
| results.isOverlapped | 重複予約が存在するかどうかを示すフラグ。 有効な値:
データタイプ:ブーリアン |
| results.reservableId | グループ予約の場合、重複が発生する予約可能なsys_id。 データタイプ:文字列 |
cURL 要求
次のコード例は、特定のユーザーと、 start パラメーターと end パラメーターで指定された特定の期間の予約の重複を確認する方法を示しています。
curl "http://instance.servicenow.com/api/sn_wsd_rsv/search/overlapping_reservation?user_id=2e617fecc3d365101e38b23bb00131ec&end=2023-06-19T8:00:00Z&start=2023-06-19T07:00:00Z" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'
返される結果:
{
"results": {
"isOverlapped": True,
"reservableId": ""
}
}
WSD Search - GET /api/sn_wsd_rsv/search/reservable
指定された予約可能なモデル構成を使用して、利用可能な予約可能アイテムを検索します。
URL 形式
バージョニングされている URL:/api/sn_wsd_rsv/{api_version}/search/reservable
デフォルトの URL:/api/sn_wsd_rsv/search/reservable
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ:文字列 |
| 名前 | 説明 |
|---|---|
| end | 必須です。利用可能な予約可能モジュールを検索するために使用する終了時間。この値は、start パラメーターで指定された値よりも後でなければなりません。 データタイプ:文字列 形式:UTC または現地時間 (yyyy-mm-dd hh:mm:ss) |
| exclude_reservables | 検索結果から除外する 1 つ以上の予約可能なsys_idsのリスト。 データタイプ:文字列またはアレイ テーブル:これらのsys_idsが配置されているテーブルは、予約可能なモジュール [sn_wsd_rsv_reservable_module] テーブルの reservable_table フィールドで指定されます。スペース [sn_wsd_core_space] またはルーム [sn_wsd_core_room] テーブルのいずれかです。 |
| ignore_same_day_validation | 予約検索で開始パラメーターと終了パラメーターの間の日付変更の検証を無視するかどうかを示すフラグ。 有効な値:
データタイプ:ブーリアン デフォルト値:false |
| include_reservable_purposes | 返される結果で各予約可能項目の職場の場所を予約する目的を返すかどうかを示すフラグ。 有効な値:
データタイプ:ブーリアン デフォルト値:false テーブル:予約可能な目的 [sn_wsd_rsv_reservable_purpose] |
| include_reservations_within_days | 1 日の各予約可能項目について、応答で利用可能な時間のすべての空きスロットを返すかどうかを示すフラグ。 有効な値:
データタイプ:ブーリアン デフォルト値:false |
| include_standard_services | 応答で標準サービス情報を返すかどうかを示すフラグ。この情報は、標準サービス [sn_wsd_rsv_standard_service] テーブルにあります。 標準サービスでは、ホワイトボード、追加のモニター、および類似サービスなど、予約時に予約可能な職場アイテムで利用可能な基本的なプロビジョニングについて説明します。標準サービスの詳細については、「 標準サービス」を参照してください。 有効な値:
データタイプ:ブーリアン デフォルト値:false |
| near_by_location_id | rsv_path パラメーターが browse_near_a_person に設定されている場合は必須です。エンコードされたクエリで使用する場所の sys_id。 データタイプ:文字列 テーブル:職場の場所 [sn_wsd_core_workplace_location] |
| 近隣 |
スペース管理 (sn_wsd_spc_mgmt_neighborhood) プラグインが有効になっている場合にのみ使用できます。 エンコードされたクエリで使用する近隣レコードのSys_id。 近隣スペースの予約の詳細については、「 Create neighborhood reservations」を参照してください。 データタイプ:文字列 テーブル:近隣 [sn_wsd_spcmgmt_neighborhood] |
| next_item_index | 取得する次のアイテムのインデックス。返される結果をページネーションするときに、このパラメーターを渡します。 データタイプ:数値 デフォルト:0 |
| page_size | 返される結果で返されるレコードの最大数。 データタイプ:数値 デフォルト:6 |
| q | 必須です。返された検索結果をフィルタリングするために使用するエンコードされたクエリ。このクエリ内では、建物の sys_id を指定する必要があり、floor、area、capacity、standard services、reservable_purposes などのパラメーターを指定できます。 数値である capacity を除いて、渡すパラメーターはすべて sys_id である必要があります。 例: この情報は、次のテーブルにあります。
データタイプ:文字列 |
| reservable_module | 必須です。検索に含める予約可能なモジュールの sys_id。予約可能モジュールは、類似タイプの職場アイテムをグループ化します。 データタイプ:文字列 テーブル:予約可能なモジュール [sn_wsd_rsv_reservable_module] |
| reservation_ids | 既存の予約sys_idsのカンマ区切りリスト。関連する予約を編集する場合は、このパラメーターを渡します。 対応する予約可能項目のこれらの sys_id に対してブロックされた時間は、利用可能として扱われます。 データタイプ:文字列 デフォルト:なし テーブル:職場予約 [sn_wsd_rsv_reservation] |
| rsv_path | 検索に適用する予約パス。 有効な値:
データタイプ:文字列 デフォルト:browser_all |
| schedule_view_obj | 返されるスケジュールビューの詳細。1 日を超える予約に対して 24 時間の可用性データが必要な場合は、このオブジェクトを渡します。返される結果には、指定された日付の利用可能な時間と予約のみが含まれます。 この機能を正しく動作させるには、パラメーター ignore_same_day_validation と include_reservations_within_days を true に設定する必要があります。 データタイプ: オブジェクト |
| schedule_view_obj.schedule_view_date | 予約可用性の返却を開始する日付。この日付は、 schedule_view_obj.timezone パラメーターで指定されたタイムゾーンである必要があります。 データタイプ:文字列 形式:YYYY-MM-DD |
| schedule_view_obj.timezone | 返される予約可用性データを決定するために使用する建物のタイムゾーン。例:米国/太平洋。 データタイプ:文字列 |
| start | 必須です。利用可能な予約可能モジュールを検索するために使用する開始時間。この値は、end パラメーターで指定された値よりも前でなければなりません。 データタイプ:文字列 形式:UTC または現地時間 (yyyy-mm-dd hh:mm:ss) |
| シフト | 予約に関連付けるシフトの sys_id。このパラメーターが渡される場合、 end パラメーターは必要ありません。 シフトベースの予約の詳細については、「 シフトベースの予約を有効にする」を参照してください。 データタイプ:文字列 テーブル:シフト [sn_wsd_core_shift] |
| sort_by | 返された予約可能なアイテムの望ましいソート順。 有効な値:
データタイプ:文字列 デフォルト:a_z |
| タイムゾーン | 優先タイムゾーン (ヨーロッパ/アムステルダムなど)。 データタイプ:文字列 デフォルト:なし |
| 名前 | 説明 |
|---|---|
| なし |
ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 要求本文のデータ形式。サポートされるタイプ:application/json、application/xml、または text/xml。 デフォルト: application/json |
| ヘッダー | 説明 |
|---|---|
| なし |
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 200 | 成功。要求が正常に処理されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 |
| 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 |
応答本文のパラメーター
| 名前 | 説明 |
|---|---|
| result | 指定された検索の結果を返します。 データタイプ:オブジェクト |
| result.filter | 予約可能なフロア、標準サービス、予約可能な目的に関する詳細。include_standard_services または include_reservable_purposes パラメーターが false に設定されている場合、standard_services および reservable_purposes は空のアレイです。 データタイプ:オブジェクト |
| result.filter.floors | 可能な予約があるフロアの詳細。
データタイプ: オブジェクト |
| result.filter.floors.display_value | 予約可能項目が存在するフロアの階数を表示します (12 など)。 データタイプ:文字列 |
| result.filter.floors.sys_id | 関連レコードの sys_id。 データタイプ:文字列 テーブル:フロア [sn_wsd_core_floor] |
| result.filter.standard_services | include_standard_services パラメーターが true に設定されている場合にのみ入力されます。 フリップチャート、プロジェクタースクリーン、ホワイトボードとマーカーなどの関連する標準サービス。 データタイプ:オブジェクトのアレイ
|
| result.filter.standard_services.font_awesome_icon | 標準サービスに関連付けられたサムネイルアイコンの名前。 データタイプ:文字列 |
| result.filter.standard_services.name | 標準サービスの名前。 データタイプ:文字列 |
| result.filter.standard_services.short_description | 標準サービスの簡単な説明。 データタイプ:文字列 |
| result.filter.standard_services.sys_id | 標準サービスレコードの sys_id。 データタイプ:文字列 テーブル:標準サービス [sn_wsd_rsv_standard_service] |
| result.filter.reservable_purposes | 関連する予約可能項目の予約の目的に関する詳細。 データタイプ:オブジェクトのアレイ |
| result.filter.reservable_purposes.name | 予約可能項目の名前。 データタイプ:文字列 |
| result.filter.reservable_purposes.short_description | 予約可能項目の簡単な説明。 データタイプ:文字列 |
| result.filter.reservable_purposes.sys_id | 予約可能な目的レコードの sys_id。 データタイプ:文字列 テーブル:予約可能な目的 [sn_wsd_rsv_reservable_purpose] |
| result.hasMore | 返される結果にさらに予約可能項目が含まれているかどうかを示すフラグ。 可能な値:
データタイプ:ブール |
| result.nextFavIndex | ユーザーの次にお気に入りの可能な予約のインデックス。ユーザーのお気に入りの可能な予約をページネーションするときに、この値を使用します。 データタイプ:数値 |
| result.nextItemIndex | フェッチする次の予約可能レコードのインデックス。予約可能レコードをページネーションするときに、この値を使用します。 データタイプ:数値 |
| result.reservableContainers | selection_type フィールドが container に設定されている予約可能モジュールに対してのみ返されます。コンテナーは、デスクのグループなど、類似のアイテムをグループ化したものです。 データタイプ:オブジェクトのアレイ |
| result.reservableContainers.building | 予約可能コンテナーに関連付けられている建物の詳細。 データタイプ:オブジェクト |
| result.reservableContainers.building.display_value | 建物の表示値。 データタイプ:文字列 |
| result.reservableContainers.building.name | 建物の名前。 データタイプ:文字列 |
| result.reservableContainers.building.sys_id | 関連付けられた建物レコードの sys_id。 データタイプ:文字列 |
| result.reservableContainers.campus | 予約可能項目がある敷地の詳細。
データタイプ: オブジェクト
テーブル:敷地 [sn_wsd_core_campus] |
| result.reservableContainers.campus.display_value | 予約可能項目が存在する敷地の表示数 (イーストベイなど)。 データタイプ:文字列 |
| result.reservableContainers.campus.name | 敷地の名前。 データタイプ:文字列 |
| result.reservableContainers.campus.sys_id | 関連レコードの sys_id。 データタイプ:文字列 テーブル:敷地 [sn_wsd_core_campus] |
| result.reservableContainers.capacity | 予約可能項目の参加者の最大人数。 データタイプ:数値 |
| result.reservableContainers.display_value | 予約可能コンテナーの表示値。 データタイプ:文字列 |
| result.reservableContainers.floor | 予約可能コンテナーに関連付けられているフロアの詳細。 データタイプ:オブジェクト |
| result.reservableContainers.floor.display_value | 予約可能項目が存在するフロアの階数を表示します (12 など)。 データタイプ:文字列 |
| result.reservableContainers.floor.name | 予約可能項目が存在するフロアの名前。 データタイプ:文字列 |
| result.reservableContainers.floor.sys_id | 関連レコードの sys_id。 データタイプ:文字列 テーブル:フロア [sn_wsd_core_floor] |
| result.reservableContainers.image | この予約可能項目のレイアウトを表す画像へのリンク。 データタイプ:文字列 テーブル:画像 [db_image] |
| result.reservableContainers.image.link | この予約可能項目のレイアウトを表す画像へのリンク。 データタイプ:文字列 テーブル:画像 [db_image] |
| result.reservableContainers.image.sys_id | 関連する画像レコードの sys_id。 データタイプ:文字列 |
| result.reservableContainers.sys_id | 関連コンテナーレコードの sys_id。 データタイプ:文字列 テーブル:これが存在するテーブルは、任意のコンテナタイプに対して構成できます。デフォルトでは、エリア [sn_wsd_core_Area] テーブルにあります。 |
| result.reservableUnits | 指定された検索条件に一致する予約可能ユニットに関する詳細。予約可能ユニットは、机や椅子などの単一の予約可能アイテムです。 データタイプ:オブジェクトのアレイ |
| result.reservableUnits.area | 予約可能モジュールがあるエリアの詳細。 データタイプ: オブジェクト テーブル:エリア [sn_wsd_core_area] |
| result.reservableUnits.area.display_value | 予約可能モジュールエリアの表示値。 データタイプ:文字列 |
| result.reservableUnits.area.sys_id | 予約可能項目に関連するエリアレコードの sys_id。 データタイプ:文字列 |
| result.reservableUnits.availableTimes | 関連する予約可能項目が使用可能な日時のリスト。 データタイプ:アレイ |
| result.reservableUnits.building | 予約可能項目がある建物の詳細。 データタイプ: オブジェクト テーブル:建物 [sn_wsd_core_building] |
| result.reservableUnits.building.display_value | 建物の表示値。 データタイプ:文字列 |
| result.reservableUnits.building.sys_id | 関連付けられた建物レコードの sys_id。 データタイプ:文字列 |
| result.reservableUnits.campus | 予約可能項目がある敷地の詳細。
データタイプ: オブジェクト
テーブル:敷地 [sn_wsd_core_campus] |
| result.reservableUnits.campus.display_value | 予約可能項目が存在する敷地の表示数 (イーストベイなど)。 データタイプ:文字列 |
| result.reservableUnits.campus.sys_id | 関連レコードの sys_id。 データタイプ:文字列 テーブル:敷地 [sn_wsd_core_campus] |
| result.reservableUnits.capacity | 予約可能項目の参加者の最大人数。 データタイプ:数値 |
| result.reservableUnits.description | 予約可能項目の簡単な説明。 データタイプ:文字列 |
| result.reservableUnits.email | 予約可能項目のメールアドレス。 データタイプ:文字列 |
| result.reservableUnits.external_id | CMS でマッピングされたスペースを同期するために使用される予約可能項目の外部 ID。この値は、この場所に関連付けられたマップがある場合にのみ入力されます。 データタイプ:文字列 |
| result.reservableUnits.floor | 可能な予約があるフロアの詳細。
データタイプ: オブジェクト
テーブル:フロア [sn_wsd_core_floor] |
| result.reservableUnits.floor.display_value | 予約可能項目が存在するフロアの階数を表示します (12 など)。 データタイプ:文字列 |
| result.reservableUnits.floor.sys_id | 関連レコードの sys_id。 データタイプ:文字列 テーブル:フロア [sn_wsd_core_floor] |
| result.reservableUnits.image | 関連する予約可能項目のレイアウトを表す画像の詳細。 データタイプ: オブジェクト テーブル:画像 [db_image] |
| result.reservableUnits.image.link | この予約可能項目のレイアウトを表す画像へのリンク。 データタイプ:文字列 テーブル:画像 [db_image] |
| result.reservableUnits.image.sys_id | 関連する画像レコードの sys_id。 データタイプ:文字列 |
| result.reservableUnits.includedInResult | 現在の予約可能項目が返される結果に含まれているかどうかを示すフラグ。 有効な値:
データタイプ:ブール |
| result.reservableUnits.is_available | 予約可能項目が使用可能かどうかを示すフラグ。 有効な値:
データタイプ:ブール |
| result.reservableUnits.is_favorite | 予約可能項目が関連するユーザーのお気に入りの 1 つとしてフラグ付けされているかどうかを示すフラグ。 有効な値:
データタイプ:ブール |
| result.reservableUnits.is_reservable | この予約を予約できるかどうかを示すフラグ。 注: include_unavailable_items クエリパラメーターが true に設定されている場合は、利用できない場所も返されます。この場合、場所が既に予約されている場合、is_available パラメーターは false ですが、is_reservable は true です。 有効な値:
データタイプ:ブール |
| result.reservableUnits.is_reserved | 予約可能項目が既に予約されているかどうかを示すフラグ。 有効な値:
データタイプ:ブール |
| result.reservableUnits.is_selected | 予約可能項目が既に予約されているかどうかを示すフラグ。 有効な値:
データタイプ:ブール |
| result.reservableUnits.location_type | 予約可能項目の場所のタイプに関する詳細 (workplace/desk、cafe、gym など)。 データタイプ: オブジェクト テーブル:職場の場所 [sn_wsd_core_workplace_location] |
| result.reservableUnits.location_type.display_value | 場所タイプの表示値。 データタイプ:文字列 |
| result.reservableUnits.location_type.name | 地下やストレージなどの場所タイプの名前。表示値と同じです。 データタイプ:文字列 |
| result.reservableUnits.location_type.sys_id | 関連レコードの sys_id。 データタイプ:文字列 テーブル:スペースタイプ [sn_wsd_core_space_type] |
| result.reservableUnits.name | 予約可能項目の名前。 データタイプ:文字列 |
| result.reservableUnits.number | 予約可能項目の一意の識別子。この値は、sys_id よりも人間が判読しやすい値です。 データタイプ:文字列 |
| result.reservableUnits.order | 予約可能項目の注文番号。 データタイプ:数値 |
| result.reservableUnits.require_approval | 予約可能項目の予約に承認が必要かどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン |
| result.reservableUnits.requires_check_in | 予約でユーザーのチェックインが必要かどうかを示すフラグ。 有効な値:
データタイプ:ブーリアン |
| result.reservableUnits.reservable_purposes | 関連する予約可能項目の予約の目的に関する詳細。 データタイプ:オブジェクトのアレイ |
| result.reservableUnits.reservable_purposes.name | 予約可能項目の名前。 データタイプ:文字列 |
| result.reservableUnits.reservable_purposes.short_description | 予約可能項目の簡単な説明。 データタイプ:文字列 |
| result.reservableUnits.reservable_purposes.sys_id | 予約可能な目的レコードの sys_id。 データタイプ:文字列 テーブル:予約可能な目的 [sn_wsd_rsv_reservable_purpose] |
| result.reservableUnits.reservations | 予約可能項目に関連付けられている予約に関する詳細。include_reservations_within_days クエリパラメーターが true で、reservation_ids パラメーターに予約 ID が含まれている場合にのみ入力されます。これは、この予約可能項目の予約が既に存在することを意味します。 データタイプ:オブジェクトのアレイ |
| result.reservableUnits.reservations.configuration_item | 予約に対応する構成アイテム。 データタイプ:文字列 テーブル:構成アイテム [cmdb_ci] |
| result.reservableUnits.reservations.end | 予約の終了日時。 データタイプ:文字列 形式:UTC:yyyy-mm-ddThh:mm:ssZ (2021-02-05T18:00:00Z など) |
| result.reservableUnits.reservations.is_collided | 予約が検索の開始時間と終了時間と競合するかどうかを示すフラグ。 これは、関連する予約可能な場所が指定された検索タイムスパンで既に予約されていることを示します。 可能な値:
データタイプ:ブール |
| result.reservableUnits.reservations.location | 予約の場所の詳細。 データタイプ:オブジェクト |
| result.reservableUnits.reservations.location.location | 関連付けられた場所レコードの sys_id。 データタイプ:文字列 テーブル:職場の場所 [sn_wsd_core_workplace_location] |
| result.reservableUnits.reservations.location.timezone | 場所に関連付けられたタイムゾーンに関する詳細。 データタイプ:オブジェクト |
| result.reservableUnits.reservations.location.timezone.displayValue | この場所が属するタイムゾーンの表示値。 データタイプ:文字列 |
| result.reservableUnits.reservations.location.timezone.value | この場所が属するタイムゾーンの内部値。 データタイプ:文字列 |
| result.reservableUnits.reservations.number | 予約可能項目の一意の識別子。この値は、sys_id よりも人間が判読しやすい値です。 データタイプ:文字列 |
| result.reservableUnits.reservations.requested_for | 代理で予約が要求されたユーザーの詳細。 データタイプ:オブジェクト |
| result.reservableUnits.reservations.requested_for.name | 予約が要求されたユーザーの名前。 データタイプ:文字列 |
| result.reservableUnits.reservations.requested_for.sys_id | 予約が要求されているユーザーの sys_id。 データタイプ:文字列 テーブル: ユーザー [sys_user] |
| result.reservableUnits.reservations.reservation_purpose | 予約の目的の詳細。 データタイプ:オブジェクト |
| result.reservableUnits.reservations.reservation_purpose.display_value | 会社の会議などの予約の目的の表示値。 データタイプ:文字列 |
| result.reservableUnits.reservations.reservation_purpose.value | company_meeting などの予約の目的の内部値。 データタイプ:文字列 |
| result.reservableUnits.reservations.start | 予約の開始日時。 データタイプ:文字列 形式:UTC:yyyy-mm-ddThh:mm:ssZ (2021-02-05T18:00:00Z など) |
| result.reservableUnits.reservations.state | 場所の予約のステータスの詳細。 データタイプ:オブジェクト |
| result.reservableUnits.reservations.state.display_value | 予約の現在のステータスの表示値 (確定済みなど)。 データタイプ:文字列 |
| result.reservableUnits.reservations.state.value | 予約の現在のステータスの内部値 (2 など)。 データタイプ:文字列 |
| result.reservableUnits.reservations.subject | 予約の件名。 データタイプ:文字列 |
| result.reservableUnits.reservations.sys_id | 必須です。 予約レコードの sys_id。 データタイプ:文字列 テーブル:職場予約 [sn_wsd_rsv_reservation] |
| result.reservableUnits.reservable_quantity | 関連する予約可能項目を同じ時間に予約できる最大回数。この値は、エリアに近隣スペースをアサインするときに使用されます。 データタイプ:整数 |
| result.reservableUnits.site | 予約可能項目が存在するサイトの詳細。 データタイプ: オブジェクト テーブル:サイト [sn_wsd_core_site] |
| result.reservableUnits.site.display_value | サイトの表示値。 データタイプ:文字列 |
| result.reservableUnits.site.sys_id | 関連付けられたサイトレコードのSys_id。 データタイプ:文字列 テーブル:サイト [sn_wsd_core_site] |
| result.reservableUnits.standard_services | フリップチャート、プロジェクタースクリーン、ホワイトボードとマーカーなどの関連する標準サービス。 データタイプ:オブジェクトのアレイ
|
| result.reservableUnits.standard_services.font_awesome_icon | 標準サービスに関連付けられたサムネイルアイコンの名前。 データタイプ:文字列 |
| result.reservableUnits.standard_services.name | 標準サービスに関連付けられたサムネイルアイコンの名前。 データタイプ:文字列 |
| result.reservableUnits.standard_services.short_description | 標準サービスの簡単な説明。 データタイプ:文字列 |
| result.reservableUnits.standard_services.sys_id | 標準サービスレコードの sys_id。 データタイプ:文字列 テーブル:標準サービス [sn_wsd_rsv_standard_service] |
| result.reservableUnits.sys_id | 予約可能レコードの sys_id。 データタイプ:文字列 テーブル:職場の場所 [sn_wsd_core_workplace_location] |
| result.reservableUnits.tableName | 予約可能項目レコードが存在するテーブルの名前。 データタイプ:文字列 |
| result.reservableUnits.title | 予約可能項目のタイトル。 データタイプ:文字列 |
| result.totalProcessed | 処理されるレコードの合計数。 データタイプ:数値 |
cURL 要求
この例では、このエンドポイントを使用して予約を検索する方法を示します。注:読みやすくするために、クエリパラメーターに改行が追加されました。
curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/reservable?
reservable_module=d9864189c3653910977396cb05013100&
start=2023-10-12T10:30:00Z&
end=2023-10-13T11:30:00Z&
include_standard_services=true&
include_reservable_purposes=true&
include_reservations_within_days=true&
include_unavailable_items=true&
near_by_location_id=undefined&
timezone=Europe/Paris&
page_size=6&
sort_by=a_z&
view=schedule&
rsv_path=browse_all&
ignore_same_day_validation=true&
schedule_view_obj={"schedule_view_date":"2023-10-12","timezone":"Europe/Paris"}&
q=building=dea39b1977220110b3d7be377b5a9955\
--request GET \
--header "Accept:application/json"
--user "username":"password"
返される結果:
{
"result": {
"hasMore": true,
"reservableUnits": [
{
"sys_id": "fe1f744edb7650106c731dcd139619ca",
"external_id": null,
"email": null,
"name": "Aspen",
"title": "Aspen",
"description": "A room with large windows, dark leather seats and a large wooden table.",
"image": {
"sys_id": "41c74902dbb650106c731dcd13961944",
"link": "41c74902dbb650106c731dcd13961944.iix"
},
"number": "ROOM0000903",
"site": {
"sys_id": "628eec06db7650106c731dcd139619dd",
"display_value": "North America"
},
"campus": {
"sys_id": "82b2a0cedb3650106c731dcd139619e9",
"display_value": "California Campus"
},
"building": {
"sys_id": "94e264cedb3650106c731dcd13961919",
"display_value": "CAL-B1"
},
"floor": {
"sys_id": "2f554296dbba10106c731dcd139619ed",
"display_value": "Floor 2"
},
"area": null,
"capacity": "16",
"reservable_quantity": null,
"location_type": {
"sys_id": "20713b83eb512010b89bfdfc9c522899",
"display_value": "Room",
"name": "Room"
},
"order": null,
"requires_check_in": null,
"is_reservable": "1",
"tableName": "sn_wsd_core_room",
"require_approval": false,
"standard_services": [
{
"sys_id": "9b01458edb7650106c731dcd13961945",
"name": "Flip chart",
"short_description": "Flip chart with paper sheets",
"font_awesome_icon": "fa-calendar-o"
}
],
"reservable_purposes": [
{
"sys_id": "18f4c3cd1ba4e01051848489cc4bcb82",
"name": "Board room",
"short_description": null
}
],
"is_available": true,
"reservations": [
{
"sys_id": "5fe65830874bc9106342b846dabb352b",
"number": "WRES0001001",
"location": {
"location": "fe1f744edb7650106c731dcd139619ca",
"timezone": {
"value": "US/Pacific",
"displayValue": "US/Pacific"
}
},
"configuration_item": null,
"start": "2022-04-23T08:30:00Z",
"end": "2022-04-23T09:30:00Z",
"subject": null,
"reservation_purpose": {
"value": "meeting",
"display_value": "Meeting"
},
"state": {
"value": "confirmed",
"display_value": "Confirmed"
},
"is_collided": false,
"requested_for": {
"sys_id": "2de07e1887cb89106342b846dabb35fe",
"name": "Workplace User"
}
}
],
"availableTimes": [
[
"2022-04-23 07:00:00",
"2022-04-23 08:30:00"
],
[
"2022-04-23 09:30:00",
"2022-04-23 23:00:00"
]
],
"is_reserved": true,
"is_selected": true,
"includedInResult": true,
"is_favorite": false
}
],
"reservableContainers": [],
"nextItemIndex": -1,
"filter": {
"floors": [],
"standard_services": [
{
"sys_id": "9b01458edb7650106c731dcd13961945",
"name": "Flip chart",
"short_description": "Flip chart with paper sheets",
"font_awesome_icon": "fa-calendar-o"
}
],
"reservable_purposes": [
{
"sys_id": "18f4c3cd1ba4e01051848489cc4bcb82",
"name": "Board room",
"short_description": null
}
]
},
"totalProcessed": 2,
"nextFavIndex": 0
}
}
WSD Search - GET /api/sn_wsd_rsv/search/shift/{building_id}/{module_id}
シフト [sn_wsd_core_shift] テーブル内の利用可能なシフトを検索するために使用できるエンコードされたクエリを返します。
指定された予約可能なモジュールの [appy_to_shift] フィールドが有効になっている場合にのみ適用されます。有効になっていない場合、返されるエンコードされたクエリ文字列は空になります。
URL 形式
バージョニングされている URL:/api/sn_wsd_rsv/{api_version}/search/shift/{building_id}/{module_id}
デフォルトの URL:/api/sn_wsd_rsv/search/shift/{building_id}/{module_id}
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ:文字列 |
| building_id | 検索クエリに含める建物の sys_id。 データタイプ:文字列 テーブル:建物 [sn_wsd_core_building] |
| module_id | 検索クエリに含める予約可能なモジュールの sys_id。予約可能なモジュールは、椅子やデスクなど、類似タイプの職場アイテムをグループ化します。 データタイプ:文字列 テーブル:予約可能なモジュール [sn_wsd_core_reservable_module] |
| 名前 | 説明 |
|---|---|
| なし |
| 名前 | 説明 |
|---|---|
| end_date | エンコードされたクエリに含めるシフト終了日時。 データタイプ:文字列 形式:yyyy-mm-dd hh:mm:ss |
| start_date | エンコードされたクエリに含めるシフト開始日時。 データタイプ:文字列 形式:yyyy-mm-dd hh:mm:ss |
ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 要求本文のデータ形式。サポートされるタイプ:application/json、application/xml、または text/xml。 デフォルト: application/json |
| ヘッダー | 説明 |
|---|---|
| なし |
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 200 | 成功。要求が正常に処理されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 |
| 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 |
応答本文のパラメーター
| 名前 | 説明 |
|---|---|
| result | 指定された利用可能なシフトを取得するために使用するエンコードされたクエリ。 データタイプ:オブジェクト |
| moduleHasShift | 指定された予約可能なモジュールでシフトが有効になっているかどうかを示すフラグ。 有効な値:
データタイプ:ブーリアン |
| query | 指定された予約可能なモジュールのシフト情報を取得するために使用するエンコードされたクエリ。 データタイプ:文字列 |
cURL 要求
次のコード例は、このエンドポイントを使用してシフトのエンコードされたクエリを取得する方法を示しています。
curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/shift/94e264cedb3650106c731dcd13961919/fc71f64fdb42a01097acc900399619a8?start_date=2022-04-23 16:00:00&end_date=2022-04-28 16:00:00" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
返される結果:
{
"result": {
"moduleHasShift" : true,
"query" : "active=true^state=2^building=94e264cedb3650106c731dcd13961919^building.is_reservable=true^building.active=true^floorISEMPTY^ORfloor.is_reservable=true^floorISEMPTY^ORfloor.active=true^start<=2022-04-26 16:00:00^ORstartISEMPTY^end>=2022-04-28 16:00:00^ORendISEMPTY^start<=2022-04-28 16:00:00^ORstartISEMPTY^end>=2022-04-28 16:00:00^ORendISEMPTY"
}
}
WSD Search - POST /api/sn_wsd_rsv/search/availability_score
指定されたタイムスロットの予約可能なアイテムの使用可否スコアを返します。
URL 形式
バージョニングされている URL:/api/sn_wsd_rsv/{api_version}/search/availability_score
デフォルトの URL:/api/sn_wsd_rsv/search/availability_score
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ:文字列 |
| 名前 | 説明 |
|---|---|
| なし |
| 名前 | 説明 |
|---|---|
| recurringPattern | startEndDateTimes パラメーターが指定されていない場合は必須です。可能な予約を検索するために使用する繰り返しパターン。指定された繰り返しイベントで利用可能です。 データタイプ:オブジェクト |
| recurringPattern.duration | 必須。予約可能でなければならない期間。 データタイプ:数値 単位:ミリ秒 |
| recurringPattern.label | 「Repeats daily, 5 times」など、繰り返し発生するパターンの説明。 データタイプ:文字列 |
| recurringPattern.options | 検索する繰り返し予約の使用可否オプション。 データタイプ:オブジェクト |
| recurringPattern.options.count | endDate が渡されない場合に必須です。両方が渡される場合、count が使用されます。会議パターンを繰り返す回数。 データタイプ:数値 |
| recurringPattern.options.daysOfWeek | recurringPattern.repeats パラメーターが weekly に設定されている場合は必須です。予約が必要な曜日。 有効な値:
たとえば、火曜日、木曜日、金曜日を指定するには、245 (区切り文字なし) を渡します。repeat が weekly、count が 5、daysOfWeek が 245 の場合、返される結果の合計は データタイプ:文字列 |
| recurringPattern.options.endDate | recurringPattern.options.count が渡されない場合に必須です。両方が渡される場合、count が使用されます。会議の繰り返しの終了日時 (「2022-07-08T14:00:00Z」など)。 データタイプ:文字列 形式:UTC yyyy-mm-dd hh:mm:ss |
| recurringPattern.repeats | 必須。可能な予約の繰り返しパターン。 有効な値 (大文字と小文字を区別):
データタイプ:文字列 |
| recurringPattern.startDate | 必須です。繰り返しパターンの開始日時 (「2022-07-08T14:00:00Z」など)。 データタイプ:文字列 形式:UTC yyyy-mm-dd hh:mm:ss |
| reservableIds | 必須。使用可否スコアに含める可能な予約の sys_id のリスト。 データタイプ:アレイ テーブル:職場の場所 [sn_wsd_core_workplace_location] |
| reservableType | 必須。使用可否スコアに含める可能な予約のタイプ。検索を絞り込むために使用します。 有効な値 (大文字と小文字を区別):
データタイプ:文字列 |
| startEndDateTimes | 検索するユーザーのタイムゾーンでの開始日時と終了日時のリスト。 データタイプ:オブジェクトのアレイ デフォルト:recurringPattern パラメーターを指定する必要があります。 |
| startEndDateTimes.end | 可能な予約の終了日時。 データタイプ:文字列 形式:yyyy-mm-dd hh:mm:ss |
| startEndDateTimes.start | 可能な予約の開始日時。 データタイプ:文字列 形式:yyyy-mm-dd hh:mm:ss |
ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml。 デフォルト: application/json |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
| ヘッダー | 説明 |
|---|---|
| なし |
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 200 | 成功。要求が正常に処理されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 |
| 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 |
応答本文のパラメーター
| 名前 | 説明 |
|---|---|
| result | 指定された使用可否スコアの結果を返します。 データタイプ: オブジェクト |
| result.reservable_sys_id | 可用性スコアの詳細。 データタイプ: オブジェクト |
| result.reservable_sys_id.available | 指定された検索条件を満たした利用可能な予約の数。 データタイプ:数値 |
| result.reservable_sys_id.score | 使用可否スコア。指定された検索条件を満たした利用可能な予約の合計数に対する、利用可能な予約の数。たとえば、available が 2 で total が 4 の場合、score の値は 2/4 です。 データタイプ:文字列 |
| result.reservable_sys_id.total | 指定された検索条件を満たした利用可能な予約の合計数。 データタイプ:数値 |
cURL 要求
次のコード例は、このエンドポイントを呼び出す方法を示しています。
curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/availability_score" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"reservableType\": \"location\",
\"reservableIds\": [
\"fe1f744edb7650106c731dcd139619ca\",
\"5eafb44edb7650106c731dcd13961943\"
],
\"recurringPattern\": {
\"duration\": 3600000,
\"repeats\": \"daily\",
\"options\": {
\"count\": 150,
\"daysOfWeek\": \"\",
},
\"label\": \"Repeats daily, 5 times\",
\"startDate\": \"2022-04-26T14:00:00Z\"
},
\"startEndDateTimes\": [
{
\"start\": \"2022-07-05 14:00:00\",
\"end\": \"2022-07-05 15:00:00\"
},
{
\"start\": \"2022-07-06 14:00:00\",
\"end\": \"2022-07-06 15:00:00\"
}
]
}" \
--user "username":"password"
返される結果:
{
"result": {
"fe1f744edb7650106c731dcd139619ca": {
"available": 2,
"total": 2,
"score": "2/2"
},
"5eafb44edb7650106c731dcd13961943": {
"available": 2,
"total": 2,
"score": "2/2"
}
}