Тип ресурса plannerPlan

Пространство имен: 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 без необходимости выполнять полное считывание всей коллекции ресурсов.

Свойства

Свойство	Тип	Описание
archivalInfo	plannerArchivalInfo	Только для чтения. Допускается значение null. Содержит сведения о том, кто заархивировали или разархивировали план и почему.
контейнер	plannerPlanContainer	Определяет контейнер плана. Укажите все свойства или укажите только URL-адрес, containerId и тип. После установки это свойство невозможно обновить. Он изменяется при перемещении плана из одного контейнера в другой с использованием перемещения плана в контейнер. Обязательно.
Контекстах	plannerPlanContextCollection;	Только для чтения. Другие пользовательские интерфейсы, в которых используется этот план, представлены в виде записей plannerPlanContext .
createdBy	identitySet	Только для чтения. Пользователь, создавший этот план.
createdDateTime	DateTimeOffset	Только для чтения. Дата и время создания плана. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
id	String	Только для чтения. Идентификатор плана. Он содержит 28 символов и учитывает регистр. Проверка формата проводится для службы.
isArchived	Boolean	Только для чтения. Если задано значение true, план архивируется. Архивный план доступен только для чтения.
title	String	Обязательный. Название плана.
creationSource	plannerPlanCreation	Содержит сведения о происхождении плана.
владелец (не рекомендуется)	String	Вместо этого используйте свойство контейнера. Идентификатор группы, которая является владельцем плана. После установки это свойство невозможно обновить. Это свойство не возвращает допустимый идентификатор группы, если контейнер плана не является группой.
sharedWithContainers	коллекция plannerSharedWithContainer	Список контейнеров, которым предоставлен общий доступ к плану.

Связи

Связь	Тип	Описание
buckets	Коллекция объектов plannerBucket	Коллекция контейнеров в плане. Только для чтения. Допускается значение null.
details	plannerPlanDetails	Дополнительные сведения о плане. Только для чтения. Допускается значение null.
tasks	Коллекция объектов plannerTask	Коллекция задач в плане. Только для чтения. Допускается значение null.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "contexts": {
    "48#19%3Ad128c63941b24733951ea7defd81e550%40thread%2Eskype19%3Ad128c63941b24733951ea7defd81e550%40thread%2Eskype": {
        "@odata.type": "#microsoft.graph.plannerPlanContext",
        "associationType": "Board",
        "createdDateTime": "2015-10-14T00:57:28.4698344Z",
        "displayNameSegments": [
            "Finance Team",
            "Budget Plans"
        ],
        "ownerAppId": "5e3ce6c0-2b1f-4285-8d4b-75ee78787346"
    }
  },
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "creationSource": {"@odata.type": "#microsoft.graph.plannerPlanCreation"},
  "createdDateTime": "String (timestamp)",
  "id": "String (identifier)",
  "container": {
    "@odata.type": "microsoft.graph.plannerPlanContainer",
    "url": "String",
    "containerId": "String",
    "type": "String"
  },
  "sharedWithContainers": [
    {
      "@odata.type": "microsoft.graph.plannerSharedWithContainer"
    }
  ],
  "title": "String"
}