tipo de recurso mailSearchFolder

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.

Uma mailSearchFolder é uma pasta virtual na caixa de correio do utilizador que contém todos os itens de e-mail que correspondem aos critérios de pesquisa especificados. mailSearchFolder herda de mailFolder. As pastas de pesquisa podem ser criadas em qualquer pasta na caixa de correio do Exchange Online de um utilizador. No entanto, para que uma pasta de pesquisa seja apresentada no Outlook, Outlook para a Web ou Outlook Live, a pasta tem de ser criada na pasta WellKnownFolderName.SearchFolders .

Ciclo de vida da pasta de pesquisa

O Exchange Online pode eliminar pastas de pesquisa criadas pela sua aplicação por um dos seguintes motivos:

1. As pastas de pesquisa expiram após 45 dias sem utilização.
2. Existem limites no número de pastas de pesquisa que podem ser criadas por pasta de origem. Quando este limite é violado, as pastas de pesquisa mais antigas são eliminadas para dar lugar a novas pastas.

Quando uma pasta de pesquisa é eliminada, a sua aplicação deve criar um novo recurso de pasta de pesquisa e utilizar o mesmo.

Métodos

Método	Tipo de retorno	Descrição
Criar	mailSearchFolder	Crie uma pasta de pesquisa na caixa de correio deste utilizador.
Get	mailSearchFolder	Obtenha a pasta de pesquisa especificada.
Atualizar	mailSearchFolder	Atualize a pasta de pesquisa especificada.
Delete	Nenhum	Elimine a pasta de pesquisa especificada.
Excluir permanentemente	Nenhum	Elimine permanentemente uma pasta de pesquisa de correio e remova os respetivos itens da caixa de correio do utilizador.
Listar pastas filho	Coleção mailFolder	Liste todas as pastas na caixa de correio deste utilizador, incluindo pastas de pesquisa.
Listar mensagens na pasta	Coleção message	Liste todas as mensagens na pasta de pesquisa especificada.

Propriedades

Propriedade	Tipo	Descrição
isSupported	Booliano	Indica se uma pasta de pesquisa é editável através de APIs REST.
includeNestedFolders	Booliano	Indica como a hierarquia da pasta da caixa de correio deve ser percorrida na pesquisa. true significa que deve ser feita uma pesquisa profunda para incluir pastas subordinadas na hierarquia de cada pasta especificada explicitamente em sourceFolderIds. false significa uma pesquisa superficial de apenas cada uma das pastas especificadas explicitamente em sourceFolderIds.
sourceFolderIds	Coleção de cadeias de caracteres	As pastas da caixa de correio que devem ser extraídas.
filterQuery	Cadeia de caracteres	A consulta OData para filtrar as mensagens.

Representação JSON

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

{
  "isSupported": true,
  "includeNestedFolders": true,
  "sourceFolderIds": ["string"],
  "filterQuery": "string"
}