Assistente de visualização

O assistente de visualização foi criado para permitir que você integre as visualizações ao seu site de maneira rápida, fácil e confiável. Você pode incorporar um visualizador de livros, criar um link para a Pesquisa de Livros do Google ou até mesmo adicionar uma janela pop-up de visualização ao seu site. Tudo o que você precisa fazer é gerar o código e colá-lo na sua página. Também é possível personalizar esse código usando algumas funções simples de JavaScript.


O assistente de visualização é uma biblioteca de conveniência simples criada com base nas APIs Dynamic Links e Embedded Viewer. Se você for um desenvolvedor avançado em busca de integração personalizada, considere usar as APIs diretamente.

Gerar o código de visualização

Exemplos de visualizações geradas

Os exemplos a seguir foram gerados usando o assistente de visualização.

Personalize seu código

Além de usar o assistente acima, você pode chamar diretamente algumas funções "auxiliares" JavaScript simples. Para fazer isso, carregue primeiro a biblioteca do assistente de visualização. Uma maneira de fazer isso é adicionar a seguinte tag à seção <head> da sua página:

<script type="text/javascript" src="https://books.google.com/books/previewlib.js"></script>

Depois de carregar a biblioteca de visualização, você pode chamar qualquer uma das seguintes funções nas tags <script> do <body> do documento. Por exemplo, se você quiser inserir o botão "Visualização do Google", coloque o código para fazer isso em um elemento <script> na posição desejada do botão na página.

GBS_setLanguage

GBS_setLanguage(languageCode)
    Muda o idioma de todos os botões ou textos adicionados depois que essa função é chamada. Isso inclui o idioma do botão "Visualização do Google", o idioma da interface da visualização incorporada e assim por diante.
    Parâmetros:
      string languageCode : o código de idioma RFC 3066 desejado (o padrão é "en" para inglês). Os códigos de idioma com suporte no momento incluem hy, bg, ca, zh-CN, zh-TW, hr, cs, da, nl, en, fil, fi, fr, de, el, hi, hu, is, id, in, it, ja, ko, lv, lt, no, pl, pt-BR, pt-PT, ro, s.v.

GBS_setViewerOptions

GBS_setViewerOptions(optionObj)
    Parâmetros:
      Object optionsObj : um conjunto de pares de chave-valor transmitidos ao construtor DefaultViewer da API Embedded Viewer. Normalmente, isso é usado para personalizações avançadas.

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    Destinado ao uso pelos editores no Programa para Parceiros, essa função define o site da Pesquisa associada a marcas para ser usado ao inserir links de visualização na Pesquisa de Livros. Chamar essa função antes de inserir um botão garante que os usuários vejam o logotipo do parceiro acima das visualizações da Pesquisa de Livros do Google.
    Parâmetros:
      string cobrandName : o nome de co-branding a ser adicionado a todos os URLs da Pesquisa de Livros do Google. Normalmente vem depois de /p/ nos URLs de visualização da Pesquisa associada a marcas.

      Por exemplo, definir o valor como sup encaminhará o usuário para links como
      https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover
      em vez do padrão
      https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover

GBS_insertEmbeddedViewer

GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
    Insere uma visualização do livro incorporada onde quer que essa função seja chamada. Se a visualização não estiver disponível, nenhum espectador vai aparecer.
    Parâmetros:
      Number opt_width : a largura desejada do visualizador, em pixels.
      Number opt_height : a altura desejada do visualizador, em pixels.

GBS_insertPreviewButtonPopup

GBS_insertPreviewButtonPopup(identifiers)
    Se a visualização do livro estiver disponível, essa função gravará um botão "Visualização do Google". Clicar nesse botão abre uma "janela de visualização flutuante" na parte superior da página. Se nenhuma visualização estiver disponível, o botão não será desenhado.

    Desenvolvedores mais sofisticados podem estar interessados na API Embedded Viewer, que essa função usa internamente.

    Parâmetros:
      string, Array identifier : um URL de visualização ou identificador do livro, como um número ISBN, OCLC ou LCCN. Consulte o formato de solicitação do Dynamic Links. Se você souber de vários identificadores alternativos para o livro, será possível transmitir uma matriz deles. O botão será exibido se uma visualização estiver disponível para qualquer um deles. 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    Se a visualização do livro estiver disponível, essa função criará um botão "Visualização do Google", que será vinculado a uma página de visualização do livro. Por padrão, esse link é vinculado à visualização no Google Livros, mas também é possível:
    • link para um URL no seu site (que deve conter um visualizador incorporado). Para fazer isso, transmita uma opção alternativeUrl opcional.
    • link para uma versão associada a marcas da página de visualização do livro, se GBS_setCobrandName for chamado antes dessa função.
    Se nenhuma visualização estiver disponível para o usuário, nenhum botão será exibido na página.
    Parâmetros:
      string, Array identifier : um URL de visualização ou identificador do livro, como um número ISBN, OCLC ou LCCN. Consulte o formato de solicitação do Dynamic Links. Se você souber de vários identificadores alternativos para o livro, será possível transmitir uma matriz deles. O botão será exibido se uma visualização estiver disponível para qualquer um deles.
      Object opt_options opcional: um mapa de nome-valor usado para configurar o comportamento do botão. No momento, uma opção é compatível: alternativeUrl. Por exemplo, para que o botão "Visualização do Google" direcione a uma página de visualização personalizada no seu site, basta transmitir o seguinte como um segundo argumento para GBS_insertPreviewButtonLink:
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }