singleValueLegacyExtendedProperty を取得するGet singleValueLegacyExtendedProperty

特定の拡張プロパティで展開された単一のリソース インスタンス、または 1 つのフィルターと一致する拡張プロパティを含むリソース インスタンスのコレクションを取得できます。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.

クエリ パラメーター $expand を使用すると、指定した拡張プロパティで展開された特定のリソース インスタンスを取得できます。Using the query parameter $expand allows you to get the specified resource instance expanded with a specific extended property. id プロパティ上で $filter および eq 演算子を使用して拡張プロパティを指定します。Use a $filter and eq operator on the id property to specify the extended property. これは、現時点で、拡張プロパティを表す singleValueLegacyExtendedProperty オブジェクトを取得する唯一の方法です。This is currently the only way to get the singleValueLegacyExtendedProperty object that represents an extended property.

特定の拡張プロパティを含むリソース インスタンスを取得するには、$filter クエリ パラメーターを使用して、eq 演算子を id プロパティに適用します。To get resource instances that have certain extended properties, use the $filter query parameter and apply an eq operator on the id property. さらに、数値の拡張プロパティについては、value プロパティで eqnegegtlelt 演算子のいずれかを適用します。In addition, for numeric extended properties, apply one of the following operators on the value property: eq, ne,ge, gt, le, or lt. 文字列型の拡張プロパティについては、containsstartswitheqne 演算子を value に適用します。For string-typed extended properties, apply a contains, startswith, eq, or ne operator on value.

フィルターは、サインインしているユーザーのメールボックスにあるリソースのインスタンスすべてに適用されます。The filter is applied to all instances of the resource in the signed-in user's mailbox.

拡張プロパティの id で文字列名 (Name) をフィルタリングする場合は、大文字と小文字が区別されます。Filtering the string name (Name) in the id of an extended property is case-sensitive. 拡張プロパティの value プロパティをフィルタリングする場合は、大文字と小文字が区別されません。Filtering the value property of an extended property is case-insensitive.

次のユーザー リソースがサポートされます。The following user resources are supported:

次のグループ リソースもサポートされます。As well as the following group resources:

オープン拡張機能または拡張プロパティを使用するのに適した状況と、拡張プロパティを指定する方法の詳細については、「拡張プロパティの概要」を参照してください。See Extended properties overview for more information about when to use open extensions or extended properties, and how to specify extended properties.

アクセス許可Permissions

この 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. アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。To learn more, including how to choose permissions, see Permissions.

サポートされているリソースSupported resource 委任 (職場または学校のアカウント)Delegated (work or school account) 委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) アプリケーションApplication
calendarcalendar Calendars.ReadCalendars.Read Calendars.ReadCalendars.Read Calendars.ReadCalendars.Read
連絡先contact 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
グループ calendargroup calendar Group.Read.AllGroup.Read.All 非サポートNot supported 非サポートNot supported
グループ eventgroup event Group.Read.AllGroup.Read.All 非サポートNot supported 非サポートNot supported
グループ postgroup post Group.Read.AllGroup.Read.All サポート対象外Not 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 要求HTTP request

フィルターと一致する拡張プロパティで展開されたリソース インスタンスを取得するGET a resource instance expanded with an extended property that matches a filter

id プロパティに対するフィルターと一致する拡張プロパティで展開された、リソース インスタンスを取得します。フィルター文字列内のスペース文字に URL エンコードを適用していることを確認してください。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.

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}')

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}')

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}')

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}')

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}')

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}')

グループ event インスタンスの取得:Get a group event instance:

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

グループ 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}')

フィルターと一致する数値の拡張プロパティを含むリソース インスタンスを取得するGET resource instances that include numeric extended properties matching a filter

フィルターと一致する数値の拡張プロパティを持つサポート対象リソースのインスタンスを取得します。Get instances of a supported resource that have a numeric extended property matching a filter. フィルターは id プロパティには eq 演算子を使用し、value プロパティには eqnegegtlelt のいずれかの演算子を使用します。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. フィルター文字列内のコロン、スラッシュ、スペースに URL エンコードを適用していることをご確認ください。Make sure you apply URL encoding to the following characters in the filter string - colon, forward slash, and space.

次の構文の行では、id に eq 演算子を使用し、プロパティ値にもう 1 つの eq 演算子を使用するフィルターを示しています。The following syntax lines show a filter that uses an eq operator on the id, and another eq operator on the property value. value に対する eq 演算子は、数値に適用される別の演算子 (negegtlelt) のいずれかと置き換えることができます。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.

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}')

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}')

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}')

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}')

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}')

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}')

グループ event インスタンスの取得:Get group event instances:

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

グループ 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}')

フィルターと一致する文字列型の拡張プロパティを含むリソース インスタンスを取得するGET resource instances with string-typed extended properties matching a filter

フィルターと一致する文字列型の拡張プロパティを含む message または event リソースのインスタンスを取得します。Get instances of the message or event resource that have a string-typed extended property matching a filter. フィルターは id プロパティには eq 演算子を使用し、value プロパティには containsstartswitheqne のいずれかの演算子を使用します。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. フィルター文字列内のコロン、スラッシュ、スペースに URL エンコードを適用していることをご確認ください。Make sure you apply URL encoding to the following characters in the filter string - colon, forward slash, and space.

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}')

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}')

グループ 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}')

パス パラメーターPath parameters

パラメーターParameter Type 説明Description
id_valueid_value StringString 照合する拡張プロパティの ID。サポートされている形式のいずれかに従う必要があります。詳しくは、「Outlook の拡張プロパティの概要」を参照してください。必須。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 照合する拡張プロパティの値。The value of the extended property to match. 前述の「HTTP 要求」セクションに示した一覧で必要になります。Required where listed in the HTTP request section above. {property_value} が文字列ではない場合、ep/value を {property_value} と比較するときに、適切な Edm データ型に明示的にキャストしてください。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}. 例については、以下の要求 4 を参照してください。See request 4 below for examples.

要求ヘッダーRequest headers

名前Name 説明Description
AuthorizationAuthorization ベアラー {トークン}。必須。Bearer {token}. Required.

要求本文Request body

このメソッドには、要求本文を指定しません。Do not supply a request body for this method.

応答Response

成功した場合、このメソッドは 200 OK 応答コードを返します。If successful, this method returns a 200 OK response code.

一致する拡張プロパティで展開されたリソース インスタンスを取得するGET resource instance expanded with a matching extended property

応答本文には、一致する singleValueLegacyExtendedProperty オブジェクトで展開された、要求したリソース インスタンスで表されるオブジェクトが含まれます。The response body includes an object representing the requested resource instance, expanded with the matching singleValueLegacyExtendedProperty object.

フィルターと一致する拡張プロパティを含むリソース インスタンスを取得するGET resource instances that contain an extended property matching a filter

応答本文には、一致する拡張プロパティを含むリソース インスタンスを表す 1 つ以上のオブジェクトが含まれます。The response body includes one or more objects representing the resource instances that contain a matching extended property. 応答本文には、拡張プロパティは含まれません。The response body does not include the extended property.

Example

要求 1Request 1

最初の例では、単一値の拡張プロパティを含めることによって指定されたメッセージを取得して展開します。フィルターは、id が文字列 String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color と一致する拡張プロパティを返します (ここでは、読みやすくするため URL エンコードを削除しています)。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')

応答 1Response 1

応答本文には、指定されたメッセージのすべてのプロパティと、フィルターから返される拡張プロパティが含まれています。The response body includes all the properties of the specified message and extended property returned from the filter.

注:簡潔にするために、ここに示すメッセージ オブジェクトは切り詰められています。すべてのプロパティは実際の呼び出しから返されます。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"
        }
    ]
}

要求 2Request 2

2 番目の例では、文字列で型指定され、フィルターで指定された単一値の拡張プロパティを持つメッセージを取得します。The second example gets messages that have the string-typed single-value extended property specified in the filter. フィルターは、以下のような拡張プロパティを検索します。The filter looks for the extended property that has:

  • その id は文字列 String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color と一致します (ここでは、読みやすくするため URL エンコードを削除しています)。Its id equal to the string String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color (with URL encoding removed here for ease of reading).

  • その value は文字列 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')

応答 2Response 2

正常な応答が HTTP 200 OK 応答コードによって示され、応答の本文には、フィルターに一致する拡張プロパティを持つメッセージのすべてのプロパティが含まれます。応答本文は、メッセージのコレクションの取得からの応答に似ています。応答は、一致する拡張プロパティを含みません。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.

要求 3Request 3

3 番目の例では、文字列で型指定され、フィルターで指定された単一値の拡張プロパティを持つメッセージを取得します。The third example gets messages that have the string-typed single-value extended property specified in the filter. フィルターは、以下のような拡張プロパティを検索します。The filter looks for the extended property that has:

  • その id は文字列 String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color と一致します (ここでは、読みやすくするため URL エンコードを削除しています)。Its id equal to the string String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color (with URL encoding removed here for ease of reading).

  • その value には文字列 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'))

応答 3Response 3

正常な応答が HTTP 200 OK 応答コードによって示され、応答の本文には、フィルターに一致する拡張プロパティを持つメッセージのすべてのプロパティが含まれます。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. たとえば、id が文字列 String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Colorvalue Light green と等しい単一値の拡張プロパティのあるメッセージがフィルターと一致し、応答に含まれるとします。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.

応答本文は、メッセージのコレクションの取得からの応答に似ています。The response body is similar to the response from getting a message collection. 応答は、一致する拡張プロパティを含みません。The response does not include the matching extended property.

要求 4Request 4

次の 2 つの例では、文字列以外で型指定された単一値の拡張プロパティを持つメッセージを取得する方法を示しています。The next 2 examples show how to get messages that have non-string typed single-value extended properties. 読みやすくするため、必要な URL エンコードは含まれていません。For ease of reading, they do not include the necessary URL encoding.

次の例は、以下のような拡張プロパティを検索するフィルターを示しています。The following example shows a filter that looks for the extended property that has:

  • その id は文字列 CLSID {00062008-0000-0000-C000-000000000046} Name ConnectorSenderGuid と一致します。Its id matching the string CLSID {00062008-0000-0000-C000-000000000046} Name ConnectorSenderGuid.

  • その value は GUID b9cf8971-7d55-4b73-9ffa-a584611b600b です。Its value being the GUID b9cf8971-7d55-4b73-9ffa-a584611b600b. プロパティ値を GUID と比較するには、ep/valueEdm.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))

次の例は、以下のような拡張プロパティを検索するフィルターを示しています。The next example shows a filter that looks for the extended property that has:

  • その id は文字列 Integer {66f5a359-4659-4830-9070-00047ec6ac6e} Name Pallete と一致します。Its id matching the string Integer {66f5a359-4659-4830-9070-00047ec6ac6e} Name Pallete.

  • その value は整数 12 と等しくなります。Its value equal to the integer 12. プロパティ値を整数と比較するには、ep/valueEdm.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)

応答 4Response 4

前の 2 つの例では、正常な応答が HTTP 200 OK 応答コードによって示され、応答の本文には、対応するフィルターに一致する拡張プロパティを持つメッセージのすべてのプロパティが含まれます。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. 応答本文は、メッセージのコレクションの取得からの応答に似ています。The response body is similar to the response from getting a message collection. 応答は、一致する拡張プロパティを含みません。The response does not include the matching extended property.