# Gerenciando coleções

Confira a página de documentação do [HfApi](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi) para a referência dos métodos para gerenciar seu Space no Hub.

- Obter o conteúdo da coleção: [get_collection()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.get_collection)
- Criar nova coleção: [create_collection()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.create_collection)
- Atualizar uma coleção: [update_collection_metadata()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.update_collection_metadata)
- Atualizar o grupo de recursos de uma coleção: [update_collection_resource_group()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.update_collection_resource_group)
- Excluir uma coleção: [delete_collection()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.delete_collection)
- Adicione um item a uma coleção: [add_collection_item()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.add_collection_item)
- Atualizar um item em uma coleção: [update_collection_item()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.update_collection_item)
- Remove um item de uma coleção: [delete_collection_item()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.delete_collection_item)

### Coleção[[huggingface_hub.Collection]]

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

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

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

**Parâmetros:**

slug (`str`) : Slug da coleção. Ex.: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.

title (`str`) : Título da coleção. Ex.: `"Recent models"`.

owner (`str`) : Proprietário da coleção. Ex.: `"TheBloke"`.

items (`list[CollectionItem]`) : Lista de itens na coleção.

last_updated (`datetime`) : Data da última atualização da coleção.

position (`int`) : Posição da coleção na lista de coleções do proprietário.

private (`bool`) : Indica se a coleção é privada ou não.

theme (`str`) : Tema da coleção. Ex.: `"green"`.

upvotes (`int`) : Número de votos positivos da coleção.

description (`str`, *opcional*) : Descrição da coleção, como texto simples.

url (`str`) : (property) URL da coleção no Hub.

Contém informações sobre uma Coleção no 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)
```

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

**Parâmetros:**

item_object_id (`str`) : ID único do item na coleção.

item_id (`str`) : ID do objeto subjacente no Hub. Pode ser um repo_id, um ID de artigo, um slug de coleção ou um ID de bucket. Ex.: `"jbilcke-hf/ai-comic-factory"`, `"2307.09288"`, `"celinah/cerebras-function-calling-682607169c35fbfa98b30b9a"`.

item_type (`str`) : Tipo do objeto subjacente. Pode ser um de `"model"`, `"dataset"`, `"space"`, `"paper"`, `"collection"` ou `"bucket"`.

position (`int`) : Posição do item na coleção.

note (`str`, *opcional*) : Nota associada ao item, como texto simples.

Contém informações sobre um item de uma Collection (modelo, dataset, Space, paper, collection ou bucket).