> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myunite.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Marcas

> Cadastre diretrizes de marca para os próximos pré-testes.

Para avaliar o uso de cores, logo e slogan, o Ad Score precisa das diretrizes da marca. Antes de criar uma marca, consulte `brands` em `GET /adscore/catalog` ou `adscore_get_catalog` com `adscore:read`. Cada marca tem um `id` e indicadores de disponibilidade em `readiness`.

## Permissão para gravar

Gravar exige `brands:write` e papel atual de Editor ou Administrador no workspace. Ao conectar, o conector já pede `brands:write` junto com as permissões do Ad Score. A permissão vem com o papel: na autorização da Unite, basta escolher o workspace. Para Editor e Administrador, a lista do que o aplicativo poderá fazer inclui **Criar e completar marcas**, e a conexão leva `brands:write` junto com o resto. O Visualizador nunca recebe a permissão e conecta só para leitura. Dependendo das suas configurações, o aplicativo pode pedir confirmação antes de gravar.

Uma conexão feita antes, ou por um aplicativo que não pediu `brands:write`, não ganha a permissão sozinha: a renovação automática mantém as permissões anteriores. Se o aplicativo chamar uma ferramenta de marca sem a permissão, a resposta é [`insufficient_scope`](https://docs.myunite.ai/errors#insufficient_scope) e pede as permissões que a conexão já tem mais `brands:write`. Ao conectar de novo com esse pedido, o Ad Score continua disponível e as marcas passam a ser gravadas. Usar um guia que você já tem para montar uma apresentação dispensa essa permissão. Para usar a API, peça ao administrador uma chave com o escopo de marcas.

## Criar ou completar

| Operação | API | Ferramenta |
| - | - | - |
| Criar | `POST /api/v1/brands` | `unite_create_brand` |
| Completar | `PATCH /api/v1/brands/{id}` | `unite_update_brand` com `brandId` |

Informe a origem em `source`. Use `brand_book` para o manual oficial, `user` para dados fornecidos pela pessoa e `web` para pesquisa na web. Prefira o manual oficial. Você pode pesquisar e apresentar uma proposta. Antes de **gravar** dados da web, mostre os valores, peça a confirmação da pessoa e só então envie `userConfirmed: true`.

A criação exige `name`. Para completar, envie pelo menos um campo de marca. Este exemplo acrescenta a cor e o slogan do manual da marca fictícia Brisa:

```bash theme={null}
curl -X PATCH "https://myunite.ai/api/v1/brands/$BRAND_ID" \
  -H "Authorization: Bearer $UNITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source":"brand_book","colors":["#176B60"],"taglines":["Brisa de perto"]}'
```

Use cores hexadecimais com três ou seis dígitos. Para o logo, passe `logoUploadId`. Para outros elementos visuais, envie `distinctiveAssets` com um `uploadId` e uma `description` por item. Use imagens PNG, JPEG, WebP ou GIF de até 8 MB cada, enviadas ao mesmo workspace. [Envio de arquivos](https://docs.myunite.ai/uploads.md)

A atualização acrescenta o que falta e preserva os dados salvos. Repetir as mesmas cores ou slogans não cria duplicatas. Se enviar outro logo quando a marca já tem um, a resposta mantém o atual e descreve a divergência em `conflicts`. Outros acréscimos compatíveis podem ter sido salvos na mesma chamada. Revise os conflitos no editor indicado em `brand.url`.

## Usar a marca no próximo pré-teste

A resposta traz a marca em `brand`, as diretrizes disponíveis em `readiness`, as verificações habilitadas em `enabledChecks` e as habilitadas nesta gravação em `newlyEnabledChecks`. Use `brand.id` como `brandId` ao criar o próximo pré-teste. Gravar diretrizes não consome cota de análise.

`POST` devolve `201` ao criar e `200` ao repetir a criação. Para repetir com uma chave explícita, mantenha o mesmo corpo e o mesmo `Idempotency-Key` (na ferramenta, `idempotencyKey`). Sem chave explícita, chamadas idênticas com a mesma credencial também reaproveitam a criação. `PATCH` devolve `200`. [Códigos de erro](https://docs.myunite.ai/errors.md)


## Related topics

- [Erros](https://docs.myunite.ai/errors.md)
- [Resultados](https://docs.myunite.ai/results.md)
- [Idempotência](https://docs.myunite.ai/idempotency.md)
- [Pré-teste OOH](https://docs.myunite.ai/pretests/ooh.md)
- [Envio de arquivos](https://docs.myunite.ai/uploads.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.