Criar MailFolderCreate MailFolder

Namespace: microsoft.graphNamespace: microsoft.graph

Use essa API para criar uma nova mailfolder filha.Use this API to create a new child mailfolder.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) Mail.ReadWriteMail.ReadWrite
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Mail.ReadWriteMail.ReadWrite
AplicativoApplication Mail.ReadWriteMail.ReadWrite

Solicitação HTTPHTTP request

POST /me/mailFolders/{id}/childFolders
POST /users/{id | userPrincipalName}/mailFolders/{id}/childFolders

Especifique a pasta pai na URL de consulta como uma ID de pasta ou um nome de pasta conhecido.Specify the parent folder in the query URL as a folder ID, or a well-known folder name. Confira uma lista de nomes de pasta comuns com suporte em Tipo de recurso mailFolder.For a list of supported well-known folder names, see mailFolder resource type.

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization Bearer {token}.Bearer {token}. Obrigatório.Required.
Content-TypeContent-Type application/json.application/json. Obrigatório.Required.

Corpo da solicitaçãoRequest body

Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.In the request body, provide a JSON object with the following parameters. DisplayName é a única propriedade gravável para um objeto mailFolder .displayName is the only writable property for a mailFolder object.

ParâmetroParameter TipoType DescriçãoDescription
displayNamedisplayName StringString O nome de exibição da nova pasta.The display name of the new folder.

RespostaResponse

Se bem-sucedido, este método retorna 201 Created um código de resposta e um recurso mailFolder no corpo da resposta.If successful, this method returns 201 Created response code and a mailFolder resource in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

POST https://graph.microsoft.com/v1.0/me/mailFolders/{id}/childFolders
Content-type: application/json
Content-length: 159

{
  "displayName": "displayName-value",
}
RespostaResponse

Veja a seguir um exemplo da resposta.Here is an example of the response.

Observação:  o objeto de resposta mostrado aqui pode ser encurtado por questões de legibilidade.Note: The response object shown here might be shortened for readability. Todas as propriedades serão retornadas de uma chamada real.All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 179

{
  "displayName": "displayName-value",
  "parentFolderId": "parentFolderId-value",
  "childFolderCount": 99,
  "unreadItemCount": 99,
  "totalItemCount": 99,
  "id": "id-value"
}