Esta página descreve como adicionar a funcionalidade de pesquisa a um site usando o widget de pesquisa.
Antes de começar
Antes de adicionar um widget de pesquisa à sua página da Web, configure o widget, começando com Configurar resultados para o widget de pesquisa. Não é possível ajustar o estilização do widget de pesquisa na sua página da Web.
Procedimentos
O procedimento para adicionar o widget de pesquisa à sua página da Web varia de acordo com o tipo de autorização escolhido:
Token de autorização: o widget usa um token JWT ou OAuth fornecido pelo sua base de código. É necessário ter um servidor próprio que possa ser usado para gerar uma com base no token correto anterior. O token de autenticação é usado para fazer uma chamada de API em nome do usuário ou da conta de serviço. Ao gerar o token de autenticação, use o escopo do OAuth
https://www.googleapis.com/auth/cloud-platform
:Para interações de servidor para servidor com contas de serviço: consulte Como usar o OAuth 2.0 para servidor para servidor Aplicativos na documentação de autorização.
Para aplicativos da Web JavaScript: consulte OAuth 2.0 para aplicativos da Web do lado do cliente na documentação de autorização.
Acesso público: o widget não restringe quem pode acessar os resultados de uma consulta de pesquisa.
Adicionar um widget que usa um token de autorização
No Console do Google Cloud, acesse a página Criador de agentes.
Clique no nome do app que você quer editar.
Clique em Integração.
Clique na guia Widget.
Selecione Com base no JWT ou OAuth como o tipo de autorização do widget.
Especifique o nome de domínio da página do widget:
Insira o nome de domínio da página em que o widget vai aparecer.
Por exemplo, se você for copiar o widget para as páginas
example.com/ai.html
ecymbal.example.com/search.html
, digiteexample.com
como o domínio. Se você quiser que o widget funcione apenas em uma página no subdomínio, digitecymbal.example.com
.Se você quiser testar o widget no seu host local, digite
localhost
.Clique em Adicionar.
Repita a etapa 6 para cada domínio em que o widget será exibido.
Clique em Salvar.
Copie o snippet de código fornecido na seção Copie o código a seguir para seu aplicativo da Web.
Na sua base de código, gere um token de autorização.
Para transmitir o token de autorização ao widget, use o segundo snippet de código, "
// Set authorization token
", fornecido na seção Copiar o código a seguir no seu aplicativo da Web e substitua o texto<JWT or OAuth token provided by you backend>
pelo token de autorização.Defina um token novo periodicamente repetindo a etapa anterior antes que o token atual expire.
Adicionar um widget com acesso público
No Console do Google Cloud, acesse a página Criador de agentes.
Clique no nome do app que você quer editar.
Clique em Integração.
Clique na guia Widget.
Selecione Acesso público como o tipo de autorização do widget.
Especifique o nome de domínio da página do widget:
Insira o nome de domínio da página em que o widget vai aparecer.
Por exemplo, se você for copiar o widget para as páginas
example.com/ai.html
ecymbal.example.com/search.html
, digiteexample.com
como o domínio. Se você só quer que o widget funcione em páginas No subdomínio, digitecymbal.example.com
.Se você quiser testar o widget no seu host local, digite
localhost
.Clique em Adicionar.
Repita a etapa 6 para cada domínio em que o widget será exibido.
Clique em Salvar.
Copie o snippet de código fornecido na seção Copie o código a seguir para seu aplicativo da Web e cole o snippet de código na página da Web.