この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

Available Territory Slots

指定されたテリトリー内の各サービスリソースを利用できるかどうかについての統合的な情報を取得します。

リソース

1/connect/scheduling/available-territory-slots

使用可能なバージョン

49.0

Chatter が必要かどうか

いいえ

HTTP のメソッド

要求の例

1{
2  "startTime": "2019-01-23T00:00:00.000Z",
3  "endTime": "2019-02-30T00:00:00.000Z",
4  "workTypeGroupId": "0VSB0000000KyjBOAS",
5  "accountId": "001B000000qAUAWIA4",
6  "territoryIds": [
7    "0HhB0000000TO9WKAW"
8  ],
9  "schedulingPolicyId": "0VrB0000000KyjB",
10  "requiredResourceIds": [
11    "0HnB0000000TO8gKAK"
12  ]
13}

必須項目のみを含む要求の例

1{
2  "workType": {
3    "id": "08qS70000004DTsIAM"
4  },
5  "territoryIds": [
6    "0HhS70000004DTdKAM"
7  ]
8}

プロパティ

名前	型	説明	必須か省略可能	使用可能なバージョン
`accountId`	String	関連取引先の ID。	省略可能	49.0
`allowConcurrentScheduling`	Boolean	同時予定が許可されているか (`true`)、否か (`false`) を示します。デフォルト値は `false` です。	省略可能	49.0
`correlationId`	String	`ServiceResourceScheduleHandler` Apex インターフェースにカスタム情報を渡すための ID。たとえば、この相関関係 ID によって Apex インターフェース実装をコールするアプリケーション、Web サイト、または外部システムを識別できます。カスタム値を渡さない場合、ランダムに生成された識別子が渡されます。	省略可能	53.0
`endTime`	String	予定を終了できる最も遅い時間。この API は、`startTime` から最大 31 日の時間枠を返します。メモ	省略可能	49.0
`filterByResources`	String[]	サービスリソース ID のカンマ区切りリスト。API は、リストと選択したサービステリトリーの両方の資格があるサービスリソースのみを返します。リソースは、リソース ID が渡された順序で並び替えられます。要求で `filterByResources` または `requiredResourceIds` を渡すことができます。メモ	省略可能	51.0
`requiredResourceIds`	String[]	空き時間枠を取得するリソース ID のリスト。複数のリソース ID を渡した場合、渡されたリソースが対応可能なす��ての時間枠が API によって返されます。たとえば、3 人の有資格のリソース A、B、C がいるとします。リソース ID A および B を渡した場合、次に該当するすべての時間枠が API によって返されます。 A のみが対応可能 B のみが対応可能 A と B の両方が対応可能 A と C の両方が対応可能 A、B、C の全員が対応可能 C のみが対応可能な時間枠は API によって返されません。この項目が空の場合、すべての有資格のリソースの時間枠が返されます。	省略可能	49.0
`resourceLimitApptDistribution`	Integer	予定の配分が有効になっている場合に予定のスケジュール中に表示するサービスリソースの最大数を指定します。 `filterByResources` 項目は、`resourceLimitApptDistribution` 項目より優先されます。メモ	省略可能	53.0
`schedulingPolicyId`	String	AppointmentSchedulingPolicy オブジェクトの ID。指定されていない場合は、デフォルトの設定が考慮されます。	省略可能	49.0
`startTime`	String	予定を開始できる最も早い時間。過去の時間も使用できます。	省略可能	49.0
`territoryIds`	String[]	指定された作業が実施されるサービステリトリーの ID のリスト。	必須	49.0
`workType`	Work Type Input	実施された作業の種別。	`workTypeGroupId` が指定されていない場合は必須	49.0
`workTypeGroupId`	String	実施されたすべての作業種別を含む作業種別グループの ID。	`workType` が指定されていない場合は必須	49.0

応答の例

1{
2"result": {
3    "territorySlots": [
4      {
5        "territoryId": "0HhB0000000TO9WKAW",
6        "slots": [
7          {
8            "endTime": "2019-01-23T19:15:00.000+0000",
9            "resources": [
10              "0HnB0000000D2DsKAK",
11              "0HnB0000000D2DsJKL"
12            ],
13            "startTime": "2019-01-23T16:15:00.000+0000"
14          },
15          {
16            "endTime": "2019-01-23T19:30:00.000+0000",
17            "resources": [
18              "0HnB0000000D2DsKAK",
19              "0HnB0000000D2DsJKL"
20            ],
21            "startTime": "2019-01-23T16:30:00.000+0000"
22          }
23        ]
24      },
25      {
26        "territoryId": "0HhB0000000TO9WERT",
27        "slots": [
28          {
29            "endTime": "2019-01-23T19:15:00.000+0000",
30            "resources": [
31              "0HnB0000000D2DsKAK"
32            ],
33            "startTime": "2019-01-23T16:15:00.000+0000"
34          },
35          {
36            "endTime": "2019-01-23T19:30:00.000+0000",
37            "resources": [
38              "0HnB0000000D2DsKAK",
39              "0HnB0000000D2DsJKL"
40            ],
41            "startTime": "2019-01-23T16:30:00.000+0000"
42          }
43        ]
44      }
45    ]
46  }
47}

POST のレスポンスボディ: Available Territory Slots Output

Connect REST API 開発者ガイド

Available Territory Slots