Compartilhar via


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"
}