# Управление коллекциями

См. страницу документации [HfApi](/docs/huggingface_hub/v2.4.0/ru/package_reference/hf_api#huggingface_hub.HfApi) для справочника методов управления вашим Space на Hub.

- Получение содержимого коллекции: [get_collection()](/docs/huggingface_hub/v2.4.0/ru/package_reference/hf_api#huggingface_hub.HfApi.get_collection)
- Создать новую коллекцию: [create_collection()](/docs/huggingface_hub/v2.4.0/ru/package_reference/hf_api#huggingface_hub.HfApi.create_collection)
- Обновление коллекции: [update_collection_metadata()](/docs/huggingface_hub/v2.4.0/ru/package_reference/hf_api#huggingface_hub.HfApi.update_collection_metadata)
- Обновление ресурсной группы коллекции: [update_collection_resource_group()](/docs/huggingface_hub/v2.4.0/ru/package_reference/hf_api#huggingface_hub.HfApi.update_collection_resource_group)
- Удалить коллекцию: [delete_collection()](/docs/huggingface_hub/v2.4.0/ru/package_reference/hf_api#huggingface_hub.HfApi.delete_collection)
- Добавить элемент в коллекцию: [add_collection_item()](/docs/huggingface_hub/v2.4.0/ru/package_reference/hf_api#huggingface_hub.HfApi.add_collection_item)
- Обновить элемент в коллекции: [update_collection_item()](/docs/huggingface_hub/v2.4.0/ru/package_reference/hf_api#huggingface_hub.HfApi.update_collection_item)
- Удалить элемент из коллекции: [delete_collection_item()](/docs/huggingface_hub/v2.4.0/ru/package_reference/hf_api#huggingface_hub.HfApi.delete_collection_item)

### Коллекция[[huggingface_hub.Collection]]

#### huggingface_hub.Collection[[huggingface_hub.Collection]]

```python
huggingface_hub.Collection(**kwargs)
```

[Источник](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1381)

**Параметры:**

slug (`str`) : Slug коллекции. Например, `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.

title (`str`) : Название коллекции. Например, `"Recent models"`.

owner (`str`) : Владелец коллекции. Например, `"TheBloke"`.

items (`list[CollectionItem]`) : список элементов в коллекции.

last_updated (`datetime`) : дата последнего обновления коллекции.

position (`int`) : Позиция коллекции в списке коллекций владельца.

private (`bool`) : Указывает, является ли коллекция частной.

theme (`str`) : Тема коллекции. Например, `"green"`.

upvotes (`int`) : Количество «лайков» коллекции.

description (`str`, *необязательный*) : Описание коллекции в виде обычного текста.

url (`str`) : (property) URL коллекции на Hub.

Содержит информацию о коллекции на Hub.

### CollectionItem[[huggingface_hub.CollectionItem]]

#### huggingface_hub.CollectionItem[[huggingface_hub.CollectionItem]]

```python
huggingface_hub.CollectionItem(_id: str, id: str, type: CollectionItemType_T, position: int, note: dict | None = None, **kwargs)
```

[Источник](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1333)

**Параметры:**

item_object_id (`str`) : Уникальный идентификатор элемента в коллекции.

item_id (`str`) : ID базового объекта на Hub. Может быть repo_id, paper id, collection slug или bucket id. Например, `"jbilcke-hf/ai-comic-factory"`, `"2307.09288"`, `"celinah/cerebras-function-calling-682607169c35fbfa98b30b9a"`.

item_type (`str`) : Тип базового объекта. Может быть одним из `"model"`, `"dataset"`, `"space"`, `"paper"`, `"collection"` или `"bucket"`.

position (`int`) : Позиция элемента в коллекции.

note (`str`, *необязательный*) : Примечание, связанное с элементом, в виде обычного текста.

Содержит информацию об элементе коллекции (модели, наборе данных, Space, статье, коллекции или bucket).