# Gestion des collections

Consultez la page de documentation de [HfApi](/docs/huggingface_hub/main/fr/package_reference/hf_api#huggingface_hub.HfApi) pour la référence des méthodes permettant de gérer votre Space sur le Hub.

- Récupérer le contenu de la collection : [get_collection()](/docs/huggingface_hub/main/fr/package_reference/hf_api#huggingface_hub.HfApi.get_collection)
- Créer une nouvelle collection : [create_collection()](/docs/huggingface_hub/main/fr/package_reference/hf_api#huggingface_hub.HfApi.create_collection)
- Mettre à jour une collection : [update_collection_metadata()](/docs/huggingface_hub/main/fr/package_reference/hf_api#huggingface_hub.HfApi.update_collection_metadata)
- Mettre à jour le groupe de ressources d'une collection : [update_collection_resource_group()](/docs/huggingface_hub/main/fr/package_reference/hf_api#huggingface_hub.HfApi.update_collection_resource_group)
- Supprimer une collection : [delete_collection()](/docs/huggingface_hub/main/fr/package_reference/hf_api#huggingface_hub.HfApi.delete_collection)
- Ajouter un élément à une collection : [add_collection_item()](/docs/huggingface_hub/main/fr/package_reference/hf_api#huggingface_hub.HfApi.add_collection_item)
- Mettre à jour un élément dans une collection : [update_collection_item()](/docs/huggingface_hub/main/fr/package_reference/hf_api#huggingface_hub.HfApi.update_collection_item)
- Supprimer un élément d'une collection : [delete_collection_item()](/docs/huggingface_hub/main/fr/package_reference/hf_api#huggingface_hub.HfApi.delete_collection_item)

### Collection[[huggingface_hub.Collection]]

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

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

[Source](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L1386)

**Paramètres :**

slug (`str`) : Slug de la collection. Par exemple, `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.

title (`str`) : Titre de la collection. Par exemple, `"Recent models"`.

owner (`str`) : Propriétaire de la collection. Par exemple, `"TheBloke"`.

items (`list[CollectionItem]`) : Liste des éléments de la collection.

last_updated (`datetime`) : Date de la dernière mise à jour de la collection.

position (`int`) : Position de la collection dans la liste des collections du propriétaire.

private (`bool`) : Indique si la collection est privée ou non.

theme (`str`) : Thème de la collection. Par exemple, `"green"`.

upvotes (`int`) : Nombre de votes positifs de la collection.

description (`str`, *facultatif*) : Description de la collection, sous forme de texte brut.

url (`str`) : (propriété) URL de la collection sur le Hub.

Contient des informations sur une Collection sur le 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)
```

[Source](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L1338)

**Paramètres :**

item_object_id (`str`) : Identifiant unique de l'élément dans la collection.

item_id (`str`) : ID de l'objet sous-jacent sur le Hub. Peut être un repo_id, un identifiant de papier, un slug de collection ou un identifiant de bucket. Par exemple `"jbilcke-hf/ai-comic-factory"`, `"2307.09288"`, `"celinah/cerebras-function-calling-682607169c35fbfa98b30b9a"`.

item_type (`str`) : Type de l'objet sous-jacent. Peut être l'un des éléments suivants : `"model"`, `"dataset"`, `"space"`, `"paper"`, `"collection"` ou `"bucket"`.

position (`int`) : Position de l'élément dans la collection.

note (`str`, *facultatif*) : Note associée à l'élément, en texte brut.

Contient des informations sur un élément d'une Collection (modèle, jeu de données, Space, article, collection ou bucket).