À medida que o app Coisas legais para fazer evolui ao longo do tempo, fazemos melhorias contínuas na documentação para desenvolvedores. Consulte a lista a seguir para conferir as mudanças importantes recentes na documentação.
19 de setembro de 2024: as visitas autoguiadas e guiadas não são mais obrigatórias
Não é mais necessário definir categorias de produtos de passeios autoguiados e guiados para cada opção de produto. Agora usamos o título e a descrição do produto para entender o item e atribuir a categoria.
28 de julho de 2024: o Centro de TTD foi migrado para a Central de Ações
Fizemos a transição para um novo portal do parceiro: a Central de ações. Isso alinha a experiência do portal de parceiros do Coisas legais para fazer a outras verticais.
22 de julho de 2024: atualizações nos modelos de URL e descontinuação do modelo src
Adicionamos dois novos parâmetros de modelo de URL, funil e superfície, para ajudar os parceiros a entender melhor a origem da referência. Ao mesmo tempo, o parâmetro src foi descontinuado, e o suporte será removido com o tempo.
9 de fevereiro de 2024: descontinuação do campo address não estruturado em 1º de maio
A partir de 1º de maio de 2024, o Google não vai mais oferecer suporte ao campo address de linha única para locais. Atualize seu feed para usar os IDs de lugar, os formatos de ID do Perfil da Empresa ou do PlaceInfo recém-introduzidos.
Consulte o guia de migração para instruções detalhadas.
7 de fevereiro de 2024: melhor suporte a endereços estruturados e não estruturados
Atualizamos a especificação do feed, descontinuando o campo address atual,
usado para endereços não estruturados, e substituindo-o por um novo
place_info compatível com endereços estruturados e não estruturados.
O uso do novo campo vai resultar em correspondências mais precisas, já que outras informações, como número de telefone e site, também são consideradas.
Além disso, a especificação do feed agora também oferece suporte ao ID do Perfil da Empresa no Google como uma entrada de local para ajudar os parceiros a mapear as empresas dos fornecedores para a empresa correta no Google.
1º de fevereiro de 2024: adição de guias e listas de verificação para otimização de feeds
Atualizamos o site para desenvolvedores e adicionamos o guia de otimização de feed, que inclui listas de verificação de lançamento para ajudar você a aproveitar ao máximo a integração do feed.
24 de maio de 2023: adição de suporte a um novo erro: não foi possível encontrar uma correspondência para o local do operador
Adicionamos um novo erro: "Não foi possível encontrar uma correspondência para o local do operador". Esse erro vai permitir que os parceiros identifiquem locais de operadores que o Google não conseguiu resolver.
20 de maio de 2023: atualização da documentação com a mensagem de erro no Centro de TTD
Adicionamos uma nova página do site para desenvolvedores que lista todos os problemas de produtos informados no Centro de TTD e a descrição detalhada deles.
15 de fevereiro de 2023: seção "O que precisa de atenção"
Adicionamos a seção "Requer atenção" na Central de Coisas a fazer para ajudar você a identificar problemas no inventário de produtos.
6 de fevereiro de 2023: adição de um esquema JSON para ajudar na validação do produto
Agora disponibilizamos o esquema JSON da especificação do feed para download. O esquema pode ser usado para validar a integração do feed durante o desenvolvimento.
6 de fevereiro de 2023: foi adicionado um novo parâmetro de produto para sugerir a ordem das imagens
Lançamos um novo parâmetro booleano products/use_media_order que, quando
definido, indica ao Google que a ordem da imagem related_media deve ser usada para
determinar qual imagem é mostrada aos usuários.
17 de janeiro de 2023: lançamento do módulo de reserva de operadoras e novo modelo de src
Introduzimos operator/google_business_profile_name no feed para oferecer suporte ao módulo de reserva do operador. Em combinação com o novo parâmetro brand_name, os parceiros poderão especificar com precisão o Perfil da Empresa do Google para o qual o novo módulo aponta, além de configurar de forma independente a marca que aparece no app Coisas legais para fazer.
A documentação a seguir foi atualizada:
- O guia de informações gerais agora contém mais detalhes sobre várias plataformas de TTD.
- A documentação de campos obrigatórios foi atualizada.
- Na Referência do feed de produtos, a seção "operador" e "inventory_types" agora contém mais notas e exemplos de implementação.
17 de janeiro de 2023: o campo "operador/nome" foi substituído por "brand_name"
O campo operator/name foi descontinuado e substituído por um novo
em produtos com o nome brand_name. O campo name é mutuamente exclusivo
com o novo campo brand_name.
3 de novembro de 2022: novo erro quando o produto não tem um PDI qualificado
Para que um produto apareça no Google, ele precisa estar vinculado a um POI qualificado. Quando nenhum dos locais informados é qualificado, o produto não é mostrado. Para ter uma melhor visibilidade dos produtos com esse problema, o Google introduziu um novo erro: "Nenhum dos PDIs relacionados está qualificado para o programa". Para corrigir esse problema, adicione um PDI relacionado que se qualifique para esse programa. Use a Ferramenta de correspondência de locais para verificar a qualificação do PDI.
28 de outubro de 2022: novo artigo com a lista de problemas de produtos
Quais são todos os problemas que seu produto pode ter? Agora você pode conferir a lista de problemas de produtos para ver a lista completa.
13 de outubro de 2022: visão geral dos problemas com produtos
Atualizamos a Visão geral dos problemas do produto no Centro de problemas de TTD. Agora, a tabela de visão geral dos produtos tem três novas colunas que mostram os problemas por produto.
13 de setembro de 2022: diretrizes de imagens atualizadas
Atualizamos nossas diretrizes de imagem com outras recomendações.
5 de agosto de 2022: a especificação do feed foi ampliada para oferecer suporte a URLs de páginas de destino localizadas
Ampliamos a especificação do feed, e agora você pode usar localized_url e
localized_mobile_url, além de url e mobile_url, para especificar
páginas de destino diferentes para idiomas diferentes.
12 de julho de 2022: a documentação da ferramenta Encontrar locais correspondentes foi adicionada.
Adicionamos documentação sobre a ferramenta Encontrar locais correspondentes, um recurso da Central de Coisas legais para fazer.
1º de julho de 2022: foram adicionadas notas de implementação e amostras adicionais à documentação do feed de produtos.
Adicionamos notas de implementação e outros exemplos de JSON à documentação do feed de produtos.
13 de maio de 2022: atualizações nas diretrizes de páginas de destino e títulos
Adicionamos mais detalhes às diretrizes da página de destino descrevendo como as visualizações de lista e de produto devem ser usadas. A página de diretrizes de títulos foi renomeada para Diretrizes de título e descrição e agora inclui explicações e exemplos de como os títulos e as descrições devem ser usados.
15 de dezembro de 2021: categorias de produtos importantes e formatação de endereços de ponto de interesse
Atualizamos as Categorias de produtos para incluir uma lista de categorias que precisam ser incluídas sempre que possível. Também mudamos o guia Local e ponto de interesse com mais detalhes sobre como os endereços de string devem ser fornecidos.
12 de novembro de 2021: esclarecimentos sobre como usar o local relacionado
Adicionamos mais detalhes com exemplos em Local e ponto de interesse para esclarecer como o local relacionado deve ser usado.
19 de outubro de 2021: adição do guia de migração da v0 para a v1
Recentemente, adicionamos o guia de migração do Coisas legais para fazer para parceiros que migram da especificação legada.