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 exigebrands: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 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
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:
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
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 embrand, 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