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