この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

Search Suggested Records

名前がユーザの検索文字列と一致した推奨レコードのリストを返します。この推奨リソースは、ユーザが検索を実行する前に、関連する可能性のあるレコードに直接移動するためのショートカットを提供します。

構文

URI

vXX.X/search/suggestions?q=検索文字列&sobject=オブジェクト種別

適用開始バージョン

32.0

形式

JSON、XML

HTTP メソッド

GET

認証

Authorization: Bearer token

リクエストボディ

不要

要求パラメータ

パラメータ	説明
limit	省略可能。返される推奨レコードの最大数を指定します。制限が指定されていない場合、デフォルトで 5 レコードが返されます。指定された制限を超える推奨レコードが存在すると、レスポンスボディの hasMoreResults プロパティが `true` になります。
q	必須。適切に URL 符号化された、ユーザの検索クエリ文字列。ユーザの検索クエリ文字列が最小長要件 (中国語、日本語、韓国語、タイ語の場合は 1 文字、その他の言語の場合は 3 文字) を満たしている場合にのみ、推奨クエリが返されます。クエリ文字列が最大長である 255 文字 (または区切りの空白なしの連続した 200 文字) を超えると、エラーが返されます。
sobject	必須。account や offer__c など、検索の範囲となるオブジェクト。

使用方法

この推奨リソースは、レコード名項目が検索文字列と一致するテキストで開始している場合にレコードを返します。この推奨リソースは、検索文字列の最後に自動的にアスタリスクワイルドカード (*) を付加します。1 語内に検索文字列が含まれるレコードは、一致とは見なされません。

ユーザの検索クエリに疑問符またはワイルドカードが含まれている場合、それらの記号は URI でクエリ文字列から自動的に削除されます。

メモ

レコードは、レコード名に検索文字列全体が見つかった場合に、検索文字列内での指定と同じ並びで推奨されます。

例

たとえば、テキスト文字列 national u は national u* として扱われ、「National Utility」と「National Urban Company」は返されますが、「National Company Utility」や「Urban National Company」は返されません。

推奨レコード応答

この推奨リソースは、関連する可能性があり、ユーザがアクセス可能なレコードに関する、表示可能な状態のデータを返します。このリソースは、表示用のデータを取得するために ID を使用する他のサービスと併用できます。

結果の順序は、関連性アルゴリズムによって決まります。

結果内の各推奨レコードには、次の要素が含まれます。

要素	説明
Attributes	レコードのオブジェクト種別とレコードにアクセスするための URL。
Name (または Title)	レコードの名前項目。標準の名前項目がない場合、次のオブジェクトには標準のタイトル項目が使用されます。 Dashboard Idea IdeaTheme Note Question
Id	レコードの一意の識別子。

JSON レスポンスボディの例

1[ {
2
3  "attributes" : {
4
5    "type" : "Account",
6
7    "url" : "/services/data/v32.0/sobjects/Account/001xx000003DH6WAAW"
8
9  },
10
11  "Id" : "001xx000003DH6WAAW"
12
13  "Name" : "National Utility Company"
14
15}, { 
16
17{
18
19  "attributes" : {
20
21    "type" : "Account",
22
23    "url" : "/services/data/v32.0/sobjects/Account/001xx000003DHJ4AAO"
24
25  },
26
27  "Id" : "001xx000003DHJ4AAO"
28
29  "Name" : "National Utility Service"
30
31}, {
32
33{
34
35  "attributes" : {
36
37    "type" : "Account",
38
39    "url" : "/services/data/v32.0/sobjects/Account/001xx000003DHscAAG"
40
41  },
42
43  "Id" : "001xx000003DHscAAG"
44
45  "Name" : "National Urban Technology Center"
46
47} ]

XML レスポンスボディの例

1<?xml version=”1.0” encoding=”UTF-8”?
2
3<suggestions>
4
5  <autoSuggestResults type="Account" url="/services/data/v32.0/sobjects/Account/001xx000003DH6WAAW">  
6
7    <Id>001xx000003DH6WAAW</Id>
8
9    <Name>National Utility Company</Name>
10
11  </autoSuggestResults>
12
13  <autoSuggestResults type="Account" url="/services/data/v32.0/sobjects/Account/001xx000003DHJ4AAO">
14
15    <Id>001xx000003DHJ4AAO</Id>
16
17    <Name>National Utility Service</Name>
18
19  </autoSuggestResults> 
20
21  <autoSuggestResults type="Account" url="/services/data/v32.0/sobjects/Account/001xx000003DHscAAG"> 
22
23    <Id>001xx000003DHscAAG</Id> 
24
25    <Name>National Urban Technology Center</Name>
26
27  </autoSuggestResults>
28
29  <hasMoreResults>true</hasMoreResults> 
30
31</suggestions>

サポートされるオブジェクト

この推奨リソースでは、次を除くすべてのオブジェクトがサポートされます。

Article (タイトルがユーザの検索クエリ文字列と一致する Salesforce ナレッジ記事のリストを返すには、suggestTitleMatches リソースを使用します。)
ContentNote
Event
FeedComment
FeedPost
IdeaComment
Pricebook2
Reply
TagDefinition
Task

Force.com REST API 開発者ガイド