サービステリトリー
workTypeId または workTypeGroupId のサービステリトリーを取得します。radius、latitude、longitude、sortBy、、sortOrder プロパティを使用して、サービステリトリーの絞り込みや並び替えを行います。
- リソース
-
1/connect/scheduling/service-territories - リソースの例
-
1/connect/scheduling/service-territories?workTypeGroupId=0VSRM000000009Z4AQ&latitude=37.79332&longitude=-122.392761&radius=50&radiusUnit=km&sortBy=Distance&sortOrder=asc - 使用可能なバージョン
- 48.0
- Chatter が必要かどうか
- いいえ
- HTTP のメソッド
- GET
- クエリパラメータ
-
パラメータ名 型 説明 必須か省略可能 使用可能なバージョン latitude Double サービステリトリーエリアの緯度。 省略可能 48.0 limit Integer 返されるサービステリトリーの制限。たとえば、limit=1 と指定すると、サービステリトリーリストには 1 つのサービステリトリーしか登録できません。デフォルト値は 40 です。 省略可能 48.0 longitude Double サービステリトリーエリアの経度。 省略可能 48.0 offset Integer 返されるサービステリトリーのオフセット。デフォルト値は 0 です。 省略可能 48.0 radius Integer サービステリトリーを取得するための、緯度と経度の値を中心とした半径。緯度と経度が指定されている場合のデフォルト値は 5 で、指定されていない場合はデフォルト値はありません。 省略可能 48.0 radiusUnit String 半径値の単位。可能な値は mi (マイル) と km (キロメートル) です。緯度と経度が指定されている場合のデフォルト値は mi で、指定されていない場合はデフォルト値はありません。 省略可能 48.0 schedulingPolicyId String AppointmentSchedulingPolicy オブジェクトの ID。リクエストボディでスケジュールポリシーが渡されない場合、デフォルトの設定が使用されます。この API を使用する場合、すべてのスケジュールポリシー設定が考慮されます。 省略可能 48.0 serviceResourceIds String[] サービス技術者またはアセットの ID。 省略可能 48.0 sortBy String[] サービステリトリーリストの並び替え条件。有効な値は distance と name で、大文字と小文字は区別されません。緯度と経度が指定されている場合のデフォルト値は distance で、指定されていない場合のデフォルト値は name です。 省略可能 48.0 sortOrder String[] サービステリトリーリストの並び替えの順序。大文字と小文字が区別されない有効な値は asc (昇順) と desc (降順) で、大文字と小文字は区別されません。デフォルト値は asc です。 省略可能 48.0 workTypeGroupId String 実施されている作業種別を含む作業種別グループの ID。 workTypeId が指定されていない場合は必須 48.0 workTypeId String 実行する作業の種別の ID。 workTypeGroupId が指定されていない場合は必須 48.0 - レスポンスボディ
- Service Territories Output
- サンプルレスポンスボディ
-
1{ 2 "result" : { 3 "serviceTerritories" : [ { 4 "city" : "San Francisco", 5 "country" : "United States", 6 "id" : "0HhRM00000002U50AI", 7 "latitude" : 37.79332, 8 "longitude" : -122.392761, 9 "name" : "Chase 1 Mission", 10 "operatingHoursId" : "0OHRM00000002Ps4AI", 11 "postalCode" : "94105", 12 "state" : "CA", 13 "street" : "1 Mission Street" 14 }, { 15 "city" : "San Francisco", 16 "country" : "United States", 17 "id" : "0HhRM00000002Tq0AI", 18 "latitude" : 37.793872, 19 "longitude" : -122.394865, 20 "name" : "Chase 1 Market", 21 "operatingHoursId" : "0OHRM00000002Ps4AI", 22 "postalCode" : "94105", 23 "state" : "CA", 24 "street" : "1 Market Street" 25 } ] 26 } 27}