Créer une propriété étendue à valeurs multiplesCreate multi-value extended property

Espace de noms: microsoft.graphNamespace: microsoft.graph

Créez une ou plusieurs propriétés étendues à valeurs multiples dans une instance nouvelle ou existante d’une ressource.Create one or more multi-value extended properties in a new or existing instance of a resource.

Les ressources utilisateur suivantes sont prises en charge :The following user resources are supported:

Les ressources de groupe suivantes sont également prises en charge :As well as the following group resources:

Consultez la rubrique relative à la vue d’ensemble des propriétés étendues pour savoir quand utiliser les extensions d’ouverture ou les propriétés étendues, et comment spécifier les propriétés étendues.See Extended properties overview for more information about when to use open extensions or extended properties, and how to specify extended properties.

AutorisationsPermissions

En fonction de la ressource dans laquelle vous créez la propriété étendue et du type d’autorisation (délégué ou application) que vous demandez, l’autorisation spécifiée dans le tableau suivant est le minimum requis pour appeler cette API.Depending on the resource you're creating the extended property in and the permission type (delegated or application) you request, the permission specified in the following table is the minimum required to call this API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.To learn more, including how to choose permissions, see Permissions.

Ressource prise en chargeSupported resource Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) ApplicationApplication
calendarcalendar Calendars.ReadWriteCalendars.ReadWrite Calendars.ReadWriteCalendars.ReadWrite Calendars.ReadWriteCalendars.ReadWrite
contactcontact Contacts.ReadWriteContacts.ReadWrite Contacts.ReadWriteContacts.ReadWrite Contacts.ReadWriteContacts.ReadWrite
contactFoldercontactFolder Contacts.ReadWriteContacts.ReadWrite Contacts.ReadWriteContacts.ReadWrite Contacts.ReadWriteContacts.ReadWrite
eventevent Calendars.ReadWriteCalendars.ReadWrite Calendars.ReadWriteCalendars.ReadWrite Calendars.ReadWriteCalendars.ReadWrite
group calendargroup calendar Group.ReadWrite.AllGroup.ReadWrite.All Non pris en chargeNot supported Non pris en chargeNot supported
group eventgroup event Group.ReadWrite.AllGroup.ReadWrite.All Non pris en chargeNot supported Non pris en chargeNot supported
group postgroup post Group.ReadWrite.AllGroup.ReadWrite.All Non pris en chargeNot supported Non pris en chargeNot supported
mailFoldermailFolder Mail.ReadWriteMail.ReadWrite Mail.ReadWriteMail.ReadWrite Mail.ReadWriteMail.ReadWrite
messagemessage Mail.ReadWriteMail.ReadWrite Mail.ReadWriteMail.ReadWrite Mail.ReadWriteMail.ReadWrite

Requête HTTPHTTP request

Vous pouvez créer des propriétés étendues dans une instance de la ressource nouvelle ou existante.You can create extended properties in a new or existing resource instance.

Pour créer une ou plusieurs propriétés étendues dans une nouvelle instance de la ressource, utilisez la même demande REST que celle utilisée lors de la création de l’instance et incluez les propriétés de la nouvelle instance de la ressource et propriété étendue dans le corps de la requête. Notez que certaines ressources prennent en charge la création de plusieurs façons. Pour plus d’informations sur la création de ces instances de ressources, consultez les rubriques correspondantes pour la création d’un message, mailFolder, événement, calendrier, contact, contactFolder, événement de groupe et billet de groupe.To create one or more extended properties in a new resource instance, use the same REST request as creating the instance, and include the properties of the new resource instance and extended property in the request body. Note that some resources support creation in more than one way. For more information on creating these resource instances, see the corresponding topics for creating a message, mailFolder, event, calendar, contact, contactFolder, group event, and group post.

Voici la syntaxe des demandes.The following is the syntax of the requests.

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

Pour créer une ou plusieurs propriétés étendues dans une instance de ressource existante, spécifiez l’instance dans la demande et incluez la propriété étendue dans le corps de la requête.To create one or more extended properties in an existing resource instance, specify the instance in the request, and include the extended property in the request body.

Remarque Vous ne pouvez pas créer une propriété étendue dans un billet de groupe existant.Note You cannot create an extended property in an existing group post.

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}

En-têtes de demandeRequest headers

NomName ValeurValue
AutorisationAuthorization Porteur {token}. Obligatoire.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

Corps de la demandeRequest body

Indiquez le corps JSON de chaque objet multiValueLegacyExtendedProperty dans la propriété de la collection multiValueExtendedProperties de l’instance de la ressource.Provide a JSON body of each multiValueLegacyExtendedProperty object in the multiValueExtendedProperties collection property of the resource instance.

PropriétéProperty TypeType DescriptionDescription
multiValueExtendedPropertiesmultiValueExtendedProperties Collection multiValueLegacyExtendedPropertymultiValueLegacyExtendedProperty collection Tableau d’une ou plusieurs propriétés étendues à valeurs multiples.An array of one or more multi-valued extended properties.
idid ChaîneString Pour chaque propriété de la collection multiValueExtendedProperties, spécifiez ce paramètre pour identifier la propriété. Il doit respecter l’un des formats pris en charge. Consultez la rubrique relative à la vue d’ensemble des propriétés étendues Outlook pour en savoir plus. Obligatoire.For each property in the multiValueExtendedProperties collection, specify this to identify the property. It must follow one of the supported formats. See Outlook extended properties overview for more information. Required.
valuevalue chaînestring Pour chaque propriété de la collection multiValueExtendedProperties, spécifiez la valeur de propriété. Obligatoire.For each property in the multiValueExtendedProperties collection, specify the property value. Required.

Lors de la création d’une propriété étendue dans une nouvelle instance de la ressource, outre la nouvelle collection multiValueExtendedProperties , fournissez une représentation JSON de cette instance de la ressource également (c’est-à-dire un message, mailFolder, Event, etc.).When creating an extended property in a new resource instance, in addition to the new multiValueExtendedProperties collection, provide a JSON representation of that resource instance as well (that is, a message, mailFolder, event, etc.).

RéponseResponse

Code de réponseResponse code

Une opération réussie de création d’une propriété étendue dans une nouvelle instance de ressource renvoie 201 Created, sauf dans un nouveau billet de groupe, selon la méthode utilisée, l’opération peut renvoyer 200 OK ou 202 Accepted.An operation successful in creating an extended property in a new resource instance returns 201 Created, except in a new group post, depending on the method used, the operation can return 200 OK or 202 Accepted.

Dans une instance de ressource existante, une opération de création réussie renvoie 200 OK.In an existing resource instance, a successful create operation returns 200 OK.

Corps de la réponseResponse body

Lorsque vous créez une propriété étendue dans une ressource prise en charge autre que group post, la réponse inclut uniquement l’instance nouvelle ou existante, mais pas la nouvelle propriété étendue. Pour afficher la propriété étendue nouvellement créée, obtenez l’instance développée avec la propriété étendue.When creating an extended property in a supported resource other than group post, the response includes only the new or existing instance but not the new extended property. To see the newly created extended property, get the instance expanded with the extended property.

Lorsque vous créez une propriété étendue dans un nouveau billet de groupe, la réponse inclut uniquement un code de réponse, mais pas le nouveau billet ni la propriété étendue. Vous ne pouvez pas créer une propriété étendue dans un billet de groupe existant.When creating an extended property in a new group post, the response includes only a response code but not the new post nor the extended property. You cannot create an extended property in an existing group post.

ExempleExample

Demande 1Request 1

Le premier exemple crée une propriété étendue à valeurs multiples dans un nouvel événement dans la même opération POST. Outre les propriétés que vous incluriez normalement pour un nouvel événement, le corps de la demande inclut la collection multiValueExtendedProperties qui contient une seule propriété étendue. Le corps de la demande inclut les informations suivantes sur la propriété étendue à valeurs multiples :The first example creates a multi-value extended property in a new event all in the same POST operation. Apart from the properties you'd normally include for a new event, the request body includes the multiValueExtendedProperties collection which contains one extended property. The request body includes the following for that multi-value extended property:

  • id, qui spécifie la propriété sous la forme d’un tableau de chaînes avec le GUID spécifié et le nom Recreation.id which specifies the property as an array of strings with the specified GUID and the name Recreation.
  • value, qui spécifie Recreation sous forme d’un tableau de 3 valeurs de chaîne, ["Food", "Hiking", "Swimming"].value which specifies Recreation as an array of 3 string values, ["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"]
     }
  ]
}
Réponse 1Response 1

Une réponse correcte est indiquée par un code de réponse HTTP 201 Created et inclut le nouvel événement dans le corps de la réponse, semblable à la réponse de créer simplement un événement. La réponse n’inclut pas les propriétés étendues nouvellement créées.A successful response is indicated by an HTTP 201 Created response code, and includes the new event in the response body, similar to the response from creating just an event. The response does not include any newly created extended properties.

Pour afficher la propriété étendue nouvellement créée, obtenez l’événement développé avec la propriété étendue.To see the newly created extended property, get the event expanded with the extended property.


Demande 2Request 2

Le deuxième exemple crée une propriété étendue à valeurs multiples pour le message spécifié . Cette propriété étendue est le seul élément dans la collection multiValueExtendedProperties. Le corps de la demande inclut les informations suivantes sur la propriété étendue :The second example creates one multi-value extended property for the specified message. That extended property is the only element in the multiValueExtendedProperties collection. The request body includes the following for the extended property:

  • id, qui spécifie la propriété sous la forme d’un tableau de chaînes avec le GUID spécifié et le nom Palette.id specifies the property as an array of strings with the specified GUID and the name Palette.
  • value, qui spécifie Palette sous forme de tableau de 3 valeurs de chaîne, ["Green", "Aqua", "Blue"].value specifies Palette as an array of 3 string values, ["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"]
      }
    ]
}
Réponse 2Response 2

Une réponse correcte est indiquée par un code de réponse HTTP 200 OK et inclut le message spécifié dans le corps de la réponse, semblable à la réponse de mettre à jour un message. La réponse n’inclut pas la propriété étendue nouvellement créée.A successful response is indicated by an HTTP 200 OK response code, and includes the specified message in the response body, similar to the response from updating a message. The response does not include the newly created extended property.

Pour afficher la propriété étendue nouvellement créée, obtenez le message développé avec la propriété étendue.To see the newly created extended property, get the message expanded with the extended property.