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