Bookingstaffmember を更新する
名前空間: microsoft.graph
指定した bookingBusiness 内の bookingStaffMember のプロパティを更新します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | Bookings.ReadWrite.All | Bookings.Manage.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | Bookings.ReadWrite.All | Bookings.Manage.All |
HTTP 要求
PATCH /solutions/bookingBusinesses/{id}/staffMembers/{id}
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {code}。 必須です。 |
要求本文
要求本文で、更新するプロパティの値 のみを 指定します。 要求本文に含まれていない既存のプロパティは、以前の値を維持するか、他のプロパティ値の変更に基づいて再計算されます。
次の表に、更新できるプロパティを示します。
| プロパティ | 型 | 説明 |
|---|---|---|
| availabilityIsAffectedByPersonalCalendar | ブール型 | True は、スタッフ メンバーが Microsoft 365 ユーザーの場合、Microsoft Bookings API は Microsoft 365 のスタッフ メンバーの個人用予定表と workingHours プロパティを使用して可用性を判断することを意味します。 |
| displayName | String | 顧客に表示されるスタッフ メンバーの名前。 |
| emailAddress | String | スタッフ メンバーのメール アドレス。 これは、ビジネスと同じ Microsoft 365 テナント内、または別のメール ドメイン内にある場合があります。 このメール アドレスは、 sendConfirmationsToOwner プロパティがビジネスのスケジューリング ポリシーで true に設定されている場合に使用されます。 |
| isEmailNotificationEnabled | ブール型 |
True は、スタッフメンバーに割り当てられた予約が作成または変更されたときに、スタッフメンバーに電子メールで通知されることを示します。 |
| role | bookingStaffRole | ビジネスにおけるスタッフ メンバーの役割。 可能な値は、guest、administrator、viewer、externalGuest、unknownFutureValue、scheduler、teamMember です。 |
| timeZone | String | スタッフ メンバーのタイム ゾーン。 使用可能な値の一覧については、「 dateTimeTimeZone」を参照してください。 |
| useBusinessHours | ブール型 | True は、スタッフ メンバーの可用性が ビジネスの businessHours プロパティによって決定されていることを意味します。 False は、スタッフ メンバーの workingHouse プロパティ設定によって可用性が決定されます。 |
| workingHours | bookingWorkHours コレクション | スタッフメンバーが予約可能な曜日の時間の範囲。 |
応答
成功した場合、このメソッドは 204 No Content 応答コードを返します。 応答本文では何も返されません。
例
要求
次の例では、スタッフ メンバーのスケジュールを変更して、月曜日をオフにします。
PATCH https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/Contosolunchdelivery@contoso.com/staffMembers/8ee1c803-a1fa-406d-8259-7ab53233f148
Content-type: application/json
{
"@odata.type":"#microsoft.graph.bookingStaffMember",
"workingHours":[
{
"@odata.type":"#microsoft.graph.bookingWorkHours",
"day@odata.type":"#microsoft.graph.dayOfWeek",
"day":"monday",
"timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
"timeSlots":[
]
},
{
"@odata.type":"#microsoft.graph.bookingWorkHours",
"day@odata.type":"#microsoft.graph.dayOfWeek",
"day":"tuesday",
"timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
"timeSlots":[
{
"@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
"endTime":"17:00:00.0000000",
"startTime":"08:00:00.0000000"
}
]
},
{
"@odata.type":"#microsoft.graph.bookingWorkHours",
"day@odata.type":"#microsoft.graph.dayOfWeek",
"day":"wednesday",
"timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
"timeSlots":[
{
"@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
"endTime":"17:00:00.0000000",
"startTime":"08:00:00.0000000"
}
]
},
{
"@odata.type":"#microsoft.graph.bookingWorkHours",
"day@odata.type":"#microsoft.graph.dayOfWeek",
"day":"thursday",
"timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
"timeSlots":[
{
"@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
"endTime":"17:00:00.0000000",
"startTime":"08:00:00.0000000"
}
]
},
{
"@odata.type":"#microsoft.graph.bookingWorkHours",
"day@odata.type":"#microsoft.graph.dayOfWeek",
"day":"friday",
"timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
"timeSlots":[
{
"@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
"endTime":"17:00:00.0000000",
"startTime":"08:00:00.0000000"
}
]
}
]
}
応答
次の例は応答を示しています。
HTTP/1.1 204 No Content