| fields |
省略可能。ルックアップクエリの作成に使用します。カンマ区切りのリストを使用して複数の項目を指定します。応答で返される参照項目を指定します。 |
| dynamicFields |
省略可能。API バージョン 48.0 以降で使用できます。追加の動的項目を返すために使用されます。複数のオプションを指定するには、カンマ区切りのリストを使用します。たとえば、dynamicFields=secondaryField の場合、検索レイアウトの次の対象項目に基づいて、Id および Name (または Title) 以外の項目が結果の各推奨レコードに追加されます。 |
| 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 は小文字です。
次に例を示します。
|
| 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 パラメータの値は検索範囲内のオブジェクトには適用されません。
この例では、検索範囲と Account オブジェクトを使用します。
|
| where |
省略可能。SOQL の WHERE 句と同じ構文に従う検索条件。URL は式を符号化します。 オブジェクトの句を使用するか、互換性のあるすべてのオブジェクトの句をグローバルに使用します。オブジェクト固有の句の例: account.where=name%20LIKE%20%27Smith%25%27。グローバルな句の例: where=name%20LIKE%20%27Smith%25%27。パラメータは小文字である必要があります。オブジェクト固有の where 句は、グローバルな where 句よりも優先されます。このパラメータは Question オブジェクトには使用できません。
複数のエンティティを指定する場合は、以下の例を参照してください。この機能はバージョン 38.0 以降で使用できます。
|
j