Skip to main content
POST
内部ID、または固有のプロパティー値を基準にリードをバッチ読み取り

Supported products

承認

Authorization
string
header
必須

The access token received from the authorization server in the OAuth 2.0 flow.

クエリパラメータ

archived
boolean
デフォルト:false

アーカイブ済みの結果のみを返すかどうか。

ボディ

application/json

CRMオブジェクトをバッチ読み取りするための入力を指定します。これには、オブジェクトIDの配列、要求されたプロパティー名(任意の履歴を含む)、および任意の重複しない識別プロパティーが含まれます。

inputs
object[]
必須

読み取るオブジェクトのIDを含むSimplePublicObjectIdオブジェクトの配列です。これらのIDは、バッチ読み取り操作に含めるオブジェクトを指定するために使用されます。

properties
string[]
必須

各オブジェクトに対して返されるプロパティーを表す文字列の配列です。指定されたプロパティーがオブジェクトに存在しない場合は、無視されます。

propertiesWithHistory
string[]
必須

以前の値の履歴とともに返されるプロパティーを表す文字列の配列です。このパラメーターを使用すると、1つのリクエストで読み取れるオブジェクトの数が減少する場合があります。

idProperty
string

カスタム固有値プロパティーを使用してレコードを取得する場合は、プロパティーの名前。レコードIDによって取得する場合は、このパラメーターを含めないでください。

レスポンス

successful operation

公開オブジェクトのバッチレスポンスオブジェクト

completedAt
string<date-time>
必須

バッチ操作が完了した日時(ISO 8601形式)。

results
object[]
必須

バッチ処理で処理されたシンプルな公開オブジェクトの配列。

startedAt
string<date-time>
必須

バッチ操作が開始された日時(ISO 8601形式)。

status
enum<string>
必須

バッチ操作の現在のステータス。有効な値は「PENDING」、「PROCESSING」、「CANCELED」、「COMPLETE」です。

利用可能なオプション:
CANCELED,
COMPLETE,
PENDING,
PROCESSING

リンク名とバッチ操作に関する追加情報を提供する関連URIの対応付け。

requestedAt
string<date-time>

バッチ操作が要求された日時(ISO 8601形式)。

最終更新日 2026年10月6日