Skip to main content
POST
Python
Box SDKのバージョニング戦略について詳しく学ぶ。」

承認

Authorization
string
header
必須

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

ヘッダー

box-version
enum<string>
必須

Version header.

利用可能なオプション:
2026.0

ボディ

application/json

実行するクエリを記述するリクエスト本文。フィルタ処理の述語、並べ替え (省略可)、ページネーション、各結果で返されるフィールドが含まれます。

query
object
必須

クエリの定義。フィルタ処理の述語、そのパラメータ (省略可能)、先祖の制限が含まれます。

order_by
クエリの並べ替えの基準 · object[]

結果セットの並べ替え基準。エントリが順次適用され、複数レベルの並べ替えが定義されます。

limit
integer<int32>
デフォルト:50

返される結果の最大数。指定されていない場合はデフォルトで50に設定されます。

必須範囲: 0 <= x <= 100
:

1

fields
string[]

各結果エントリに含まれる追加のフィールドを制御します。各値は、項目フィールドの完全修飾キー (例: box:item:name)、テンプレート全体をハイドレートするメタデータテンプレートキー (例: enterprise_12345678:project)、またはテンプレートから単一のフィールドをハイドレートするメタデータテンプレートの特定のフィールドキー (例: enterprise_12345678:project:name) のいずれかである必要があります。省略した場合、エントリには項目の種類と識別子のみが含まれます。

:
marker
string

前回のレスポンスから返された不明瞭なトークンで、取得を継続するために使用されます。指定されている場合、他のすべてのリクエストパラメータは、元のリクエストのものと厳密に一致している必要があります。

:

"xppy0jjG1kBRSc7NBBSgQmBz1Gk6VaQdg5Vyb+Ob0iA="

レスポンス

クエリに一致する項目のページ割りされたリストが返されます。

マイルストーンベースのマーカーページネーションを使用した、クエリに一致する項目のページ割りされたリスト。

entries
クエリの結果のエントリ · object[]
必須

クエリの述語に一致する項目のリスト。

next_marker
string | null
必須

次の結果ページの開始を示すマーカー。nullの場合、追加で表示できる結果はありません。

:

"xppy0jjG1kBRSc7NBBSgQmBz1Gk6VaQdg5Vyb+Ob0iA="

limit
integer<int32>
必須

このリクエストに使用された制限。許容される最大値を超えていない限り、クエリパラメータのlimitと等しくなります。

:

50

最終更新日 2026年8月19日