Force.com REST API 開発者ガイド
Spring '26 (API version 66.0)
Winter '25 (API version 62.0)
Spring '24 (API version 60.0)
Winter '24 (API version 59.0)
Summer '23 (API version 58.0)
Spring '23 (API version 57.0)
Winter '23 (API version 56.0)
Summer '22 (API version 55.0)
Spring '22 (API version 54.0)
Winter '22 (API version 53.0)
Summer '21 (API version 52.0)
Winter '21 (API version 50.0)
Summer '20 (API version 49.0)
Spring '20 (API version 48.0)
Winter '20 (API version 47.0)
Summer '19 (API version 46.0)
Spring '19 (API version 45.0)
Winter '19 (API version 44.0)
Summer '18 (API version 43.0)
Spring '18 (API version 42.0)
Winter '18 (API version 41.0)
Summer '17 (API version 40.0)
Spring '17 (API version 39.0)
Winter '17 (API version 38.0)
Summer '16 (API version 37.0)
Spring '16 (API version 36.0)
Winter '16 (API version 35.0)
Summer '15 (API version 34.0)
Spring '15 (API version 33.0)
Winter '15 (API version 32.0)
検索とクエリの使用
このセクションの例では、REST API リソースを使用して、Salesforce Object Search Language (SOSL)、Salesforce Object Query Language (SOQL)、およびその他の検索 API を使用したレコードの検索やクエリを実行します。SOSL および SOQL についての詳細は、『Force.com SOQL および SOSL リファレンス』を参照してください。
-
SOQL クエリを実行する
すべての結果を 1 つの応答で返すか、または必要に応じて、結果の一部と、残りの結果を取得するために使用する識別子を返す SOQL クエリを実行するには、Query リソースを使用します。 -
削除された項目を含む SOQL クエリを実行する
merge または delete で削除されたレコードの情報を含む SOQL クエリを実行するには、QueryAll リソースを使用します。Query リソースでは削除された項目が自動的に除外されるため、Query ではなく QueryAll を使用します。 -
クエリのパフォーマンスに関するフィードバックを取得する
Salesforce でクエリ、レポート、またはリストビューがどのように実行されるかについてフィードバックを取得するには、explain パラメータを指定して Query リソースを使用します。Salesforce では、各クエリを分析して、クエリ結果を取得するための最適な手段が検索されます。クエリおよびクエリ条件に応じて、インデックスまたは内部最適化が使用されることがあります。クエリを実際に実行せずに Salesforce でクエリがどのように最適化されるかについての詳細を返すには、explain パラメータを使用します。応答に基づいて、クエリをセレクティブにするための条件を追加するなどの変更を加えることによって、クエリのパフォーマンスを細かく調整するかどうかを決定できます。 -
文字列を検索する
SOSL 検索を実行するには、Search リソースを使用し、SOSL を使用しない簡単な RESTful 検索を実行するには、Parameterized Search リソースを使用します。 -
デフォルトの検索範囲と検索順序の取得
Search Scope and Order リソースを使用して、ユーザの検索結果ページの固定表示オブジェクトを含め、ログインユーザのデフォルトの検索範囲と検索順序を取得します。 -
オブジェクトの検索結果レイアウトの取得
Search Result Layouts リソースを使用して、クエリ文字列で指定された各オブジェクトの検索結果レイアウトの設定を取得します。 -
関連項目の表示
関連レコードのリストを取得するには、Relevant Items リソースを使用します。