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

サービス予定

サービス予定の作成、リソースの割り当て、リードの生成を行います。サービス予定は parentRecordId または lead のどちらか片方のみを使用して作成できます。両方は使用できません。認証されていないゲストユーザとのサービス予定を作成するには lead を使用します。

リソース

1/connect/scheduling/service-appointments

使用可能なバージョン

48.0

Chatter が必要かどうか

いいえ

HTTP メソッド

POST

POST のリクエストボディ

JSON の例

1{
2  "serviceAppointment": {
3    "parentRecordId": "0012w000004oZXgAAM",
4    "workTypeId": "08q2w000000XmniAAC",
5    "serviceTerritoryId": "0Hh2w000000XmoXCAS",
6    "schedStartTime": "2020-02-26T15:00:00.000Z",
7    "schedEndTime": "2020-02-26T16:00:00.000Z",
8    "street": "1 Market Street",
9    "city": "San Francisco",
10    "state": "CA",
11    "postalCode": "94105",
12    "country": "USA",
13    "appointmentType": "In Person",
14    "extendedFields": []
15  },
16  "assignedResources": [
17    {
18      "serviceResourceId": "0Hn2w000000gDWDCA2",
19      "isRequiredResource": true,
20      "isPrimaryResource": true,
21      "extendedFields": []
22    },
23    {
24      "serviceResourceId": "0Hn2w000000gCqnCAE",
25      "isRequiredResource": true,
26      "isPrimaryResource": false,
27      "extendedFields": []
28    }
29  ]
30}

認証されていないユーザの JSON の例

1{
2  "serviceAppointment": {
3    "workTypeId": "08q2w000000XmniAAC",
4    "serviceTerritoryId": "0Hh2w000000XmoXCAS",
5    "schedStartTime": "2020-02-26T15:00:00.000Z",
6    "schedEndTime": "2020-02-26T16:00:00.000Z",
7    "street": "1 Market Street",
8    "city": "San Francisco",
9    "state": "CA",
10    "postalCode": "94105",
11    "country": "USA",
12    "appointmentType": "In Person",
13    "extendedFields": []
14  },
15  "assignedResources": [
16    {
17      "serviceResourceId": "0Hn2w000000gDWDCA2",
18      "isRequiredResource": true,
19      "isPrimaryResource": true,
20      "extendedFields": []
21    }
22  ],
23  "lead": {
24        "firstName": "Rachel",
25        "lastName": "Adams",       
26        "phone": "012-345-6789",            
27        "email": "rachel.adams@jpmc.com",
28        "company": "Salesforce",
29        "extendedFields": []
30    }
31}

プロパティ

名前	型	説明	必須か省略可能	使用可能なバージョン
`assignedResources`	Assigned Resource Input[]	サービス予定に割り当てられたサービスリソース。	省略可能	48.0
`lead`	Lead Input[]	見込み客またはリード。	`serviceAppointment` が指定されていない場合は必須	48.0
`schedulingPolicyId`	String	`AppointmentSchedulingPolicy` オブジェクトの ID。リクエストボディでスケジュールポリシーが渡されない場合、デフォルトの設定が使用されます。時間枠の決定時に使用される唯一のスケジュールポリシー設定は、取引先訪問時間の適用です。	省略可能	48.0
`serviceAppointment`	Service Appointment Input[]	顧客のサービス作業を完了するための予定。	`lead` が指定されていない場合は必須	48.0

POST のレスポンスボディ

Service Appointment Output

Connect REST API Developer Guide (Connect REST API 開発者ガイド)

サービス予定