Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Представляет план в Microsoft 365. План принадлежит группе или пользователю . Планы содержат коллекцию plannerTasks. Планы также могут содержать коллекцию plannerBuckets. Каждому объекту plan соответствует объект details, который может содержать дополнительные сведения о плане. Дополнительные сведения об отношениях, которыми связаны группы, планы и задачи, см. в статье Планировщик.
Методы
| Метод | Возвращаемый тип | Описание |
|---|---|---|
| Создание | plannerPlan | Создайте объект plannerPlan . |
| Получение | plannerPlan | Считывание свойств и связей объекта plannerPlan. |
| Обновление | plannerPlan | Обновление объекта plannerPlan. |
| Delete | Нет | Удаление объекта plannerPlan. |
| план Архив | plannerPlan | Архив объект plannerPlan. |
| Неархивный план | plannerPlan | Отмена иерархии архивного объекта plannerPlan . |
| Перемещение в контейнер | plannerPlan | Перемещение объекта plannerPlan из одного plannerPlanContainer в другой. |
| Перечисление контейнеров планов | Коллекция plannerBucket | Получение коллекции объектов plannerBucket. |
| Перечисление задач планов | Коллекция объектов plannerTask | Получение коллекции объектов plannerTask. |
| Получение дельты | Коллекция объектов plannerPlan | Получение вновь созданных, обновленных или удаленных объектов plannerPlan в группе или контейнере типа plannerRoster без необходимости выполнять полное считывание всей коллекции ресурсов. |
| Получение прав на использование | planUsageRight | Получите права на использование для определенного плана на основе назначения метки конфиденциальности и разрешений запрашивающего пользователя. |
Свойства
| Свойство | Тип | Описание |
|---|---|---|
| archivalInfo | plannerArchivalInfo | Только для чтения. Допускается значение null. Содержит сведения о том, кто заархивировали или разархивировали план и почему. |
| контейнер | plannerPlanContainer | Определяет контейнер плана. Укажите все свойства или укажите только URL-адрес, containerId и тип. После установки это свойство невозможно обновить. Он изменяется при перемещении плана из одного контейнера в другой с использованием перемещения плана в контейнер. Обязательно. |
| contentSensitivityLabelAssignment | contentSensitivityLabelAssignment | Назначение метки конфиденциальности для плана. Используется для классификации и защиты содержимого плана на основе политик организации. Это свойство имеет значение, null если метка конфиденциальности не назначена. Необязательный параметр. |
| Контекстах | plannerPlanContextCollection; | Только для чтения. Другие пользовательские интерфейсы, в которых используется этот план, представлены в виде записей plannerPlanContext . |
| createdBy | identitySet | Только для чтения. Пользователь, создавший этот план. |
| createdDateTime | DateTimeOffset | Только для чтения. Дата и время создания плана. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. |
| creationSource | plannerPlanCreation | Содержит сведения о происхождении плана. |
| id | String | Только для чтения. Идентификатор плана. Он содержит 28 символов и учитывает регистр. Проверка формата проводится для службы. |
| isArchived | Boolean | Только для чтения. Если задано значение true, план архивируется. Архивный план доступен только для чтения. |
| title | String | Обязательный. Название плана. |
| sharedWithContainers | коллекция plannerSharedWithContainer | Список контейнеров, которым предоставлен общий доступ к плану. |
| владелец (не рекомендуется) | String | Вместо этого используйте свойство контейнера. Идентификатор группы, которая является владельцем плана. После установки это свойство невозможно обновить. Это свойство не возвращает допустимый идентификатор группы, если контейнер плана не является группой. |
Связи
| Связь | Тип | Описание |
|---|---|---|
| buckets | Коллекция объектов plannerBucket | Коллекция контейнеров в плане. Только для чтения. Допускается значение null. |
| details | plannerPlanDetails | Дополнительные сведения о плане. Только для чтения. Допускается значение null. |
| tasks | Коллекция объектов plannerTask | Коллекция задач в плане. Только для чтения. Допускается значение null. |
Представление JSON
В следующем представлении JSON показан тип ресурса.
{
"archivalInfo": {"@odata.type": "microsoft.graph.plannerArchivalInfo"},
"container": {"@odata.type": "microsoft.graph.plannerPlanContainer"},
"contentSensitivityLabelAssignment": {"@odata.type": "microsoft.graph.contentSensitivityLabelAssignment"},
"contexts": {"@odata.type": "microsoft.graph.plannerPlanContextCollection"},
"createdBy": {"@odata.type": "microsoft.graph.identitySet"},
"createdDateTime": "String (timestamp)",
"creationSource": {"@odata.type": "#microsoft.graph.plannerPlanCreation"},
"id": "String (identifier)",
"isArchived": "Boolean",
"owner": "String",
"sharedWithContainers": [{"@odata.type": "microsoft.graph.plannerSharedWithContainer"}],
"title": "String"
}