Imagens do Google

Cadastrar um produto sem foto derruba a nota de qualidade do catálogo e as vendas. Este recurso ajuda a achar fotos: você pesquisa no Google Imagens a partir do nome e da marca do produto, escolhe os resultados bons e a plataforma baixa essas imagens e as anexa à galeria do produto. A pesquisa usa o Google Programmable Search (Custom Search) com a chave de API e o mecanismo de busca da própria loja: a Venddor não fornece a chave, e as cotas e o custo do Google são da loja.

Como funciona

1. Configurar uma vez

   PUT /settings com a chave de API do Google e o ID do mecanismo de busca (Search Engine ID).

2. Pesquisar

   POST /search com o product_id (a plataforma monta a consulta a partir do nome e da marca) ou com um texto livre.

3. Escolher e importar

   POST /download com o product_id e as URLs escolhidas. A plataforma baixa, valida o tipo e o tamanho e anexa cada imagem à galeria.

Conceitos-chave

Consulta automática

Quando você manda product_id sem query, a consulta vem do modelo default_query_template da configuração. O padrão é {name} {brand}.

Filtros da pesquisa

Resultados com largura menor que min_image_width (padrão 600 px) são descartados. O número de resultados é limitado por max_results (padrão 10, máximo 30), e a busca de segurança (safe_search) segue a configuração.

Limites da importação

Até 30 URLs por chamada, no máximo 10 MiB por imagem, tipos JPEG, PNG, WebP ou GIF, e 90 segundos no total. URLs que falham não impedem as outras.

Chave de API

A chave é guardada criptografada e nunca volta em texto puro nas respostas: só uma versão mascarada (AIza••••••••xyz1).

Endpoints

Erros comuns

• Pesquisar antes de configurar: 412 not_configured.
• Esperar que o resultado já esteja no produto: search só lista; é o download que anexa.
• Confundir 200 com sucesso no download: confira imported e failed; URLs individuais podem falhar dentro de um 200.
• Enviar a chave mascarada de volta e achar que a trocou: a chave mascarada é ignorada e a antiga é mantida.
• Pesquisar sem query e sem product_id: 400 invalid_input.
• Passar de 30 URLs no download: as que passam de 30 são ignoradas, sem aviso.
• Importar fotos sem checar os direitos de uso.

Próximos passos