singleValueLegacyExtendedProperty abrufenGet singleValueLegacyExtendedProperty

Sie können eine einzelne, mit einer bestimmten erweiterten Eigenschaft erweiterte Ressourceninstanz oder eine Sammlung von Ressourceninstanzen abrufen, die einem Filter entsprechende erweiterte Eigenschaften enthalten.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.

Mit dem Abfrageparameter $expand können Sie die angegebene Ressourceninstanz, erweitert um die angegebene erweiterte Eigenschaft, abrufen.Using the query parameter $expand allows you to get the specified resource instance expanded with a specific extended property. Wenden Sie einen $filter- und einen eq-Operator auf die ID-Eigenschaft an, um die erweiterte Eigenschaft anzugeben.Use a $filter and eq operator on the id property to specify the extended property. Dies ist derzeit die einzige Möglichkeit zum Abrufen des singleValueLegacyExtendedProperty-Objekts, das eine erweiterte Eigenschaft darstellt.This is currently the only way to get the singleValueLegacyExtendedProperty object that represents an extended property.

Um Ressourceninstanzen mit bestimmten erweiterten Eigenschaften abzurufen, verwenden Sie den Abfrageparameter $filter, und wenden Sie einen eq-Operator auf die ID-Eigenschaft an.To get resource instances that have certain extended properties, use the $filter query parameter and apply an eq operator on the id property. Wenden Sie für nummerische erweiterte Eigenschaften zudem einen der folgenden Operatoren auf die Eigenschaft Wert an: eq, ne,ge, gt, le oder lt.In addition, for numeric extended properties, apply one of the following operators on the value property: eq, ne,ge, gt, le, or lt. Für erweiterte Eigenschaften vom Typ Zeichenfolge wenden Sie einen contains-, startswith-, eq-, oder ne-Operator auf den Wert an.For string-typed extended properties, apply a contains, startswith, eq, or ne operator on value.

Der Filter wird auf alle Instanzen der Ressource angewendet, die im Postfach eines angemeldeten Benutzers existieren.The filter is applied to all instances of the resource in the signed-in user's mailbox.

Beim Filtern des Namens der Zeichenfolge (Name) in der ID einer erweiterten Eigenschaft wird die Groß-/Kleinschreibung beachtet.Filtering the string name (Name) in the id of an extended property is case-sensitive. Beim Filtern der Eigenschaft Wert einer erweiterten Eigenschaft wird die Groß-/Kleinschreibung beachtet.Filtering the value property of an extended property is case-insensitive.

Die folgenden Benutzerressourcen werden unterstützt:The following user resources are supported:

Darüber hinaus werden die folgenden Gruppenressourcen unterstützt:As well as the following group resources:

Im Übersichtsartikel zu erweiterten Eigenschaften finden Sie weitere Informationen dazu, wann Sie offene Erweiterungen verwenden sollten und wann erweiterte Eigenschaften. Außerdem erfahren Sie dort, wie erweiterte Eigenschaften angegeben werden.See Extended properties overview for more information about when to use open extensions or extended properties, and how to specify extended properties.

BerechtigungenPermissions

Abhängig von der Ressource, von der Sie die erweiterte Eigenschaft erhalten, und dem von Ihnen angeforderten Berechtigungstyp (Delegierte oder Anwendung) ist die in der folgenden Tabelle angegebene Berechtigung mindestens erforderlich, um diese API aufzurufen.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. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.To learn more, including how to choose permissions, see Permissions.

Unterstützte RessourceSupported resource Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) AnwendungApplication
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
calendar-Ressourcen für Gruppengroup calendar Group.Read.AllGroup.Read.All Nicht unterstütztNot supported Nicht unterstütztNot supported
event-Ressourcen für Gruppengroup event Group.Read.AllGroup.Read.All Nicht unterstütztNot supported Nicht unterstütztNot supported
post-Ressourcen für Gruppengroup post Group.Read.AllGroup.Read.All Nicht unterstütztNot 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

HTTP-AnforderungHTTP request

Abrufen einer Ressourceninstanz, erweitert um eine erweiterte Eigenschaft, die einem Filter entsprichtGET a resource instance expanded with an extended property that matches a filter

Hier sehen Sie, wie Sie eine Ressourceninstanz abrufen können, erweitert um die erweiterte Eigenschaft, deren id-Eigenschaft dem definierten Filter entspricht. Stellen Sie sicher, dass Sie für die Leerzeichen in der Filterzeichenfolge die URL-Codierung verwenden.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.

Abrufen einer message-Instanz: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}')

Abrufen einer mailFolder-Instanz: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}')

Abrufen einer event-InstanzGet 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}')

Abrufen einer calendar-Instanz: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}')

Abrufen einer contact-Instanz: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}')

Abrufen einer contactFolder-Instanz: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}')

Abrufen einer event-Instanz für eine Gruppe:Get a group event instance:

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

Abrufen einer post-Instanz für eine Gruppe: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}')

Abrufen von Ressourceninstanzen, die numerische erweiterte Eigenschaften enthalten, die einem Filter entsprechenGET resource instances that include numeric extended properties matching a filter

Rufen Sie Instanzen einer unterstützten Ressource ab, die eine numerische erweiterte Eigenschaft besitzen, die einem Filter entspricht.Get instances of a supported resource that have a numeric extended property matching a filter. Der Filter wendet einen eq-Operator auf die ID-Eigenschaft und einen der folgenden Operatoren auf die Eigenschaft Wert an: eq, ne,ge, gt , le oder 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. Stellen Sie sicher, dass Sie für die folgenden Zeichen in der Filterzeichenfolge die URL-Codierung verwenden: Doppelpunkte, Vorwärtsschrägstriche und Leerzeichen.Make sure you apply URL encoding to the following characters in the filter string - colon, forward slash, and space.

Die folgenden Syntaxzeilen zeigen einen Filter, der den eq-Operator auf die ID anwendet, und einen eq-Operator, der auf den Eigenschaftswert angewandt wird.The following syntax lines show a filter that uses an eq operator on the id, and another eq operator on the property value. Sie können den eq-Operator, der auf den Wert angewandt wird, durch einen der anderen Operatoren (ne,ge, gt, le oder lt) ersetzen, die auf numerische Werte angewandt werden.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.

Abrufen von message-Instanzen: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}')

Abrufen von mailFolder-Instanzen: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}')

Abrufen von event-Instanzen: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}')

Abrufen von calendar-Instanzen: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}')

Abrufen von contact-Instanzen: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}')

Abrufen von contactFolder-Instanzen: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}')

Abrufen von event-Instanzen für Gruppen:Get group event instances:

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

Abrufen von post-Instanzen für Gruppen: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}')

Abrufen von Ressourceninstanzen mit erweiterten Eigenschaften des Typs Zeichenfolge, die einem Filter entsprechenGET resource instances with string-typed extended properties matching a filter

Rufen Sie Instanzen der Ressource Nachricht oder Ereignis mit einer erweiterten Eigenschaft des Typs Zeichenfolge ab, die einem Filter entspricht.Get instances of the message or event resource that have a string-typed extended property matching a filter. Der Filter wendet einen eq-Operator auf die ID-Eigenschaft und einen der folgenden Operatoren auf die Eigenschaft Wert an: contains, startswith, eq oder 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. Stellen Sie sicher, dass Sie für die folgenden Zeichen in der Filterzeichenfolge die URL-Codierung verwenden: Doppelpunkte, Vorwärtsschrägstriche und Leerzeichen.Make sure you apply URL encoding to the following characters in the filter string - colon, forward slash, and space.

Abrufen von message-Instanzen: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}')

Abrufen von event-Instanzen: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}')

Abrufen von event-Instanzen für Gruppen: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}')

PfadparameterPath parameters

ParameterParameter TypType BeschreibungDescription
id_valueid_value StringString Die ID der erweiterten Eigenschaft, nach der gefiltert wird. Sie muss eins der unterstützten Formate aufweisen. Weitere Informationen finden Sie unter Überblick über erweiterte Eigenschaften in Outlook. Erforderlich.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 Der Wert der erweiterten Eigenschaft, nach der gefiltert wird.The value of the extended property to match. Erforderlich, wo im Abschnitt HTTP-Anforderung oben aufgeführt.Required where listed in the HTTP request section above. Wenn {property_value} keine Zeichenfolge ist, müssen Sie sicherstellen, dass ep/value explizit in den entsprechenden Edm-Datentyp beim Vergleich mit {property_value} umgewandelt wird.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}. Beispiele finden Sie unter Anforderung 4 weiter unter.See request 4 below for examples.

AnforderungsheaderRequest headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.

AnforderungstextRequest body

Geben Sie für diese Methode keinen Anforderungstext an.Do not supply a request body for this method.

AntwortResponse

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 200 OK zurückgegeben.If successful, this method returns a 200 OK response code.

Abrufen einer Ressourceninstanz, erweitert um eine übereinstimmende erweiterte EigenschaftGET resource instance expanded with a matching extended property

Der Antworttext enthält ein Objekt, das die angeforderte Ressourceninstanz darstellt, erweitert um das dem Filter entsprechende singleValueLegacyExtendedProperty-Objekt.The response body includes an object representing the requested resource instance, expanded with the matching singleValueLegacyExtendedProperty object.

Abrufen von Ressourceninstanzen mit einer erweiterten Eigenschaft, die einem Filter entsprichtGET resource instances that contain an extended property matching a filter

Der Antworttext enthält ein oder mehrere Objekte, die Ressourceninstanzen darstellen, die einem dem Filter entsprechende erweiterte Eigenschaft enthalten.The response body includes one or more objects representing the resource instances that contain a matching extended property. Der Antworttext enthält nicht die erweiterte Eigenschaft.The response body does not include the extended property.

BeispielExample

Anforderung 1Request 1

Im ersten Beispiel wird die angegebene Nachricht abgerufen und um eine einwertige erweiterte Eigenschaft erweitert. Der Filter gibt die erweiterte Eigenschaft zurück, deren id der Zeichenfolge String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color entspricht (URL-Codierung hier zur besseren Lesbarkeit entfernt).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')

Antwort 1Response 1

Der Antworttext enthält alle Eigenschaften der angegebenen Nachricht und die vom Filter zurückgegebene erweiterte Eigenschaft.The response body includes all the properties of the specified message and extended property returned from the filter.

Hinweis: Das hier gezeigte message-Objekt ist aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.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"
        }
    ]
}

Anforderung 2Request 2

Das zweite Beispiel ruft Nachrichten ab, die die im Filter spezifizierte einwertige erweiterte Eigenschaft vom Typ Zeichenfolge haben.The second example gets messages that have the string-typed single-value extended property specified in the filter. Der Filter sucht nach der erweiterten Eigenschaft, die folgende Merkmale hat:The filter looks for the extended property that has:

  • Die ID entspricht der Zeichenfolge String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color (URL-Codierung hier zur besseren Lesbarkeit entfernt).Its id equal to the string String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color (with URL encoding removed here for ease of reading).

  • Der Wert ist gleich der Zeichenfolge 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')

Antwort 2Response 2

Eine erfolgreiche Antwort ist durch den Antwortcode HTTP 200 OK gekennzeichnet. Der Antworttext enthält alle Eigenschaften der Nachrichten, die die dem Filter entsprechende erweiterte Eigenschaft haben. Der Antworttext ähnelt der Antwort beim Abrufen einer Nachrichtensammlung. Die Antwort enthält nicht die dem Filter entsprechende erweiterte Eigenschaft.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.

Anforderung 3Request 3

Das dritte Beispiel ruft Nachrichten ab, die die im Filter spezifizierte einwertige erweiterte Eigenschaft vom Typ Zeichenfolge haben.The third example gets messages that have the string-typed single-value extended property specified in the filter. Der Filter sucht nach der erweiterten Eigenschaft, die folgende Merkmale hat:The filter looks for the extended property that has:

  • Die ID entspricht der Zeichenfolge String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color (URL-Codierung hier zur besseren Lesbarkeit entfernt).Its id equal to the string String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color (with URL encoding removed here for ease of reading).

  • Die Wert, der die Zeichenfolge green enthält.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'))

Antwort 3Response 3

Eine erfolgreiche Antwort ist durch den Antwortcode HTTP 200 OK gekennzeichnet. Der Antworttext enthält alle Eigenschaften der Nachrichten, die die dem Filter entsprechende erweiterte Eigenschaft haben.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. Wie zum Beispiel eine Nachricht, die eine einwertige erweiterte Eigenschaft mit einer ID besitzt, die der Zeichenfolge String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color entspricht, und der Wert Light green stimmt mit dem Filter überein und ist in der Antwort enthalten.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.

Der Antworttext ähnelt der Antwort beim Abrufen einer Nachrichtensammlung.The response body is similar to the response from getting a message collection. Die Antwort enthält nicht die dem Filter entsprechende erweiterte Eigenschaft.The response does not include the matching extended property.

Anforderung 4Request 4

Die nächsten 2 Beispiele zeigen, wie Sie Nachrichten abrufen, die erweiterte einwertige Eigenschaften vom Typ Nicht-Zeichenfolge enthalten.The next 2 examples show how to get messages that have non-string typed single-value extended properties. Zur besseren Lesbarkeit ist die erforderliche URL-Codierung dort nicht enthalten.For ease of reading, they do not include the necessary URL encoding.

Das folgende Beispiel zeigt einen Filter, der nach der erweiterte Eigenschaft mit den folgenden Merkmalen sucht:The following example shows a filter that looks for the extended property that has:

  • Die id entspricht der Zeichenfolge CLSID {00062008-0000-0000-C000-000000000046} Name ConnectorSenderGuid.Its id matching the string CLSID {00062008-0000-0000-C000-000000000046} Name ConnectorSenderGuid.

  • Der Wert ist die GUID b9cf8971-7d55-4b73-9ffa-a584611b600b.Its value being the GUID b9cf8971-7d55-4b73-9ffa-a584611b600b. Wenn Sie den Eigenschaftswert mit einer GUID vergleichen möchten, ändern Sie ep/value in 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))

Das folgende Beispiel zeigt einen Filter, der nach der erweiterte Eigenschaft mit den folgenden Merkmalen sucht:The next example shows a filter that looks for the extended property that has:

  • Die id entspricht der Zeichenfolge Integer {66f5a359-4659-4830-9070-00047ec6ac6e} Name Pallete.Its id matching the string Integer {66f5a359-4659-4830-9070-00047ec6ac6e} Name Pallete.

  • Der Wert ist gleich der ganzen Zahl 12.Its value equal to the integer 12. Um den Eigenschaftswert mit einer ganzen Zahl zu vergleichen, ändern Sie ep/value in 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)

Antwort 4Response 4

Bei den zwei vorhergehenden Beispielen ist eine erfolgreiche Antwort durch den Antwortcode HTTP 200 OK gekennzeichnet. Der Antworttext enthält alle Eigenschaften der Nachrichten, die die dem Filter entsprechende erweiterte Eigenschaft haben.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. Der Antworttext ähnelt der Antwort beim Abrufen einer Nachrichtensammlung.The response body is similar to the response from getting a message collection. Die Antwort enthält nicht die dem Filter entsprechende erweiterte Eigenschaft.The response does not include the matching extended property.