Box Developerドキュメント
ログイン

コレクションへの項目の追加

ガイド コレクション コレクションへの項目の追加

コレクションへの項目の追加

コレクションに項目を追加するには、その特定のタイプの項目に対してPUTエンドポイントを呼び出し、コレクションIDのリストを渡します。

APIを介して使用できるコレクションは「お気に入り」コレクションのみです。このコレクションのIDはユーザーごとに異なります。

コレクションへのファイルの追加

コレクションにファイルを追加するには、PUT /files/:id APIを呼び出し、コレクションIDのリストを渡します。

cURL
curl -i -X PUT "https://api.box.com/2.0/files/12345" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{
       "collections": [
          {
            "id": "123"
          }
       ]
     }'
Java
BoxCollection favorites = null;
for (BoxCollection.Info info : BoxCollection.getAllCollections(api)) {
    if (info.getCollectionType().equals("favorites")) {
        favorites = info.getResource();
        break;
    }
}
BoxFile file = new BoxFile(api, "id");
file.setCollections(favorites);
Python
collection = client.collection(collection_id='12345')
updated_file = client.file(file_id='11111').add_to_collection(collection)
print(f'File "{updated_file.name}" added to collection!')
.NET
// Put file 11111 into collection 22222
BoxCollectionsRequest requestParams = new BoxCollectionsRequest()
{
    Collections = new List<BoxRequestEntity>()
    {
        new BoxRequestEntity()
        {
            Id = "22222"
        }
    };
};
BoxFile file = await client.CollectionsManager.CreateOrDeleteCollectionsForFileAsync(fileId: "11111", requestParams);
Node
client.files.addToCollection('87263', '235747', callback);
iOS
client.files.addToFavorites(fileId: "11111") { (result: Result<Void, BoxSDKError>) in
    guard case .success = result else {
        print("Error adding file to favorites")
        return
    }

    print("File added to favorites")
}

コレクションへのフォルダの追加

コレクションにフォルダを追加するには、PUT /folders/:id APIを呼び出し、コレクションIDのリストを渡します。

cURL
curl -i -X PUT "https://api.box.com/2.0/folders/12345" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{
       "collections": [
          {
            "id": "123"
          }
       ]
     }'
Node
client.folders.addToCollection('87263', '235747', callback);

コレクションへのウェブリンクの追加

コレクションにウェブリンクを追加するには、PUT /web_links/:id APIを呼び出し、コレクションIDのリストを渡します。

cURL
curl -i -X PUT "https://api.box.com/2.0/web_links/12345" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{
       "collections": [
          {
            "id": "123"
          }
       ]
     }'
Node
client.weblinks.addToCollection('87263', '235747', callback);