Тип ресурса plannerPlan

  • Статья

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

Важно!

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

Представляет план в Microsoft 365. План принадлежит группе или пользователю . Планы содержат коллекцию plannerTasks. Планы также могут содержать коллекцию plannerBuckets. Каждому объекту plan соответствует объект details, который может содержать дополнительные сведения о плане. Дополнительные сведения об отношениях, которыми связаны группы, планы и задачи, см. в статье Планировщик.

Методы

Метод Возвращаемый тип Описание
Получение plannerPlan plannerPlan Считывание свойств и связей объекта plannerPlan.
Перечисление контейнеров Коллекция plannerBucket Получение коллекции объектов plannerBucket.
Перечисление задач Коллекция объектов plannerTask Получение коллекции объектов plannerTask.
Обновление plannerPlan Обновление объекта plannerPlan.
Delete Нет Удаление объекта plannerPlan.
Получение дельты Коллекция объектов plannerPlan Получение вновь созданных, обновленных или удаленных объектов plannerPlan в группе или контейнере типа plannerRoster без необходимости выполнять полное считывание всей коллекции ресурсов.
Перемещение plannerPlan в контейнер plannerPlan Перемещение объекта plannerPlan из одного plannerPlanContainer в другой.

Свойства

Свойство Тип Описание
контейнер plannerPlanContainer Определяет контейнер плана. Укажите все свойства или укажите только URL-адрес, containerId и тип. После установки это свойство невозможно обновить. Он изменяется при перемещении плана из одного контейнера в другой с использованием перемещения плана в контейнер. Обязательно.
Контекстах plannerPlanContextCollection; Только для чтения. Другие пользовательские интерфейсы, в которых используется этот план, представлены в виде записей plannerPlanContext .
createdBy identitySet Только для чтения. Пользователь, создавший этот план.
createdDateTime DateTimeOffset Только для чтения. Дата и время создания плана. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
id String Только для чтения. Идентификатор плана. Он содержит 28 символов и учитывает регистр. Проверка формата проводится для службы.
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"
}