Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Um plano do Planner V4. Um plano é detectável por meio de seu próprio contêiner (um grupo, um canal do Teams ou um usuário) e contém buckets, tarefas, metas, dependências e outros dados do Planner. Um plano não tem sentido sem seu contêiner proprietário, portantocontainer, é retornado por padrão junto com id, displayName, createdBy, createdDateTimelastModifiedBylastModifiedDateTimee archivalInfo/isArchived.
Herda de plannerDelta.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List | Coleção de planos | Obtenha uma lista dos objetos de planta e suas propriedades. |
| Create | plan | Crie um novo objeto de plano. |
| Get | plan | Leia as propriedades e relações do objeto de planta . |
| Atualizar | plan | Atualizar as propriedades de um objeto de plano. |
| Delete | Nenhum | Exclua um objeto de plano. |
| Listar buckets | Coleta de bucket | Obtenha uma lista dos objetos de bucket e suas propriedades. |
| Criar bucket | bucket | Crie um novo objeto de bucket. |
| Contextos de lista | Coleção planContextLink | Obtenha uma lista dos objetos planContextLink e suas propriedades. |
| Criar planContextLink | planContextLink | Crie um novo objeto planContextLink. |
| List customFieldDefinitions | Coleção customFieldDefinition | Obtenha uma lista dos objetos customFieldDefinition e suas propriedades. |
| Adicionar customFieldDefinition | customFieldDefinition | Adicione customFieldDefinitions postando na coleção customFieldDefinitions. |
| Remover customFieldDefinitions | Nenhum | Remova um objeto customFieldDefinition . |
| Listar dependências | Coleção de dependências | Obtenha uma lista dos objetos de dependência e suas propriedades. |
| Adicionar dependência | de dependência | Adicione dependências postando na coleção de dependências. |
| Remover dependências | Nenhum | Remover um objeto de dependência . |
| Listar metas | Coleção de metas | Obtenha uma lista dos objetos objetivo e suas propriedades. |
| Adicionar meta | Objetivo | Adicione metas postando na coleção de metas. |
| Remover metas | Nenhum | Remova um objeto de meta . |
| Listar historyItems | coleção historyItem | Obtenha uma lista dos objetos historyItem e suas propriedades. |
| Adicionar historyItem | historyItem | Adicione historyItems postando na coleção historyItems. |
| Remover historyItems | Nenhum | Remova um objeto historyItem . |
| Links de lista | coleção contentLink | Obtenha uma lista dos objetos contentLink e suas propriedades. |
| Criar contentLink | contentLink | Crie um novo objeto contentLink. |
| Listar tarefas | Coleção de tarefas | Obtenha uma lista dos objetos de tarefa e suas propriedades. |
| Adicionar tarefa | task | Adicione tarefas postando na coleção de tarefas. |
| Remover tarefas | Nenhum | Remover um objeto de tarefa . |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| archiveInfo | plannerArchivalInfo | Informações sobre se a entidade está arquivada e quando foi arquivada. |
| calendar | planCalendar | Configurações de calendário de tempo de trabalho para o plano. |
| capabilities | planCapability | Sinalizadores de capacidade somente leitura e computação do servidor que indicam quais recursos opcionais estão habilitados para a entidade. |
| contêiner | planContainer | Identifica o grupo, canal do Teams ou usuário proprietário do plano. Obrigatório e imutável após a criação. |
| contentSensitivityLabelAssignment | contentSensitivityLabelAssignment | O rótulo de confidencialidade atribuído ao conteúdo associado ao plano. |
| creationInfo | creationInfo | Metadados de criação somente leitura para a entidade. |
| displayName | Cadeia de caracteres | Título do plano. |
| duração | Int32 | Duração do plano, em dias. |
| extensions | extensionFieldCollection | Valores do campo de extensão personalizados definidos na entidade. Suporta $select. |
| hasChat | Booliano | Indica se o plano tem um chat associado. |
| id | Cadeia de caracteres | Identificador exclusivo da entidade. Somente leitura. Herdado da entidade |
| lastModifiedBy | identitySet | Identidade do usuário (ou aplicativo) que modificou a entidade pela última vez. Somente leitura. |
| lastModifiedDateTime | DateTimeOffset | Data e hora em que a entidade foi modificada pela última vez. O valor é representado no formato ISO 8601 e está sempre no horário UTC. Somente leitura. |
| planView | planView | Configurações de exibição com escopo de plano, incluindo definições de categoria. |
| sharedWithContainers | Coleção plannerSharedWithContainer | A lista de contêineres (por exemplo, grupos ou canais adicionais) com os quais o plano é compartilhado. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| buckets | Coleta de bucket | A coleção de buckets no plano. Somente leitura. Anulável. |
| contextos | Coleção planContextLink | A coleção de links de contexto que descrevem onde o plano é apresentado. Somente leitura. Anulável. |
| customFieldDefinitions | Coleção customFieldDefinition | A coleção de definições de campos personalizados no plano. Somente leitura. Anulável. |
| de cluster | Coleção de dependências | A coleção de dependências entre itens no plano. Somente leitura. Anulável. |
| Objectivos | Coleção de metas | O conjunto de metas no plano. Somente leitura. Anulável. |
| historyItems | coleção historyItem | A coleção de itens de histórico (auditoria) do plano. Somente leitura. Anulável. |
| links | coleção contentLink | A coleção de links de conteúdo anexados ao plano. Somente leitura. Anulável. |
| tarefas | Coleção de tarefas | A coleção de tarefas no plano. Somente leitura. Anulável. |
Representação JSON
A representação JSON a seguir mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.plan",
"id": "String (identifier)",
"displayName": "String",
"container": {
"@odata.type": "microsoft.graph.planContainer"
},
"calendar": {
"@odata.type": "microsoft.graph.planCalendar"
},
"creationInfo": {
"@odata.type": "microsoft.graph.creationInfo"
},
"lastModifiedBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"lastModifiedDateTime": "String (timestamp)",
"archivalInfo": {
"@odata.type": "microsoft.graph.plannerArchivalInfo"
},
"planView": {
"@odata.type": "microsoft.graph.planView"
},
"contentSensitivityLabelAssignment": {
"@odata.type": "microsoft.graph.contentSensitivityLabelAssignment"
},
"hasChat": "Boolean",
"duration": "Int32",
"sharedWithContainers": [
{
"@odata.type": "microsoft.graph.plannerSharedWithContainer"
}
],
"capabilities": {
"@odata.type": "microsoft.graph.planCapability"
},
"extensions": {
"@odata.type": "microsoft.graph.extensionFieldCollection"
}
}