Обновление bookingservice

Статья
03/10/2024

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Обновите свойства объекта bookingService в указанном bookingBusiness.

Ниже приведены некоторые примеры, которые можно настроить для службы.

ЦЕНА
Обычная продолжительность встречи
Reminders
Любой буфер времени для настройки до или после завершения службы
Параметры политики планирования , такие как минимальное уведомление о бронировании или отмене, а также возможность выбора определенных сотрудников для встречи.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	✅	✅	❌

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения	Разрешения с наименьшими привилегиями	Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись)	Bookings.ReadWrite.All	Bookings.Manage.All
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.	Не поддерживается.
Приложение	Bookings.ReadWrite.All	Bookings.Manage.All

HTTP-запрос

PATCH /solutions/bookingbusinesses/{id}/services/{id}

Необязательные заголовки запросов

Имя	Описание
Авторизация	Bearer {код}. Обязательно.

Текст запроса

В тексте запроса укажите значения для соответствующих полей, которые необходимо обновить. Существующие свойства, которые не включены в текст запроса, сохраняют свои предыдущие значения или пересчитываются на основе изменений других значений свойств. Для достижения оптимальной производительности не включайте существующие значения, которые не изменились.

Свойство	Тип	Описание
defaultDuration	Duration (Длительность)	Длина службы по умолчанию, представленная в числах дней, часов, минут и секунд. Например, P11D23H59M59.99999999999S.
defaultLocation	location	Физическое расположение службы по умолчанию.
defaultPrice	Двойное с плавающей точкой	Денежная цена по умолчанию для службы.
defaultPriceType	bookingPriceType	Способ оплаты службы по умолчанию. Возможные значения: `undefined`, `fixedPrice`, `startingAt`, `hourly`, `free`, `priceVaries`, `callUs`, `notSet`, `unknownFutureValue`.
defaultReminders	коллекция bookingReminder	Набор напоминаний по умолчанию для встречи этой службы. Значение этого свойства доступно только при считывании этого bookingService по его идентификатору.
description	String	Текстовое описание службы.
displayName	String	Имя службы.
id	String	Только для чтения.
isAnonymousJoinEnabled	Логический	`True` Если url-адрес для анонимного присоединения к встрече (anonymousJoinWebUrl) создается для встречи, забронированной для этой службы.
isCustomerAllowedToManageBooking	Логический	Указывает, что клиент может управлять заказами, созданными сотрудниками. Значение по умолчанию — `false`.
isHiddenFromCustomers	Логический	Значение True означает, что эта служба недоступна клиентам для бронирования.
isLocationOnline	Логический	Значение True указывает, что встречи для службы проводятся в режиме онлайн. Значение по умолчанию — `false`.
languageTag	String	Язык страницы самостоятельного резервирования.
notes	String	Дополнительные сведения об этой службе.
postBuffer	Duration (Длительность)	Время, необходимое для буфера после окончания встречи для этой службы, и до следующей встречи клиента можно забронировать.
preBuffer	Duration (Длительность)	Время буфера до начала встречи для этой службы.
schedulingPolicy	bookingSchedulingPolicy	Набор политик, определяющих способ создания и управления встречами для этого типа службы.
smsNotificationsEnabled	Логический	Значение True указывает, что клиентам можно отправлять SMS-уведомления о назначении службы. Значение по умолчанию — `false`.
staffMemberIds	Коллекция строк	Представляет тех сотрудников , которые предоставляют эту службу.
customQuestions	Коллекция bookingQuestionAssignment	Он содержит набор пользовательских вопросов, связанных с определенной службой. Необязательный параметр.
maximumAttendeesCount	Int32	Максимальное число клиентов, разрешенное в службе.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 204 No content. Он не возвращает ничего в теле ответа.

Пример

Запрос

В следующем примере обновляется длительность указанной службы.

PATCH https://graph.microsoft.com/beta/solutions/bookingbusinesses/contosolunchdelivery@contoso.com/services/57da6774-a087-4d69-b0e6-6fb82c339976
Content-type: application/json

{
    "@odata.type":"#microsoft.graph.bookingService",
    "defaultDuration":"PT30M"
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new BookingService
{
	OdataType = "#microsoft.graph.bookingService",
	DefaultDuration = TimeSpan.Parse("PT30M"),
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Solutions.BookingBusinesses["{bookingBusiness-id}"].Services["{bookingService-id}"].PatchAsync(requestBody);

Важно!

Пакеты SDK для Microsoft Graph по умолчанию используют версию API версии 1.0 и поддерживают не все типы, свойства и API, доступные в бета-версии. Дополнительные сведения о доступе к бета-API с помощью SDK см. в статье Использование пакетов Microsoft Graph SDK с бета-API.

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.



mgc-beta solutions booking-businesses services patch --booking-business-id {bookingBusiness-id} --booking-service-id {bookingService-id} --body '{\
    "@odata.type":"#microsoft.graph.bookingService",\
    "defaultDuration":"PT30M"\
}\
'

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.



// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  abstractions "github.com/microsoft/kiota-abstractions-go"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewBookingService()
defaultDuration , err := abstractions.ParseISODuration("PT30M")
requestBody.SetDefaultDuration(&defaultDuration) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
services, err := graphClient.Solutions().BookingBusinesses().ByBookingBusinessId("bookingBusiness-id").Services().ByBookingServiceId("bookingService-id").Patch(context.Background(), requestBody, nil)

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

BookingService bookingService = new BookingService();
bookingService.setOdataType("#microsoft.graph.bookingService");
PeriodAndDuration defaultDuration = PeriodAndDuration.ofDuration(Duration.parse("PT30M"));
bookingService.setDefaultDuration(defaultDuration);
BookingService result = graphClient.solutions().bookingBusinesses().byBookingBusinessId("{bookingBusiness-id}").services().byBookingServiceId("{bookingService-id}").patch(bookingService);

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


const options = {
	authProvider,
};

const client = Client.init(options);

const bookingService = {
    '@odata.type':'#microsoft.graph.bookingService',
    defaultDuration: 'PT30M'
};

await client.api('/solutions/bookingbusinesses/contosolunchdelivery@contoso.com/services/57da6774-a087-4d69-b0e6-6fb82c339976')
	.version('beta')
	.update(bookingService);

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\BookingService;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new BookingService();
$requestBody->setOdataType('#microsoft.graph.bookingService');
$requestBody->setDefaultDuration(new \DateInterval('PT30M'));

$result = $graphServiceClient->solutions()->bookingBusinesses()->byBookingBusinessId('bookingBusiness-id')->services()->byBookingServiceId('bookingService-id')->patch($requestBody)->wait();

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


from msgraph import GraphServiceClient
from msgraph.generated.models.booking_service import BookingService

graph_client = GraphServiceClient(credentials, scopes)

request_body = BookingService(
	odata_type = "#microsoft.graph.bookingService",
	default_duration = "PT30M",
)

result = await graph_client.solutions.booking_businesses.by_booking_business_id('bookingBusiness-id').services.by_booking_service_id('bookingService-id').patch(request_body)

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Отклик

Ниже приводится пример отклика.

HTTP/1.1 204 No Content

Share via

Обновление bookingservice

Разрешения

HTTP-запрос

Необязательные заголовки запросов

Текст запроса

Отклик

Пример

Запрос

Отклик

Обратная связь

Обратная связь

Дополнительные ресурсы