Conecta-seEntrar na plataforma

Google Search

Pesquisar informações públicas na web com o Google Search.

Integrações e ferramentasPesquisaConexão: Credencial protegida

O que faz

Integre o Google Search ao fluxo. Permite fazer buscas na web.

Quando usar: Use quando o seu fluxo precisar pesquisar informações públicas na web com o Google Search.

Exemplo de situação: Buscar informação atual antes de formular a resposta.

Antes de começar

Conexão necessária: Credencial protegida.

Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.

Passo a passo

  1. Adicione Google Search ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Operações

OperaçãoO que faz
Buscar páginas na webBusca páginas na web com o bloco Google Search.
Buscar imagensBusca imagens com o bloco Google Search.

Campos

Mostrar campos de

  • Busca

    Escolhe qual ação este bloco executará.

    Opções:
    Buscar páginas na web · Buscar imagens
    Padrão:
    Buscar páginas na web

  • Consulta de busca

    Obrigatório

    Informa a consulta usada para localizar ou transformar dados.

    Exemplo:
    SELECT * FROM clientes WHERE status = 'ativo'

  • ID do mecanismo de busca personalizado

    Obrigatório

    Informe o ID do seu mecanismo de busca personalizado.

    Exemplo:
    id-do-recurso

  • Chave de API

    ObrigatórioDado protegido

    Informe a sua chave de API do Google.

    Padrão:
    Segredo protegido

  • Número de resultados

    Em campos adicionais

    Quantos resultados do Google trazer em cada busca, de 1 a 10 (ex.: 5).

    Exemplo:
    10 (1-10)

  • Posição inicial

    Em campos adicionais

    Posição do primeiro resultado, para paginar a busca: 1 traz a primeira página e 11 a segunda, com 10 por página; essa posição somada ao número de resultados não pode passar de 100.

    Exemplo:
    1 (para paginação; start + num <= 100)

  • Restrição de data

    Em campos adicionais

    Define a data, o horário ou a programação usada pela operação.

    Exemplo:
    2026-09-15

  • Tipo de arquivo

    Em campos adicionais

    Informa ou seleciona o arquivo usado nesta operação.

    Exemplo:
    pdf, doc

  • SafeSearch

    Em campos adicionais

    Escolhe uma das opções aceitas por este campo.

    Opções:
    Desativado · Ativo
    Exemplo:
    Desativado

  • Busca em site

    Em campos adicionais

    Domínio a incluir ou excluir (ex.: wikipedia.org).

    Exemplo:
    wikipedia.org

  • Filtro de site

    Em campos adicionais

    Define a consulta ou o filtro aplicado aos dados.

    Quando aparece:
    Quando o campo “Busca em site” for diferente de “”
    Opções:
    Incluir · Excluir
    Exemplo:
    Incluir

  • Restrição de idioma

    Em campos adicionais

    Limita a busca a páginas escritas em um idioma, no formato lang_ seguido do código do idioma (ex.: lang_pt para português).

    Exemplo:
    lang_en

  • País (geolocalização)

    Em campos adicionais

    Código do país com duas letras (ex.: us).

    Exemplo:
    us

  • Ordenação

    Em campos adicionais

    Muda a ordem dos resultados, que por padrão é a relevância; use date para ver primeiro as páginas mais recentes.

    Exemplo:
    date

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <googlesearch.items>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<googlesearch.items>jsonItens do resultado da busca.
<googlesearch.searchInformation>jsonMetadados da busca.
<googlesearch.nextPageStartIndex>numberÍndice inicial da próxima página de resultados.

Exemplo de uso

Objetivo: Buscar informação atual antes de formular a resposta.

InícioGoogle Searchpróxima etapa
Busca
Buscar páginas na web
Consulta de busca
SELECT * FROM clientes WHERE status = 'ativo'
ID do mecanismo de busca personalizado
id-do-recurso

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <googlesearch.items>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece
Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Credencial ausente ou recusada
Escolha uma conexão válida do workspace. Se a senha ou a chave mudou no serviço, atualize a conexão cadastrada em vez de colar o segredo no bloco.
O serviço recusou a chamada ou devolveu erro
Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

Blocos relacionados