Criar propriedade estendida de vários valores

Artigo
05/12/2022
5 minutos para o fim da leitura

Namespace: microsoft.graph

Crie uma ou mais propriedades estendidas de vários valores em uma instância nova ou existente de um recurso.

Há suporte para as seguintes fontes de dados:

Também há suporte para os seguintes recursos de grupo:

grupo calendar
grupo event
grupo post

Confira Visão geral de propriedades estendidas para saber mais sobre quando usar extensões abertas ou propriedades estendidas e sobre como especificar propriedades estendidas.

Permissões

Dependendo do recurso no qual você está criando a propriedade estendida e do tipo de permissão (delegado ou aplicativo) solicitado, a permissão especificada na tabela a seguir é o mínimo necessário para chamar essa API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Recurso com suporte	Delegada (conta corporativa ou de estudante)	Delegada (conta pessoal da Microsoft)	Aplicativo
calendar	Calendars.ReadWrite	Calendars.ReadWrite	Calendars.ReadWrite
contato	Contacts.ReadWrite	Contacts.ReadWrite	Contacts.ReadWrite
contactFolder	Contacts.ReadWrite	Contacts.ReadWrite	Contacts.ReadWrite
evento	Calendars.ReadWrite	Calendars.ReadWrite	Calendars.ReadWrite
grupo calendar	Group.ReadWrite.All	Sem suporte	Incompatível
grupo event	Group.ReadWrite.All	Sem suporte	Incompatível
grupo post	Group.ReadWrite.All	Sem suporte	Incompatível
mailFolder	Mail.ReadWrite	Mail.ReadWrite	Mail.ReadWrite
mensagem	Mail.ReadWrite	Mail.ReadWrite	Mail.ReadWrite

Solicitação HTTP

Você pode criar propriedades estendidas em uma instância de recurso nova ou existente.

Para criar uma ou mais propriedades estendidas em uma nova instância de recurso, use a mesma solicitação REST válida para a criação da instância e inclua as propriedades da nova instância de recurso e a propriedade estendida no corpo da solicitação. Observe que alguns recursos dão suporte à criação de mais de uma maneira. Para saber mais sobre como criar essas instâncias de recurso, confira os tópicos correspondentes para a criação de message, mailFolder, event, calendar, contact, contactFolder, group event e group post.

Veja a seguir a sintaxe das solicitações.

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

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

POST /me/events
POST /users/{id|userPrincipalName}/events

POST /me/calendars
POST /users/{id|userPrincipalName}/calendars

POST /me/contacts
POST /users/{id|userPrincipalName}/contacts

POST /me/contactFolders
POST /users/{id|userPrincipalName}/contactFolders

POST /groups/{id}/events

POST /groups/{id}/threads/{id}/posts/{id}/reply
POST /groups/{id}/conversations/{id}/threads/{id}/posts/{id}/reply
POST /groups/{id}/threads/{id}/reply
POST /groups/{id}/conversations/{id}/threads/{id}/reply
POST /groups/{id}/threads
POST /groups/{id}/conversations

Para criar uma ou mais propriedades estendidas em uma instância de recurso existente, especifique essa instância na solicitação e inclua a propriedade estendida no corpo da solicitação.

Observação Não é possível criar uma propriedade estendida em uma postagem de grupo existente.

PATCH /me/messages/{id}
PATCH /users/{id|userPrincipalName}/messages/{id}
PATCH /me/mailFolders/{id}/messages/{id}

PATCH /me/mailFolders/{id}
PATCH /users/{id|userPrincipalName}/mailFolders/{id}

PATCH /me/events/{id}
PATCH /users/{id|userPrincipalName}/events/{id}

PATCH /me/calendars/{id}
PATCH /users/{id|userPrincipalName}/calendars/{id}

PATCH /me/contacts/{id}
PATCH /users/{id|userPrincipalName}/contacts/{id}

PATCH /me/contactFolders/{id}
PATCH /users/{id|userPrincipalName}/contactFolders/{id}

PATCH /groups/{id}/events/{id}

Cabeçalhos de solicitação

Nome	Valor
Autorização	{token} de portador. Obrigatório.
Content-Type	application/json

Corpo da solicitação

Forneça um corpo JSON de cada objeto multiValueLegacyExtendedProperty na propriedade da coleção multiValueExtendedProperties da instância de recurso.

Propriedade	Tipo	Descrição
multiValueExtendedProperties	Coleção multiValueLegacyExtendedProperty	Uma matriz de uma ou mais propriedades estendidas de vários valores.
id	String	Para cada propriedade na coleção multiValueExtendedProperties, especifique isso para identificar a propriedade. Ele deve seguir um dos formatos com suporte. Para saber mais, confira Visão geral das propriedades estendidas do Outlook. Obrigatório.
valor	string	Para cada propriedade na coleção multiValueExtendedProperties, especifique o valor da propriedade. Obrigatório.

Ao criar uma propriedade estendida em uma nova instância de recurso, além da nova coleção multiValueExtendedProperties, forneça uma representação JSON dessa instância de recurso também (ou seja, uma mensagem, mailFolder, evento etc.).

Resposta

Código da resposta

Uma operação bem-sucedida na criação de uma propriedade estendida em uma nova instância de recurso retorna 201 Created, exceto em uma nova postagem de grupo. Dependendo do método usado, a operação pode retornar 200 OK ou 202 Accepted.

Em uma instância de recurso existente, uma operação de criação bem-sucedida retorna 200 OK.

Corpo da resposta

Ao criar uma propriedade estendida em um recurso com suporte que não seja group post, a resposta inclui apenas a instância nova ou existente, mas não a nova propriedade estendida. Para ver a propriedade estendida recém-criada, obtenha a instância expandida com a propriedade estendida.

Ao criar uma propriedade estendida em uma nova postagem de grupo, a resposta inclui um código de resposta, mas não a nova postagem nem a propriedade estendida. Não é possível criar uma propriedade estendida em uma postagem de grupo existente.

Exemplo

Solicitação 1

O primeiro exemplo cria uma propriedade estendida de vários valores em um novo evento, tudo na mesma operação POST. Além das propriedades que você normalmente incluiria para um novo evento, o corpo da solicitação inclui a coleção multiValueExtendedProperties, que contém uma propriedade estendida. O corpo da solicitação inclui o seguinte para essa propriedade estendida de vários valores:

id, que especifica a propriedade como uma matriz de cadeias de caracteres com o GUID especificado e o nome Recreation.
value, que especifica Recreation como uma matriz de 3 valores de cadeia de caracteres, ["Food", "Hiking", "Swimming"].

POST https://graph.microsoft.com/v1.0/me/events
Content-Type: application/json

{
  "subject": "Family reunion",
  "body": {
    "contentType": "HTML",
    "content": "Let's get together this Thanksgiving!"
  },
  "start": {
      "dateTime": "2015-11-26T09:00:00",
      "timeZone": "Pacific Standard Time"
  },
  "end": {
      "dateTime": "2015-11-29T21:00:00",
      "timeZone": "Pacific Standard Time"
  },
  "attendees": [
    {
      "emailAddress": {
        "address": "Terrie@contoso.com",
        "name": "Terrie Barrera"
      },
      "type": "Required"
    },
    {
      "emailAddress": {
        "address": "Lauren@contoso.com",
        "name": "Lauren Solis"
      },
      "type": "Required"
    }
  ],
  "multiValueExtendedProperties": [
     {
           "id":"StringArray {66f5a359-4659-4830-9070-00050ec6ac6e} Name Recreation",
           "value": ["Food", "Hiking", "Swimming"]
     }
  ]
}

Resposta 1

Uma resposta bem-sucedida é indicada por um código de resposta HTTP 201 Created e inclui o novo evento em seu corpo, semelhante à resposta da criação de apenas um evento. A resposta não inclui propriedades estendidas recém-criadas.

Para ver a propriedade estendida recém-criada, obtenha o evento expandido com a propriedade estendida.

Solicitação 2

O segundo exemplo cria uma propriedade estendida de vários valores para a mensagem especificada. Essa propriedade estendida é o único elemento na coleção multiValueExtendedProperties. O corpo da solicitação inclui o seguinte para essa propriedade estendida:

id especifica a propriedade como uma matriz de cadeias de caracteres com o GUID especificado e o nome Palette.
value especifica Palette como uma matriz de 3 valores de cadeia de caracteres, ["Green", "Aqua", "Blue"].

PATCH https://graph.microsoft.com/v1.0/me/messages('AAMkAGE1M2_as77AACHsLrBBBA=')

Content-Type: application/json

{
  "multiValueExtendedProperties": [
      {
         "id":"StringArray {66f5a359-4659-4830-9070-00049ec6ac6e} Name Palette",
         "value":["Green", "Aqua", "Blue"]
      }
    ]
}

Resposta 2

Uma resposta bem-sucedida é indicada por um código de resposta HTTP 200 OK e inclui a mensagem especificada em seu corpo, semelhante à resposta da atualização de uma mensagem. A resposta não inclui a propriedade estendida recém-criada.

Para ver a propriedade estendida recém-criada, obtenha a mensagem expandida com a propriedade estendida.