Os usuários e desenvolvedores precisam poder ajustar a API Topics para melhorar a relevância do conteúdo. Esta página é um guia sobre como gerenciar e personalizar a API Topics de acordo com as preferências e necessidades do usuário.
Desativar como usuário
Os usuários precisam conseguir:
- Entenda a finalidade da API Topics.
- Reconhecer quais tópicos estão associados à atividade de navegação.
- Saiba quando a API está em uso.
- Ter controles para ativar ou desativar a API.
- Controle quais temas são compartilhados com os autores de chamadas de API.
A taxonomia legível da API Topics permite que os usuários aprendam e controlem os temas que podem ser sugeridos pelo navegador. O Chrome oferece informações e configurações da API Topics em chrome://settings/adPrivacy/interests.
O usuário pode bloquear categorias de temas que não quer compartilhar com autores de chamadas de API das seguintes maneiras:
- Bloquear um tópico que já foi atribuído a eles pelo navegador.
- Bloquear proativamente uma categoria ampla de temas em que não têm interesse em
chrome://settings/adPrivacy/interests/manage. Nesse caso, o usuário não precisa esperar que um tópico seja atribuído antes de bloqueá-lo.
Os temas não ficam disponíveis para autores de chamadas da API no modo de navegação anônima e são excluídos quando o histórico de navegação é limpo.
A lista de temas retornada vai estar vazia nos seguintes cenários:
- O usuário desativa a API Topics nas configurações do navegador em
chrome://settings/adPrivacy/interests. - O usuário limpou os temas (nas configurações do navegador em
chrome://settings/adPrivacy/interests) ou os cookies. - O navegador está no modo de navegação anônima.
- O usuário bloqueia todos os temas possíveis.
A explicação oferece mais detalhes sobre as metas de privacidade e como a API tenta alcançá-las.
Desativar como desenvolvedor
Para desativar o cálculo de temas em páginas específicas do seu site, inclua o cabeçalho Permissions-Policy: browsing-topics=() Permissions-Policy em uma página para impedir o cálculo de temas apenas para todos os usuários nessa página. As visitas subsequentes a outras páginas do seu site não serão afetadas. Se você definir uma política para bloquear a API Topics em uma página, isso não afetará outras páginas.
Também é possível controlar quais terceiros têm acesso aos tópicos na sua página usando o cabeçalho Permissions-Policy para controlar o acesso de terceiros à API Topics. Como parâmetros para o cabeçalho, use self e todos os domínios que você quer permitir o acesso à API. Por exemplo, para desativar completamente o uso da API Topics em todos os contextos de navegação, exceto na sua própria origem e https://example.com, defina o seguinte cabeçalho de resposta HTTP:
Permissions-Policy: browsing-topics=(self "https://example.com")
Consulte também
Confira nossos recursos para entender melhor a API Topics na Web.
- Confira as demonstrações, vídeos de colaboração e de instruções dos tópicos.
- Confira a lista de sinalizações do Chrome que permitem que os desenvolvedores personalizem a API Topics para testes.
- Veja como usuários e desenvolvedores podem controlar a API.
- Confira os recursos para explicações técnicas e suporte. Faça perguntas, interaja e compartilhe feedback.