メインコンテンツへスキップ
メタデータクエリとは、/metadata_queries/execute_readエンドポイントに対するPOSTリクエストで、その本文にはメタデータクエリのすべてのパーツが含まれています。ここで最も重要なのは、検索対象のテンプレートを指定するfrom属性、検索するフォルダを指定するancestor_folder_id、検索に使用するすべてのテンプレートフィールドを決定するqueryです。
使用可能なすべてのパラメータの詳細については、Boxの他のまたは関連するを参照してください。

クエリ構文の詳細を確認する

レスポンス

クエリに一致するファイルまたはフォルダがあれば、APIレスポンスで返されます。レスポンスの本文はJSONオブジェクトで、各ファイルまたはフォルダのentriesのリストと、次の検索結果ページを見つけるためのnext_marker値が含まれています。各エントリは、クエリに一致したファイルまたはフォルダを表し、fieldパラメータで明示的にリクエストされたフィールドのみが返されます。
このAPIはデフォルトで、ページあたり20個の項目を返しますが、マーカーベースのページネーションを使用すると、さらに多くの項目をリクエストできます。

ページ割りクエリの結果の詳細を確認する

最終更新日 2026年7月1日