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

Query

指定された SOQL クエリを実行します。

SOQL クエリが実行された場合、同期要求で一度に最大 2,000 個のレコードが返されます。ただし、パフォーマンスを最適化するために、返されるバッチには、照会されたレコードのサイズと複雑さに基づいて、制限値またはリクエストで設定された値よりも少ない数のレコードを含めることができます。結果の合計数が、この制限または結果の要求数を超える場合、応答に含まれるのは、レコードの最初のバッチ、false 値の done、およびクエリロケーターになります。クエリロケーターは、次のレコードのバッチを取得するために「Query More Results」リソースで使用できます。

応答には、QueryAll 要求で返されたレコードの総数 (totalSize)、これ以上結果がないことを示す Boolean 値 (done)、後続のレコードの URI (nextRecordsUrl)、クエリ結果レコードの配列 (records) が含まれます。

構文

URI

/services/data/vXX.X/query?q=query

形式

JSON、XML

HTTP メソッド

GET

認証

Authorization: Bearer token

パラメーター

パラメーター	説明
q	SOQL クエリ。有効な URI を作成するには、クエリ文字列でスペースをプラス記号 `+` または `%20` に置き換えます。たとえば、`SELECT+Name+FROM+MyObject` のようになります。SOQL クエリ文字列が無効な場合、MALFORMED_QUERY 応答が返されます。

例

レスポンスボディの例

1{
2  "totalSize": 3222,
3  "done": false,
4  "nextRecordsUrl": "/services/data/v60.0/query/01gRO0000016PIAYA2-500",
5  "records": [
6    {
7      "attributes": {
8        "type": "Contact",
9        "url": "/services/data/v60.0/sobjects/Contact/003RO0000035WQgYAM"
10      },
11      "Id": "003RO0000035WQgYAM",
12      "Name": "John Smith"
13    },
14    ...
15  ]
16}

SOQL クエリ実行のリソース

例については、「SOQL クエリを実行する」を参照してください。
バッチサイズの変更については、「Query Options ヘッダー」を参照してください。
explain パラメーターを使用してクエリおよびレポートでフィードバックを取得するには、「クエリのパフォーマンスに関するフィードバックを取得する」を参照してください。
SOQL 全般についての詳細は、『SOQL および SOSL リファレンス』を参照してください。

REST API 開発者ガイド

Query

構文

例

SOQL クエリ実行のリソース