Поделиться через

Замена смены

  • Статья

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

Замените существующую смену.

Если указанное shift не существует, этот метод возвращает 404 Not found.

Продолжительность смены не может быть меньше 1 минуты или больше 24 часов.

Разрешения

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

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

HTTP-запрос

PUT /teams/{teamId}/schedule/shifts/{shiftId}

Заголовки запросов

Заголовок Значение
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.
MS-APP-ACTS-AS Идентификатор пользователя (GUID). Требуется только в том случае, если маркер авторизации является маркером приложения; В противном случае — необязательно.

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

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

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

Свойство Тип Описание
draftShift shiftItem Черновик изменений в смене. Черновые изменения видны только руководителям. Изменения видны сотрудникам при совместном доступе, что копирует изменения из draftShift в свойство sharedShift . Параметр draftOpenShift или sharedOpenShift должен иметь значение null.
isStagedForDeletion Логический Сдвиг помечается для удаления, процесс, который завершается при совместном использовании расписания. Необязательный параметр.
schedulingGroupId String Идентификатор группы планирования, частью включаемой в смену . Обязательный элемент.
sharedShift shiftItem Общая версия этой смены , которую могут просматривать как сотрудники, так и руководители. Обновления свойству sharedShift отправлять уведомления пользователям в клиенте Teams. Параметр draftOpenShift или sharedOpenShift должен иметь значение null.
userId String Идентификатор пользователя, назначенного смене. Обязательно.

Отклик

В случае успешного 204 No Content выполнения этот метод возвращает код ответа и пустое содержимое. Если запрос задает Prefer заголовок с return=representation предпочтением, то этот метод возвращает код отклика 200 OK и объект shift в тексте отклика.

Пример

Запрос

Ниже показан пример запроса.

PUT https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/shifts/{shiftId}
Content-type: application/json

{
  "userId": "5ca83ce7-291d-43b7-bf53-af79eef4bc1d",
  "draftShift": {
    "displayName": null,
    "startDateTime": "2024-10-08T15:00:00Z",
    "endDateTime": "2024-10-09T00:00:00Z",
    "theme": "blue",
    "notes": null,
    "activities": []
  },
  "sharedShift": null,
  "isStagedForDeletion": false
}

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 204 No Content