Box Developerドキュメント
最新バージョン

ファイルのアプリ項目の関連付けのリストを取得

get
https://api.box.com/2.0
/files/:file_id/app_item_associations

これはベータ機能のため、利用が制限される可能性があります。ファイルが関連付けられているアプリ項目をすべて返します。これには、ファイルの先祖に関連付けられているアプリ項目が含まれます。コンテキストユーザーがファイルにアクセスできることを前提に、コンテキストユーザーにアプリ項目の表示権限がなくても、種類/IDが示されます。

リクエスト

bearer [ACCESS_TOKEN]
application/json

パスパラメータ

stringパス内必須
12345

ファイルを表す一意の識別子。

ファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLがhttps://*.app.box.com/files/123の場合、file_id123です。

クエリパラメータ

stringクエリ内省略可能
hubs

指定した場合、このアプリケーションの種類のアプリ項目だけが返されます。

integer (int64)クエリ内省略可能
1000
1000

返す項目の1ページあたりの最大数。

stringクエリ内省略可能
JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii

結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。

これを使用するには、usemarkertrueに設定する必要があります。

レスポンス

アプリ項目オブジェクトのコレクションを返します。このファイルにアプリ項目がない場合は、空のコレクションが返されます。このリストには、このファイルの先祖にあるアプリ項目が含まれます。

ファイルが見つからない場合、またはユーザーにファイルへのアクセス権限が与えられていない場合に返されます。

予期しないクライアントエラー。

get
ファイルのアプリ項目の関連付けのリストを取得
このドキュメント内で一部のAPIを試せるようになりました。
ログイン

リクエストの例

TypeScript Gen
await client.appItemAssociations.getFileAppItemAssociations(fileId);
Python Gen
client.app_item_associations.get_file_app_item_associations(file_id)
.NET Gen
await client.AppItemAssociations.GetFileAppItemAssociationsAsync(fileId: 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"
}