caixa de correio Tipo de recurso pasta

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.

Representa uma pasta na caixa de correio de um utilizador, como a caixa de entrada, rascunhos ou outras pastas criadas pelo utilizador. As pastas podem conter vários itens de caixa de correio, como mensagens, eventos, contactos, outros itens do Outlook e pastas subordinadas.

Este recurso suporta consultas delta para controlar adições incrementais, eliminações e atualizações ao fornecer uma função delta . Também suporta propriedades expandidas de valor único e de múltiplos valores para armazenar e aceder a dados personalizados que ainda não estão expostos nos metadados do Microsoft API do Graph.

Métodos

Método	Tipo de retorno	Descrição
List	mailbox Coleção de pastas	Obtenha todos os objetos mailboxFolder na caixa de correio especificada, incluindo quaisquer pastas de pesquisa.
Create	caixa de correioPasta	Criar uma nova caixa de correioPasta ou caixa de correio subordinadaPasta na caixa de correio de um utilizador.
Get	caixa de correioPasta	Leia as propriedades e relações de um objeto mailboxFolder .
Atualizar	caixa de correioPasta	Atualizar caixa de correioPropriedades da pasta, como displayName numa caixa de correio.
Delete	Nenhum	Eliminar uma caixa de correioPasta ou uma caixa de correio subordinadaPasta numa caixa de correio.
Obter delta	mailbox Coleção de pastas	Obtenha um conjunto de objetos mailboxFolder que foram adicionados, eliminados ou removidos da caixa de correio do utilizador.
Listar pastas de caixa de correio subordinadas	mailbox Coleção de pastas	Obtenha a caixa de correio Coleção de pastas na caixa de correio especificadaPasta numa caixa de correio.
Listar itens na pasta	coleção mailboxItem	Obtenha a coleção mailboxItem numa caixa de correio especificadaPasta numa caixa de correio.
Propriedades estendidas
Criar uma propriedade de valor único	caixa de correioPasta	Crie uma ou mais propriedades expandidas de valor único numa pasta de caixa de correio nova ou existente.
Obter uma propriedade de valor único	caixa de correioPasta	Obtenha pastas de caixa de correio que contenham uma propriedade expandida de valor único com $expand ou $filter.
Criar propriedade com múltiplos valores	caixa de correioPasta	Crie uma ou mais propriedades expandidas com múltiplos valores numa pasta de caixa de correio nova ou existente.
Obter propriedade de múltiplos valores	caixa de correioPasta	Obtenha uma pasta de caixa de correio que contenha uma propriedade expandida com vários valores com $expand.

Propriedades

Propriedade	Tipo	Descrição
childFolderCount	Int32	O número de pastas subordinadas imediatas na pasta atual.
displayName	Cadeia de caracteres	O nome a apresentar da pasta.
id	Cadeia de caracteres	O identificador exclusivo da pasta.
parentFolderId	Cadeia de caracteres	O identificador exclusivo da pasta principal desta pasta.
parentMailboxUrl	Cadeia de caracteres	A ligação de encaminhamento para a caixa de correio subjacente real onde a pasta reside fisicamente. A pasta pode ser acedida com GET {parentMailboxUrl}/folders/{id}, que trata todo o URL como uma cadeia opaca. Este método é especialmente importante quando o arquivo de expansão automática está ativado para a caixa de correio de arquivo no local de um utilizador. O conteúdo de arquivo do utilizador pode abranger várias caixas de correio nesses cenários.
totalItemCount	Int32	O número de itens na pasta.
type	Cadeia de caracteres	Descreve o tipo de classe de pasta.

Relações

Relação	Tipo	Descrição
childFolders	mailbox Coleção de pastas	A coleção de pastas subordinadas nesta pasta.
items	coleção mailboxItem	A coleção de itens nesta pasta.
multiValueExtendedProperties	Coleção multiValueLegacyExtendedProperty	A coleção de propriedades expandidas de múltiplos valores definidas para a caixa de correioPasta.
singleValueExtendedProperties	Coleção singleValueLegacyExtendedProperty	A coleção de propriedades expandidas de valor único definidas para a caixa de correioPasta.

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
  "@odata.type": "#microsoft.graph.mailboxFolder",
  "displayName": "String",
  "childFolderCount": "Int32",
  "id": "String (identifier)",
  "parentFolderId": "String",
  "parentMailboxUrl": "String",
  "totalItemCount": "Int32",
  "type": "String"
}