Search Suggested Records

構文

URI

vXX.X/search/suggestions?q=search_string&sobject=object_types

適用開始バージョン

32.0

形式

JSON、XML

HTTP メソッド

GET

認証

Authorization: Bearer token

リクエストボディ

不要

要求パラメータ

パラメータ	説明
fields	省略可能。ルックアップクエリの作成に使用します。カンマ区切りのリストを使用して複数の項目を指定します。応答で返される参照項目を指定します。
groupId	省略可能。返される質問が投稿されたグループの一意の識別子を指定します。カンマ区切りのリストを使用して複数のグループを指定します。このパラメータは、パラメータの type が question の場合にのみ適用されます。userId と併せて使用しないでください。
ignoreUnsupportedSObjects	省略可能。サポート対象外のオブジェクトが要求に含まれていた場合の動作を指定します。false を指定すると、サポート対象外のオブジェクトが含まれている場合、エラーが返されます。true を指定すると、サポート対象外のオブジェクトが含まれている場合、オブジェクトは無視されてエラーは返されません。「サポート対象外のオブジェクト」セクションを参照してください。デフォルトは、false です。
limit	省略可能。返される推奨レコードの最大数を指定します。制限が指定されていない場合、デフォルトで 5 レコードが返されます。指定された制限を超える推奨レコードが存在すると、レスポンスボディの hasMoreResults プロパティが true になります。
networkId	省略可能。返される質問が関連付けられたコミュニティの一意の識別子を指定します。カンマ区切りのリストを使用して複数のコミュニティを指定します。このパラメータは、パラメータの type が question の場合、またはパラメータの sobject が user の場合にのみ適用されます。
q	必須。適切に URL 符号化された、ユーザの検索クエリ文字列。ユーザの検索クエリ文字列が最小長要件 (中国語、日本語、韓国語、タイ語の場合は 1 文字、その他の言語の場合は 3 文字) を満たしている場合にのみ、推奨クエリが返されます。クエリ文字列が最大長である 255 文字 (または区切りの空白なしの連続した 200 文字) を超えると、エラーが返されます。
sobject	必須。Account や offer__c など、検索の範囲となるオブジェクト。 sobject の値が feedItem の場合、type パラメータの値は question である必要があります。 カンマ区切りのリストを使用して最大 10 個のオブジェクトを指定します。たとえば、sobject=Account,Contact,Lead です。この機能を利用するには、[CrossObjectTypeahead] 権限を有効にします。 オブジェクトごとに返す特定の項目を指定するには、次の構文を使用します。複数の項目にはカンマ区切りのリストを使用します。sobject は小文字です。 1sobject=sobject.fields=fields 以下に例を示します。 1&sobject=Account,Contact,Lead&account.fields=Website,Phone 2&contact.fields=Phone
topicId	省略可能。返される質問がタグ付けされた単一のトピックの一意の識別子を指定します。このパラメータは、パラメータの type が question の場合にのみ適用されます。
type	sobject の値が feedItem である場合は必須です。sobject のその他すべての値に対してこのパラメータを含めると、クエリには影響しません。フィードの種別が質問であることを指定します。有効な値: question。
userId	省略可能。返される質問を作成したユーザの一意の識別子を指定します。カンマ区切りのリストを使用して複数のユーザを指定します。このパラメータは、パラメータの type が question の場合にのみ適用されます。groupId と併せて使用しないでください。
useSearchScope	省略可能。API バージョン 40.0 以降で使用できます。デフォルト値は、false です。false の場合、要求に指定されたオブジェクトがレコードの推奨に使用されます。true の場合、要求に指定されたオブジェクトに加え、ユーザの検索範囲がレコードの推奨に使用されます。検索範囲は、ユーザが最もよく使用するオブジェクトのリストです。 要求でオブジェクトが指定されていない場合は、useSearchScope=true を使用します。 useSearchScope=trueとユーザの検索範囲が空の場合、デフォルトの検索範囲がレコードの推奨に使用されます。 レコードの推奨に使用されるのは、最初の 10 個のオブジェクトのみです。 sobject パラメータに指定されたオブジェクトがユーザの検索範囲に指定されたオブジェクトよりも優先されます。 ignoreUnsupportedSObjects パラメータの値は、検索範囲のオブジェクトには適用されません。 この例では検索範囲のみが使用されています。 1.../search/suggestions?q=Acme&useSearchScope=true この例では検索範囲と Account オブジェクトが使用されています。 1.../search/suggestions?q=Acme&sobject=Account&useSearchScope=true
where	省略可能。SOQL の where 句と同じ構文に従う検索条件。URL 符号化の式です。 オブジェクトの句を使用するか、互換性のあるすべてのオブジェクトにグローバルに使用します。オブジェクト固有の句の一例は、account.where=name%20LIKE%20%27Smith%25%27 です。グローバル句の一例は、where=name%20LIKE%20%27Smith%25%27 です。このパラメータは小文字で入力してください。オブジェクト固有の where 句は、グローバルな where 句よりも優先されます。このパラメータは Question オブジェクトには使用できません。 複数のエンティティを指定するには、次の例を参照してください。この機能はバージョン 38.0 以降で使用できます。 1...search/suggestions?q=Smith 2&sobject=Account,Contact,KnowledgeArticleVersion,CollaborationGroup,Topic,FeedItem 3// Specifies a global where clause (to filter Account and Contact) 4&where=name%20LIKE%20%27Smith%25%27 5// Overrides the global where clause for Knowledge Article 6(filtering by PublishStatus and Language is required for KnowledgeArticle) 7&knowledgearticleversion.where=PublishStatus='online'+and+language='en_US' 8// Overrides the global where clause for Topic 9&topic.where=networkid=<1234567891> 10// Overrides the global where clause for CollaborationGroup 11&collaborationgroup.where=networkid=<1234567891> 12// FeedItem-Question doesn't support where clauses, but we can filter 13the type and networkId&type=question 14&networkId==<1234567891>

使用方法

推奨レコード応答

JSON レスポンスボディの例

1[ {
2  "attributes" : {
3    "type" : "Account",
4    "url" : "/services/data/v32.0/sobjects/Account/001xx000003DH6WAAW"
5  },
6  "Id" : "001xx000003DH6WAAW"
7  "Name" : "National Utility Service"
8}, { 
9{
10  "attributes" : {
11    "type" : "Account",
12    "url" : "/services/data/v32.0/sobjects/Account/001xx000003DHJ4AAO"
13  },
14  "Id" : "001xx000003DHJ4AAO"
15  "Name" : "National Utility Service"
16}, {
17{
18  "attributes" : {
19    "type" : "Account",
20    "url" : "/services/data/v32.0/sobjects/Account/001xx000003DHscAAG"
21  },
22  "Id" : "001xx000003DHscAAG"
23  "Name" : "National Urban Technology Center"
24} ]

複数オブジェクト要求の JSON レスポンスボディの例

1[ {
2  "attributes" : {
3    "type" : "Account",
4    "url" : "/services/data/v38.0/sobjects/Account/001xx000003DMEKAA4"
5  },
6  "Id" : "001xx000003DMEKAA4"
7  "Name" : "Joe Doe Printing"
8}, { 
9{
10  "attributes" : {
11    "type" : "Account",
12    "url" : "/services/data/v38.0/sobjects/Account/001xx000003DLjvAAG"
13  },
14  "Id" : "001xx000003DLjvAAGO"
15  "Name" : "Joe Doe Plumbing"
16}, {
17{
18  "attributes" : {
19    "type" : "Contact",
20    "url" : "/services/data/v38.0/sobjects/Contact/003xx000004U9Y9AAK"
21  },
22  "Id" : "003xx000004U9Y9AAK"
23  "Name" : "John Doe"
24} ]

XML レスポンスボディの例

1<?xml version=”1.0” encoding=”UTF-8”?
2<suggestions>
3  <autoSuggestResults type="Account" url="/services/data/v32.0/sobjects/Account/001xx000003DH6WAAW">  
4    <Id>001xx000003DH6WAAW</Id>
5    <Name>National Utility Service</Name>
6  </autoSuggestResults>
7  <autoSuggestResults type="Account" url="/services/data/v32.0/sobjects/Account/001xx000003DHJ4AAO">
8    <Id>001xx000003DHJ4AAO</Id>
9    <Name>National Utility Service</Name>
10  </autoSuggestResults> 
11  <autoSuggestResults type="Account" url="/services/data/v32.0/sobjects/Account/001xx000003DHscAAG"> 
12    <Id>001xx000003DHscAAG</Id> 
13    <Name>National Urban Technology Center</Name>
14  </autoSuggestResults>
15  <hasMoreResults>true</hasMoreResults> 
16</suggestions>

サポート対象外のオブジェクト