

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Personalização da marca Amazon Quick
<a name="brand-customization"></a>

O Amazon Quick permite que os administradores de contas personalizem a marca e o tema visual do aplicativo de acordo com as diretrizes da organização. Essa personalização inclui os seguintes elementos visuais para criar uma aparência coesa em todas as páginas, agendas, alertas e relatórios de e-mail não administrativos do console Amazon Quick.
+ Logo
+ Favicon
+ Texto alternativo associado para ativos visuais

A lista a seguir mostra as diferentes áreas em que as cores do tema personalizável estão agrupadas.

**Cores da marca**
+ As cores da **barra de navegação global** são aplicadas à barra superior da interface do usuário do Amazon Quick e incluem o logotipo da empresa que é exibido nos consoles Amazon Quick padrão e incorporados.
+ As cores da **barra de aplicações** são aplicadas à barra de navegação secundária que contém ações contextuais.

**Cores de interação**
+ As cores de **destaque** são aplicadas a elementos interativos, como botões, bordas e ícones.

**Cores de superfície**
+ As cores **primárias** são aplicadas em superfícies de alta ênfase, como o fundo e o texto da página inicial.
+ As cores **secundárias** são aplicadas em superfícies práticas, como bordas, fundos e campos de formulários. As cores secundárias são usadas junto com as cores primárias.

**Cores de status**
+ As cores de **sucesso** são aplicadas às mensagens de sucesso.
+ As cores de **perigo** são aplicadas às mensagens de erro.
+ As cores de **aviso** são aplicadas às mensagens de aviso.
+ As cores de **informações** são aplicadas às mensagens informativas.

**Cores de visualização de dados**
+ As cores de **dimensão** são usadas para identificar associações entre colunas de dados que compartilham o mesmo perfil.
+ As cores de **medida** são usadas para identificar métricas ou valores mensurados.

**Recursos**
+ As cores de **visualização** são aplicadas ao ícone de **visualização**.
+ As cores do **Insight** são aplicadas ao ícone do **Insight**.
+ As cores da **conexão** são aplicadas ao ícone **Conexão**.
+ As cores de **automação** são aplicadas ao ícone **Automação**.

Use as seções a seguir para começar com a personalização da marca no Amazon Quick.

**Topics**
+ [Permissões para personalização da marca Amazon Quick](#brand-customization-permissions)
+ [Crie uma marca personalizada no Amazon Quick](#brand-customization-create)
+ [Definindo um tema padrão para análises do Amazon Quick com o Amazon Quick APIs](customizing-quicksight-default-theme.md)

## Permissões para personalização da marca Amazon Quick
<a name="brand-customization-permissions"></a>

Para configurar uma marca, você deve receber um perfil de administrador por meio do Centro de Identidade do IAM ou do IAM. Administradores cujas funções são concedidas a eles no Amazon Quick não podem criar marcas. Para saber mais sobre como integrar sua conta com o IAM Identity Center, consulte [Configurar sua conta Amazon Quick com o IAM Identity Center](https://docs.aws.amazon.com/quicksight/latest/user/sec-identity-management-identity-center.html). Para obter informações sobre funções e capacidades administrativas, consulte [Entendendo as assinaturas e funções do Amazon Quick](https://docs.aws.amazon.com/quicksight/latest/user/user-types.html#subscription-role-mapping).

Usuários administradores só podem gerenciar marcas que estejam na mesma região de capacidade de sua conta Amazon Quick.

A função do IAM que você usa para criar uma marca no Amazon Quick deve conter permissões de ação granulares `quicksight:*` ou granulares para gerenciar marcas no console de administração. As seguintes permissões granulares são necessárias para que os administradores trabalhem com as marcas Amazon Quick:
+ `quicksight:CreateBrand`
+ `quicksight:UpdateBrand`
+ `quicksight:DescribeBrand`
+ `quicksight:DescribeBrandPublishedVersion`
+ `quicksight:UpdateBrandPublishedVersion`
+ `quicksight:DeleteBrand`
+ `quicksight:ListBrands`
+ `quicksight:UpdateBrandAssignment`
+ `quicksight:DescribeBrandAssignment`
+ `quicksight:DeleteBrandAssignment`

Depois de confirmar que sua função de administrador contém as permissões necessárias, você pode [criar uma marca personalizada](https://docs.aws.amazon.com/quicksight/latest/user/brand-customization-create.html) no console de administração do Amazon Quick.

## Crie uma marca personalizada no Amazon Quick
<a name="brand-customization-create"></a>

Use o procedimento a seguir para criar uma marca personalizada no Amazon Quick.

1. Abra o [console do Quick](https://quicksight.aws.amazon.com/).

1. Escolha o ícone do usuário no canto superior direito e escolha **Gerenciar rápido**.

1. Escolha **Personalizar aplicação**.

1. Na página **Personalizar aplicativo** que é aberta, escolha **ADICIONAR MARCA**. A página **Configurações da marca** é aberta.

1. Navegue até a seção **Informações da marca**.

1. Em **Nome da marca**, insira um nome para a marca. O nome da marca pode conter até 512 caracteres.

1. (Opcional) Em **Descrição da marca**, insira uma descrição para a marca personalizada. A descrição da marca pode conter até 512 caracteres.

1. Navegue até a seção **Logotipo**.  
![\[A seção Logotipo da página de Informações da marca.\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/logo.png)

1. **Em **Primário**, escolha as reticências (três pontos) ao lado do ícone principal e, em seguida, escolha Substituir imagem.**

1. No pop-up **Escolher imagem** que é aberto, execute uma das seguintes ações:

   1. Arraste e solte a imagem na caixa **Arraste uma imagem aqui**.

   1. Escolha **Selecionar um arquivo** para selecionar um arquivo do seu computador.

   1. Insira uma URL público ou um URI do Amazon S3 na barra de texto.

   A imagem que você escolher deve ser no formato `.jpeg`, `.png` ou `.svg` e não pode exceder 1 MB.

   Quando terminar de escolher a imagem, escolha **Aplicar**.

1. Em **Favicon**, escolha as reticências (três pontos) ao lado do ícone de favicon e, em seguida, escolha **Substituir imagem**.

1. No pop-up **Escolher imagem** que é aberto, execute uma das seguintes ações:

   1. Arraste e solte a imagem na caixa **Arraste uma imagem aqui**.

   1. Escolha **Selecionar um arquivo** para selecionar um arquivo do seu computador.

   1. Insira uma URL público ou um URI do Amazon S3 na barra de texto.

   A imagem que você escolher deve ser no formato `.jpeg`, `.png` ou `.svg` e não pode exceder 1 MB.

   Quando terminar de escolher a imagem, escolha **Aplicar**.

1. (Opcional) Para **texto alternativo**, insira texto alternativo a ser exibido com o logotipo. O texto alternativo pode conter até 512 caracteres.

1. Para fazer alterações nas cores do tema da marca, navegue até o painel **Aparência** à esquerda e escolha **Tema**.

1. A página de **configurações do tema** aparece e exibe todas as partes de um tema Amazon Quick que podem ser personalizadas. A imagem a seguir mostra as configurações da barra de navegação global.  
![\[As configurações da barra de navegação global. Use as amostras de plano de fundo e primeiro plano para personalizar as cores de cada item do tema listado na página de configurações do tema.\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/navigation-bar.png)

1. Para alterar a cor de fundo de uma área, navegue até o item que você deseja alterar e escolha a amostra da cor de **Plano de fundo**.

1. No pop-up **Personalizar cor** exibido, escolha uma cor no gradiente de cores ou insira um valor de código hexadecimal na barra **HEXADECIMAL** e escolha **APLICAR**.

1. Para alterar a cor de primeiro plano de uma área, navegue até o item que você deseja alterar e escolha a amostra da cor de **Primeiro plano**.

1. No pop-up **Personalizar cor** exibido, escolha uma cor no gradiente de cores ou insira um valor de código hexadecimal na barra **HEXADECIMAL** e escolha **APLICAR**.

1. Quando você terminar de configurar uma marca personalizada, escolha **PUBLICAR para publicar** e aplicar a personalização da marca em todas as contas de usuário do Amazon Quick. Se você não quiser publicar a marca, escolha **SALVAR** para salvar a marca para mais tarde.

Quando você termina de criar uma marca no Amazon Quick, a nova marca aparece na tabela de marcas na página **Personalizar aplicativo** do console de administração do Quick. A coluna **Status** da tabela de marcas indica qual marca está atualmente publicada na conta rápida. Para fazer alterações em uma marca personalizada, localize a marca que você deseja alterar na tabela de marcas, escolha o ícone de reticências (três pontos) na coluna **Ações**, e depois escolha **Publicar**, **Editar** ou **Excluir**. 

Depois de publicar uma marca, pode levar até 10 minutos para que a nova marca se propague entre todos os usuários.

# Definindo um tema padrão para análises do Amazon Quick com o Amazon Quick APIs
<a name="customizing-quicksight-default-theme"></a>

**Para definir um tema padrão usando a API**

1. Identifique o tema personalizado que você deseja usar como padrão e localize o ID do tema. Se você quiser usar um dos temas QuickSight iniciais, pule esta etapa. 

   Para obter o ID do tema de um tema personalizado, use a operação de [ListThemes](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_ListThemes.html)API para a região em que o tema está. Certifique-se de que o tema esteja na mesma região dos usuários ou grupos que precisam usá-lo.

   O exemplo a seguir mostra um script de shell que usa o comando `list-themes` no AWS CLI. Ele define o ID da AWS conta e Região da AWS as variáveis as. Se você usou `aws configure` anteriormente para definir uma região padrão, adicionar a variável `--region` ao comando substitui a configuração padrão.

   ```
   #declare variables
   awsacct1='111122223333'
   region='us-west-2'
   
   aws quicksight list-themes \
   --region $region \
   --aws-account-id $awsacct1 \
   --type 'CUSTOM'
   ```

   

1. Use a operação [ListUsers](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_ListUsers.html)ou [ListGroups](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_ListGroups.html)API para coletar os Amazon Resource Names (ARNs) para usuários ou grupos que precisam usar o tema como padrão. Você precisa apenas do ARN de nível superior. Se todos os seus usuários fizerem parte do mesmo grupo, use o ARN do grupo. 

   Para obter mais informações sobre o Amazon Quick ARNs, consulte [os formatos ARN](https://docs.aws.amazon.com//quicksight/latest/APIReference/qs-arn-format.html) na Referência *rápida da API*. 

1. Se você estiver usando um tema personalizado, conceda acesso ao tema ARNs que você coletou na etapa anterior. Se estiver usando um tema inicial, pule esta etapa, pois todos os usuários têm acesso aos temas iniciais. 

   O exemplo a seguir mostra um script de shell que usa o [update-theme-permissions](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_UpdateThemePermissions.html)comando O `grant-permissions` parâmetro é mostrado usando a sintaxe abreviada. Você pode usar JSON ou YAML. Para obter mais informações, consulte [Especificar valores de parâmetro](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters.html) no *Guia do usuário da AWS Command Line Interface .*

   ```
   #declare variables
   awsacct1='111122223333'
   namespace='default'
   region='us-west-2'
   theme-id='bdb844d0-0fe9-4d9d-b520-0fe602d93639' #Find this with list-themes
   
   aws quicksight update-theme-permissions \
   #Specify region if necessary: --region $region \
   --aws-account-id $awsacct1 \
   --theme-id $theme-id \
   --grant-permissions Principal="arn:aws:quicksight:$region:$awsacct1:group/$namespace/QuickSight_Group_Name",Actions="quicksight:DescribeTheme","quicksight:ListThemeVersions","quicksight:ListThemeAliases","quicksight:DescribeThemeAlias"
   ```

1. Atribua o tema como padrão para o mesmo ARN ou. ARNs

   ```
   #declare variables
   awsacct1='111122223333'
   namespace='default'
   region='us-west-2'
   theme-id='bdb844d0-0fe9-4d9d-b520-0fe602d93639'
   
   aws quicksight create-account-customization \
   #Specify region if necessary: --region $region \
   --aws-account-id $awsacct1 \
   --namespace $namespace \
   --account-customization DefaultTheme="arn:aws:quicksight:$region:$awsacct1:theme/$theme-id"
   ```

Atualmente, existem três temas iniciais: Classic, Midnight e Seaside. Eles ARNs são a grafia em maiúscula do nome do tema. Se você estiver usando um tema inicial em vez de um tema personalizado, use um dos seguintes temas ARNs:
+ `arn:aws:quicksight::aws:theme/CLASSIC`
+ `arn:aws:quicksight::aws:theme/MIDNIGHT`
+ `arn:aws:quicksight::aws:theme/SEASIDE`
+ `arn:aws:quicksight::aws:theme/RAINIER`