API exclusiva para parceiros do Google Documents para resultados de pesquisa completos na Web
O Google atualizou sua documentação pública para desenvolvedores da API do serviço de pesquisa na Web, um serviço que permite aos parceiros recuperar e exibir resultados da Pesquisa Google em seus sites e aplicativos. O Google atualizou a página de visão geral principal e quatro páginas relacionadas em 9 de setembro, e cada solicitação precisa de um ID de cliente vinculado a um contrato de parceiro, além de um projeto do Google Cloud e uma chave de API. A API JSON de pesquisa personalizada, que termina em janeiro de 2027, é o pano de fundo. Em janeiro, o Google disse a qualquer pessoa que precisasse de resultados completos para a web que entrasse em contato sobre uma solução separada para toda a web.
O que a API oferece
O Google documenta um método principal, a Pesquisa, que a página de referência descreve como uma “pesquisa completa na web”. Ele retorna resultados no formato JSON por meio de REST ou gRPC. Cada solicitação deve incluir um ID de cliente parceiro, o endereço IP do usuário e a consulta de pesquisa. Conforme mencionado no guia de invocação, incluir o endereço IP ajuda no roteamento regional e também evita o uso indevido. Você pode receber até 20 resultados por solicitação, 10 por padrão, com opção de obter mais páginas usando um token. Os usuários podem filtrar os resultados por idioma, país, intervalo de datas, ativar o SafeSearch ou classificar por data. A resposta fornece campos como título, URL, snippet, tipo MIME, formato de arquivo, uma contagem total estimada de resultados e uma consulta corrigida, se o Google recomendar uma.
O acesso é restrito
As páginas referem-se aos usuários como “parceiros programáticos”. Na página de introdução é explicado que as solicitações estão vinculadas ao contrato de parceria por meio do ID do cliente. Esse ID segue um formato padrão, incluindo detalhes como parceiro, nome, produto e conjunto de recursos.
Isso diferencia o serviço de uma API que um desenvolvedor pode ativar em um projeto do Google Cloud e começar a usar imediatamente. No entanto, as páginas não fornecem detalhes sobre como uma empresa pode se tornar parceira, quanto custa o serviço ou quais limites de consulta podem existir.
Como isso se adapta à transição da API de pesquisa
Em janeiro, o Google anunciou que o Elemento de Pesquisa Programável, seu widget de pesquisa de site, agora se concentrará em pesquisas em 50 domínios ou menos. Eles apontaram necessidades empresariais, como pesquisa conversacional e base para o Vertex AI Search. Para parceiros que desejam ir além de um conjunto de sites, o Google disse que tem uma solução completa de pesquisa na web para “aqueles que necessitam de todo o nosso índice”. Os parceiros interessados podem se inscrever preenchendo um formulário. O Google ainda não compartilhou recursos ou preços detalhados. Os usuários do Search Element que pesquisam em mais de 50 domínios ou em toda a web precisarão mudar para uma solução diferente até 1º de janeiro de 2027. O mesmo prazo se aplica aos usuários da API JSON de pesquisa personalizada, e a página de visão geral da API do Google agora diz que a API está fechada para novos clientes e será descontinuada nessa data.
A API do serviço de pesquisa na web corresponde ao caso de uso da web completa de janeiro em dois pontos. Realiza uma pesquisa completa na web e é limitada a parceiros. Desde 11 de setembro, nem a postagem de janeiro nem as páginas atualizadas mencionam uma à outra.
Por que isso é importante
O anúncio de janeiro do Google compartilhou um formulário de interesse para desenvolvedores que precisam de resultados completos na web, mas não incluiu muitos detalhes sobre essa oferta. A documentação atualizada do serviço de pesquisa na web agora fornece uma explicação muito mais clara de como funciona a API exclusiva para parceiros do Google e o que uma solicitação deve conter para ser aceita. As pessoas que usam a API JSON de pesquisa personalizada para projetos full-web ainda não têm um caminho de migração completo. O Google documentou uma API web completa para parceiros, mas não disse se os usuários atuais podem mudar ou quais requisitos as empresas precisam atender para se tornarem parceiras.
Olhando para o futuro
O prazo final do Google, 1º de janeiro de 2027, permanece. Enquanto isso, fique atento às atualizações sobre elegibilidade de parceiros, custos, limites de consulta e se o Google nomeia a API do serviço de pesquisa na web como o caminho para usuários de pesquisa personalizada em toda a web.
A postagem de janeiro do Google ainda direciona os usuários da Pesquisa Personalizada que precisam de resultados completos da web para seu formulário de interesse. A documentação do Serviço de Pesquisa na Web não explica como uma empresa obtém o contrato de parceria necessário.
Logotipo do Google – Fonte: Google. Imagem em destaque: Accogliente Design/Shutterstock
