Documentação

Busca de Metadados do Google Books

Busque automaticamente ou manualmente imagens de capa, datas de publicação e outros metadados da API do Google Books.

O Royalties HQ pode buscar automaticamente imagens de capa e metadados da API do Google Books para seus produtos.

Quais dados são buscados?

Quando habilitado, o Royalties HQ tentará buscar os seguintes dados da API do Google Books:

  • Imagens de capa (salvas no título)
  • Datas de publicação
  • Nomes de editora/selo
  • Códigos de idioma
  • Contagens de páginas

Notas importantes:

  • Apenas produtos com ISBNs podem buscar metadados do Google Books
  • Os dados disponíveis variam por livro – nem todos os livros têm dados completos

Apenas campos vazios serão atualizados – dados existentes não serão sobrescritos.

Busca automática

Você pode habilitar a busca automática de metadados em Configurações (menu principal > Configurações > Metadados do Google Books).

Quando habilitado, imagens de capa e metadados serão automaticamente buscados da API do Google Books quando um ISBN for adicionado a um produto (via interface ou importação CSV). Apenas campos vazios serão atualizados – dados existentes não serão sobrescritos.

Busca manual (títulos individuais)

Você pode buscar metadados manualmente para títulos individuais:

  1. Vá para a aba Detalhes do Título do título
  2. Procure o botão “Buscar metadados do Google Books” na seção de imagem de capa (este botão só aparece quando pelo menos um formato tem um ISBN, e o título ainda não tem uma imagem de capa)
  3. Clique no botão para enfileirar a busca de metadados
  4. A página será atualizada automaticamente quando novos dados estiverem disponíveis

A busca é executada em segundo plano. Quando concluída, a página será atualizada automaticamente para mostrar quaisquer imagens de capa e metadados recém-buscados.

Nota: O botão de busca só é visível quando o título tem pelo menos um formato com um ISBN e o título ainda não tem uma imagem de capa.

Busca em lote (todos os títulos)

Você pode buscar metadados manualmente para todos os seus produtos com ISBNs de uma vez:

  1. Vá para Configurações (menu principal > Configurações)
  2. Role até a seção Metadados do Google Books
  3. Clique em “Buscar Metadados para Todos os Títulos”
  4. Todos os produtos com ISBNs serão processados em segundo plano
  5. Verifique as páginas de títulos para ver imagens de capa e metadados atualizados

Isso é útil quando você acabou de importar muitos produtos novos com ISBNs.

Solução de problemas

Nota: as imagens de capa fornecidas pelo Google geralmente são pequenas. Você pode fazer upload de uma nova imagem se preferir.

Nenhuma imagem de capa foi buscada:

  • O livro pode não estar no banco de dados do Google Books
  • O Google Books pode não ter uma imagem de capa para este ISBN
  • O ISBN pode estar incorreto

Alguns campos de metadados não foram atualizados:

  • O campo pode já ter dados (dados existentes nunca são sobrescritos)
  • O Google Books pode não ter esses dados específicos para este livro

O botão de busca permanece no estado “Buscando…”:

  • Atualize a página – a busca pode ter sido concluída
  • Verifique sua conexão com a internet
  • Verifique os logs da aplicação para quaisquer erros