Obtenir l’objet singleValueLegacyExtendedPropertyGet singleValueLegacyExtendedProperty

Espace de noms: microsoft.graphNamespace: microsoft.graph

Vous pouvez obtenir une instance de ressource étendue avec une propriété étendue spécifique ou une collection d’instances de ressources incluant des propriétés étendues correspondant à un filtre.You can get a single resource instance expanded with a specific extended property, or a collection of resource instances that include extended properties matching a filter.

À l’aide du paramètre de requête $expand, vous pouvez obtenir l’instance de ressource spécifiée développée avec une propriété étendue spécifique.Using the query parameter $expand allows you to get the specified resource instance expanded with a specific extended property. Utilisez les opérateurs $filter et eq sur la propriétéid pour spécifier la propriété étendue.Use a $filter and eq operator on the id property to specify the extended property. C’est actuellement le seul moyen d’obtenir l’objet singleValueLegacyExtendedProperty qui représente une propriété étendue.This is currently the only way to get the singleValueLegacyExtendedProperty object that represents an extended property.

Pour obtenir des instances de ressources présentant certaines propriétés étendues, utilisez le paramètre de requête $filter et appliquez l’opérateur eq à la propriété id.To get resource instances that have certain extended properties, use the $filter query parameter and apply an eq operator on the id property. En outre, pour les propriétés étendues numériques, appliquez l’un des opérateurs suivants à la propriété value : eq, ne,ge, gt, le ou lt.In addition, for numeric extended properties, apply one of the following operators on the value property: eq, ne,ge, gt, le, or lt. Pour les propriétés étendues de type chaîne, appliquez l’opérateur contains, startswith, eq ou ne à la propriété value.For string-typed extended properties, apply a contains, startswith, eq, or ne operator on value.

Le filtre est appliqué à toutes les instances de la ressource dans la boîte aux lettres de l’utilisateur connecté.The filter is applied to all instances of the resource in the signed-in user's mailbox.

Dans les filtres, le nom de chaîne (Name) défini dans la propriété id d’une propriété étendue doit respecter la casse.Filtering the string name (Name) in the id of an extended property is case-sensitive. Dans les filtres, la propriété value d’une propriété étendue doit respecter la casse.Filtering the value property of an extended property is case-insensitive.

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 à partir de laquelle vous obtenez 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 getting the extended property from 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.ReadCalendars.Read Calendars.ReadCalendars.Read Calendars.ReadCalendars.Read
contactcontact Contacts.ReadContacts.Read Contacts.ReadContacts.Read Contacts.ReadContacts.Read
contactFoldercontactFolder Contacts.ReadContacts.Read Contacts.ReadContacts.Read Contacts.ReadContacts.Read
eventevent Calendars.ReadCalendars.Read Calendars.ReadCalendars.Read Calendars.ReadCalendars.Read
group calendargroup calendar Group.Read.AllGroup.Read.All Non pris en chargeNot supported Non pris en chargeNot supported
group eventgroup event Group.Read.AllGroup.Read.All Non pris en chargeNot supported Non pris en chargeNot supported
group postgroup post Group.Read.AllGroup.Read.All Non pris en chargeNot supported Group.Read.AllGroup.Read.All
mailFoldermailFolder Mail.ReadMail.Read Mail.ReadMail.Read Mail.ReadMail.Read
messagemessage Mail.ReadMail.Read Mail.ReadMail.Read Mail.ReadMail.Read

Requête HTTPHTTP request

Obtenir (GET) une instance de ressource développée avec une propriété étendue qui correspond à un filtreGET a resource instance expanded with an extended property that matches a filter

Obtenez une instance de la ressource développée avec la propriété étendue qui correspond à un filtre appliqué sur la propriété id. Veillez à appliquer le codage URL aux espaces dans la chaîne de filtre.Get a resource instance expanded with the extended property which matches a filter on the id property. Make sure you apply URL encoding to the space characters in the filter string.

Obtenir une instance message :Get a message instance:

GET /me/messages/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')
GET /users/{id|userPrincipalName}/messages/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')
GET /me/mailFolders/{id}/messages/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')

Obtenir une instance mailFolder :Get a mailFolder instance:

GET /me/mailFolders/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')
GET /users/{id|userPrincipalName}/mailFolders/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')

Obtenir une instance event :Get an event instance:

GET /me/events/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')
GET /users/{id|userPrincipalName}/events/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')

Obtenir une instance calendar :Get a calendar instance:

GET /me/calendars/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')
GET /users/{id|userPrincipalName}/calendars/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')

Obtenir une instance contact :Get a contact instance:

GET /me/contacts/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')
GET /users/{id|userPrincipalName}/contacts/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')
GET /me/contactFolders/{id}/contacts/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')
GET /users/{id|userPrincipalName}/contactFolders/{id}/contacts/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')

Obtenir une instance contactFolder :Get a contactFolder instance:

GET /me/contactfolders/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')
GET /users/{id|userPrincipalName}/contactFolders/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')

Obtenir une instance de groupe event :Get a group event instance:

GET /groups/{id}/events/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')

Obtenir une instance de groupe post :Get a group post instance:

GET /groups/{id}/threads/{id}/posts/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')
GET /groups/{id}/conversations/{id}/threads/{id}/posts/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')

Obtenir (GET) des instances de ressources incluant des propriétés étendues numériques qui correspondent à un filtreGET resource instances that include numeric extended properties matching a filter

Obtenez des instances d’une ressource prise en charge dont une propriété étendue numérique correspond à un filtre.Get instances of a supported resource that have a numeric extended property matching a filter. Le filtre utilise l’opérateur eq sur la propriété id et l’un des opérateurs suivants sur la propriété value : eq, ne,ge, gt, le ou lt.The filter uses an eq operator on the id property, and one of the following operators on the value property: eq, ne,ge, gt, le, or lt. Veillez à appliquer le codage URL aux caractères suivants dans la chaîne de filtre (deux-points, barre oblique et espace).Make sure you apply URL encoding to the following characters in the filter string - colon, forward slash, and space.

Les lignes de syntaxe suivantes affichent un filtre qui utilise un opérateur eq sur l’ID et un autre opérateur eq sur la valeur de propriété.The following syntax lines show a filter that uses an eq operator on the id, and another eq operator on the property value. Vous pouvez remplacer l’opérateur eq appliqué à la propriété value par l’un des autres opérateurs (ne, ge, gt, le ou lt) qui s’appliquent aux valeurs numériques.You can substitute the eq operator on the value by any one of the other operators (ne,ge, gt, le, or lt) that apply to numeric values.

Obtenir des instances message :Get message instances:

GET /me/messages?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')
GET /users/{id|userPrincipalName}/messages?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')
GET /me/mailFolders/{id}/messages?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')

Obtenir des instances mailFolder :Get mailFolder instances:

GET /me/mailFolders?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')
GET /users/{id|userPrincipalName}/mailFolders?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')

Obtenir des instances event :Get event instances:

GET /me/events?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')
GET /users/{id|userPrincipalName}/events?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')

Obtenir des instances calendar :Get calendar instances:

GET /me/calendars?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')
GET /users/{id|userPrincipalName}/calendars?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')

Obtenir des instances contact :Get contact instances:

GET /me/contacts?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')
GET /users/{id|userPrincipalName}/contacts?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')
GET /me/contactFolders/{id}/contacts?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')
GET /users/{id|userPrincipalName}/contactFolders/{id}/contacts?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')

Obtenir des instances contactFolder :Get contactFolder instances:

GET /me/contactfolders?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')
GET /users/{id|userPrincipalName}/contactFolders?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')

Obtenir des instances de groupe event :Get group event instances:

GET /groups/{id}/events?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')

Obtenir des instances de groupe post :Get group post instances:

GET /groups/{id}/threads/{id}/posts?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')
GET /groups/{id}/conversations/{id}/threads/{id}/posts?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')

Obtenir (GET) des instances de ressource comportant des propriétés étendues de type chaîne qui correspondent à un filtreGET resource instances with string-typed extended properties matching a filter

Obtenez des instances de la ressource message ou event comportant une propriété étendue de type chaîne qui correspond à un filtre.Get instances of the message or event resource that have a string-typed extended property matching a filter. Le filtre utilise l’opérateur eq sur la propriété id et l’un des opérateurs suivants sur la propriété value : contains, startswith,eq ou ne.The filter uses an eq operator on the id property, and one of the following operators on the value property: contains, startswith, eq, or ne. Veillez à appliquer le codage URL aux caractères suivants dans la chaîne de filtre (deux-points, barre oblique et espace).Make sure you apply URL encoding to the following characters in the filter string - colon, forward slash, and space.

Obtenir des instances message :Get message instances:

GET /me/messages?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and contains(ep/value, '{property_value}'))
GET /users/{id|userPrincipalName}/messages?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and contains(ep/value, '{property_value}'))
GET /me/mailFolders/{id}/messages?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and contains(ep/value, '{property_value}'))

GET /me/messages?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and startswith(ep/value, '{property_value}'))
GET /users/{id|userPrincipalName}/messages?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and startswith(ep/value, '{property_value}'))
GET /me/mailFolders/{id}/messages?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and startswith(ep/value, '{property_value}'))

GET /me/messages?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')
GET /users/{id|userPrincipalName}/messages?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')
GET /me/mailFolders/{id}/messages?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')

GET /me/messages?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value ne '{property_value}')
GET /users/{id|userPrincipalName}/messages?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value ne '{property_value}')
GET /me/mailFolders/{id}/messages?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value ne '{property_value}')

Obtenir des instances event :Get event instances:

GET /me/events?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and contains(ep/value, '{property_value}'))
GET /users/{id|userPrincipalName}/events?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and contains(ep/value, '{property_value}'))

GET /me/events?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and startswith(ep/value, '{property_value}'))
GET /users/{id|userPrincipalName}/events?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and startswith(ep/value, '{property_value}'))

GET /me/events?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')
GET /users/{id|userPrincipalName}/events?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')

GET /me/events?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value ne '{property_value}')
GET /users/{id|userPrincipalName}/events?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value ne '{property_value}')

Obtenir des instances de groupe event :Get group event instances:

GET /groups/{id}/events?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and contains(ep/value, '{property_value}'))
GET /groups/{id}/events?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and startswith(ep/value, '{property_value}'))
GET /groups/{id}/events?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value eq '{property_value}')
GET /groups/{id}/events?$filter=singleValueExtendedProperties/Any(ep: ep/id eq '{id_value}' and ep/value ne '{property_value}')

Paramètres du chemin d’accèsPath parameters

ParamètreParameter TypeType DescriptionDescription
id_valueid_value StringString ID de la propriété étendue à faire correspondre. 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.The ID of the extended property to match. It must follow one of the supported formats. See Outlook extended properties overview for more information. Required.
property_valueproperty_value StringString Valeur de la propriété étendue à faire correspondre.The value of the extended property to match. Obligatoire lorsqu’elle figure dans la section Requête HTTP ci-dessus.Required where listed in the HTTP request section above. Si l’élément {property_value} n’est pas une chaîne, veillez à convertir ep/value de manière explicite au type de données Edm approprié lors de la comparaison avec {property_value}.If {property_value} is not a string, make sure you explicitly cast ep/value to the appropriate Edm data type when comparing it with {property_value}. Consultez la demande 4 ci-dessous pour obtenir des exemples.See request 4 below for examples.

En-têtes de demandeRequest headers

NomName DescriptionDescription
AutorisationAuthorization Porteur {token}. Obligatoire.Bearer {token}. Required.

Corps de la demandeRequest body

N’indiquez pas le corps de la demande pour cette méthode.Do not supply a request body for this method.

RéponseResponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK.If successful, this method returns a 200 OK response code.

Obtenir (GET) une instance de ressource connue développée avec une propriété étendue qui correspond à un filtreGET resource instance expanded with a matching extended property

Le corps de la réponse comprend un objet représentant l’instance de la ressource demandée, développée avec l’objet singleValueLegacyExtendedProperty correspondant.The response body includes an object representing the requested resource instance, expanded with the matching singleValueLegacyExtendedProperty object.

Obtenir (GET) des instances de ressources contenant une propriété étendue qui correspond à un filtreGET resource instances that contain an extended property matching a filter

Le corps de la réponse comprend un ou plusieurs objets représentant les instances de la ressource qui contiennent une propriété étendue correspondant à un filtre.The response body includes one or more objects representing the resource instances that contain a matching extended property. Le corps de la réponse n’inclut pas la propriété étendue.The response body does not include the extended property.

ExempleExample

Demande 1Request 1

Le premier exemple montre comment obtenir et développer le message spécifié en incluant une propriété étendue à valeur unique. Le filtre renvoie la propriété étendue dont l’ID correspond à la chaîne String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color (avec le codage URL supprimé ici pour une meilleure lisibilité).The first example gets and expands the specified message by including a single-value extended property. The filter returns the extended property that has its id matching the string String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color (with URL encoding removed here for ease of reading).

GET https://graph.microsoft.com/v1.0/me/messages/AAMkAGE1M2_bs88AACHsLqWAAA=?$expand=singleValueExtendedProperties($filter=id%20eq%20'String%20{66f5a359-4659-4830-9070-00047ec6ac6e}%20Name%20Color')

Réponse 1Response 1

Le corps de la réponse inclut toutes les propriétés de la propriété étendue et du message spécifiés qui ont été renvoyées par le filtre.The response body includes all the properties of the specified message and extended property returned from the filter.

Remarque : L’objet message illustré ici est tronqué pour des raisons de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.Note: The message object shown here is truncated for brevity. All of the properties will be returned from an actual call.

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Me/messages/$entity",
    "@odata.id": "https://graph.microsoft.com/v1.0/users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/messages('AAMkAGE1M2_bs88AACHsLqWAAA=')",
    "@odata.etag": "W/\"CQAAABYAAACY4MQpaFz9SbqUDe4+bs88AACbyS4H\"",
    "id": "AAMkAGE1M2_bs88AACHsLqWAAA=",
    "subject": "RE: Talk about emergency prep",
    "sender": {
        "emailAddress": {
            "name": "Christine Irwin",
            "address": "christine@contoso.com"
        }
    },
    "from": null,
    "toRecipients": [
        {
            "emailAddress": {
                "name": "Christine Irwin",
                "address": "christine@contoso.com"
            }
        }
    ],
    "singleValueExtendedProperties@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Me/messages('AAMkAGE1M2_bs88AACHsLqWAAA%3D')/singleValueExtendedProperties",
    "singleValueExtendedProperties": [
        {
            "id": "String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color",
            "value": "Green"
        }
    ]
}

Demande 2Request 2

Le deuxième exemple montre comment obtenir les messages qui possèdent la propriété étendue à valeur unique de type chaîne spécifiée dans le filtre.The second example gets messages that have the string-typed single-value extended property specified in the filter. Le filtre recherche la propriété étendue qui possède les éléments suivants :The filter looks for the extended property that has:

  • un élément id égal à la chaîne String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color (le codage URL est ici supprimé pour une meilleure lisibilité) ;Its id equal to the string String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color (with URL encoding removed here for ease of reading).

  • un élément value égal à la chaîne Green.Its value equal to the string Green.

GET https://graph.microsoft.com/v1.0/me/messages?$filter=singleValueExtendedProperties%2FAny(ep%3A%20ep%2Fid%20eq%20'String%20{66f5a359-4659-4830-9070-00047ec6ac6e}%20Name%20Color'%20and%20ep%2Fvalue%20eq%20'Green')

Réponse 2Response 2

En cas de réussite, la réponse renvoie un code HTTP 200 OK et le corps de la réponse comprend toutes les propriétés des messages dont la propriété étendue correspond au filtre. Le corps de la réponse est semblable à celui de la réponse reçue lors de l’obtention d’une collection d’objets « message ». La réponse n’inclut pas la propriété étendue correspondante.A successful response is indicated by an HTTP 200 OK response code, and the response body includes all the properties of the messages that have the extended property matching the filter. The response body is similar to the response from getting a message collection. The response does not include the matching extended property.

Demande 3Request 3

Le troisième exemple montre comment obtenir les messages qui possèdent la propriété étendue de type chaîne à valeur unique spécifiée dans le filtre.The third example gets messages that have the string-typed single-value extended property specified in the filter. Le filtre recherche la propriété étendue qui possède les éléments suivants :The filter looks for the extended property that has:

  • un élément id égal à la chaîne String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color (le codage URL est ici supprimé pour une meilleure lisibilité) ;Its id equal to the string String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color (with URL encoding removed here for ease of reading).

  • un élément value contenant la chaîne green.Its value containing the string green.

GET https://graph.microsoft.com/v1.0/Me/messages?$filter=singleValueExtendedProperties/any(ep:ep/Id eq 'String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color' and contains(ep/Value, 'green'))

Réponse 3Response 3

En cas de réussite, la réponse renvoie un code HTTP 200 OK et le corps de la réponse comprend toutes les propriétés des messages dont la propriété étendue correspond au filtre.A successful response is indicated by an HTTP 200 OK response code, and the response body includes all the properties of the messages that have the extended property matching the filter. Par exemple, un message contenant une propriété étendue à valeur unique dont la propriété id a pour valeur la chaîne String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color et dont la propriété **value ** a pour valeur Light green correspondrait au filtre et serait incluse dans la réponse.For example, a message that has a single-value extended property with the id equal to the string String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color, and the value Light green, would match the filter and be included in the response.

Le corps de la réponse est semblable à celui de la réponse reçue lors de l’obtention d’une collection d’objets « message ».The response body is similar to the response from getting a message collection. La réponse n’inclut pas la propriété étendue correspondante.The response does not include the matching extended property.

Demande 4Request 4

Les deux exemples suivants montrent comment obtenir des messages qui présentent des propriétés étendues à valeur unique de type autre qu’une chaîne.The next 2 examples show how to get messages that have non-string typed single-value extended properties. Pour faciliter la lecture, ils ne comportent pas le codage URL requis.For ease of reading, they do not include the necessary URL encoding.

L’exemple suivant montre un filtre qui recherche la propriété étendue possédant les éléments suivants :The following example shows a filter that looks for the extended property that has:

  • un élément id correspondant à la chaîne CLSID {00062008-0000-0000-C000-000000000046} Name ConnectorSenderGuid ;Its id matching the string CLSID {00062008-0000-0000-C000-000000000046} Name ConnectorSenderGuid.

  • un élément value qui est le GUID b9cf8971-7d55-4b73-9ffa-a584611b600b.Its value being the GUID b9cf8971-7d55-4b73-9ffa-a584611b600b. Pour comparer la valeur de la propriété avec un GUID, convertissez ep/value en Edm.Guid.To compare the property value with a GUID, cast ep/value to Edm.Guid.

GET https://graph.microsoft.com/v1.0/me/messages?$filter=singleValueExtendedProperties/any(ep:ep/id eq 'CLSID {00062008-0000-0000-C000-000000000046} Name ConnectorSenderGuid' and cast(ep/value, Edm.Guid) eq (b9cf8971-7d55-4b73-9ffa-a584611b600b))

L’exemple suivant montre un filtre qui recherche la propriété étendue possédant les éléments suivants :The next example shows a filter that looks for the extended property that has:

  • un élément id correspondant à la chaîne Integer {66f5a359-4659-4830-9070-00047ec6ac6e} Name Pallete ;Its id matching the string Integer {66f5a359-4659-4830-9070-00047ec6ac6e} Name Pallete.

  • un élément value égal au nombre entier 12.Its value equal to the integer 12. Pour comparer la valeur de propriété avec un nombre entier, convertissez ep/value en Edm.Int32.To compare the property value with an integer, cast ep/value to Edm.Int32.

GET https://graph.microsoft.com/v1.0/me/messages?$filter=singleValueExtendedProperties/any(ep:ep/id eq 'Integer {66f5a359-4659-4830-9070-00047ec6ac6e} Name Pallete' and cast(ep/value, Edm.Int32) eq 12)

Réponse 4Response 4

Pour chacun des deux exemples précédents, en cas de réussite, la réponse renvoie un code HTTP 200 OK et le corps de la réponse comprend toutes les propriétés des messages dont la propriété étendue correspond au filtre.For each of the preceding 2 examples, a successful response is indicated by an HTTP 200 OK response code, and the response body includes all the properties of the messages that have the extended property matching the corresponding filter. Le corps de la réponse est semblable à celui de la réponse reçue lors de l’obtention d’une collection d’objets « message ».The response body is similar to the response from getting a message collection. La réponse n’inclut pas la propriété étendue correspondante.The response does not include the matching extended property.