Compartilhar via

tipo de recurso mailSearchFolder

  • Artigo

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