最新バージョン
ファイルのアプリ項目の関連付けのリストを取得
APIバージョン 2024.0
これはベータ機能のため、利用が制限される可能性があります。ファイルが関連付けられているアプリ項目をすべて返します。これには、ファイルの先祖に関連付けられているアプリ項目が含まれます。コンテキストユーザーがファイルにアクセスできることを前提に、コンテキストユーザーにアプリ項目の表示権限がなくても、種類/IDが示されます。
リクエスト
bearer [ACCESS_TOKEN]
application/json
パスパラメータ
stringパス内必須
12345ファイルを表す一意の識別子。
ファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLがhttps://*.app.box.com/files/123の場合、file_idは123です。
クエリパラメータ
stringクエリ内省略可能
hubs指定した場合、このアプリケーションの種類のアプリ項目だけが返されます。
integer (int64)クエリ内省略可能
10001000返す項目の1ページあたりの最大数。
stringクエリ内省略可能
JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。
これを使用するには、usemarkerをtrueに設定する必要があります。
レスポンス
application/jsonアプリ項目の関連付け
アプリ項目オブジェクトのコレクションを返します。このファイルにアプリ項目がない場合は、空のコレクションが返されます。このリストには、このファイルの先祖にあるアプリ項目が含まれます。
application/jsonクライアントエラー
ファイルが見つからない場合、またはユーザーにファイルへのアクセス権限が与えられていない場合に返されます。
application/jsonクライアントエラー
予期しないクライアントエラー。
リクエストの例
Node/TypeScript v10
await client.appItemAssociations.getFileAppItemAssociations(fileId);Python v10
client.app_item_associations.get_file_app_item_associations(file_id).NET v10
await client.AppItemAssociations.GetFileAppItemAssociationsAsync(fileId: fileId);Swift v10
try await client.appItemAssociations.getFileAppItemAssociations(fileId: fileId)Java v10
client.getAppItemAssociations().getFileAppItemAssociations(fileId)レスポンスの例
{
"entries": [
{
"app_item": {
"application_type": "hubs",
"id": "12345678",
"type": "app_item"
},
"id": "12345678",
"item": {
"etag": "1",
"id": "12345",
"type": "file"
},
"type": "app_item_association"
}
],
"limit": 1000,
"next_marker": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii",
"prev_marker": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih"
}