Assistente de visualização

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


O Assistente de visualização é uma biblioteca de conveniência simples que criamos com base nas APIs Dynamic Links e Embedded Viewer. Se você é um desenvolvedor avançado que procura uma integração personalizada, use as APIs subjacentes 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.

Personalizar o código

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

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

Depois de carregar a biblioteca de visualização, é possível chamar qualquer uma das seguintes funções entre as tags <script> dentro 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 dos botões ou textos adicionados depois que essa função é chamada. Isso inclui o idioma do botão "Visualização do Google", a linguagem de interface da visualização incorporada e assim por diante.
    Parâmetros:
      string languageCode - O código de idioma desejado RFC 3066 (o padrão é "en" para inglês).

GBS_setViewerOptions

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

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    Destinada a editores por parte do Programa de Parceiros, esta função define o site da Pesquisa associada a marcas a 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.
    Parâmetros:
      string cobrandName - O nome da cobranded a ser adicionado a qualquer URL da Pesquisa de livros. Geralmente, é o que vem depois de /p/ nos URLs de visualização atuais da Pesquisa de marca parceira.

      Por exemplo, definir o valor como sup enviará 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 de livro incorporada sempre que essa função for chamada. Se a visualização não estiver disponível, nenhum visualizador será exibido.
    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 vai gravar um botão de "Visualização do Google". Clicar neste 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 um identificador de livro, como um ISBN, OCLC ou número da LCCN. Consulte Formato de solicitação do Dynamic Links. Caso você conheça vários identificadores alternativos do livro, será possível transmitir uma matriz deles, e o botão aparecerá caso uma visualização esteja disponível para qualquer um deles. 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    Se a visualização do livro estiver disponível, essa função gravará um botão "Visualização do Google" que será vinculado a uma página de visualização do livro. Por padrão, isso está vinculado à visualização no Google Livros. No entanto, você também pode fazer o seguinte:
    • link para um URL em seu site (que, por sua vez, deve conter um visualizador incorporado). Para fazer isso, transmita uma opção opcional do alternativeUrl.
    • Link para uma versão associada à marca 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á desenhado na página.
    Parâmetros:
      string, Array identifier - É um URL de visualização ou um identificador de livro, como um ISBN, OCLC ou número da LCCN. Consulte Formato de solicitação do Dynamic Links. Caso você conheça vários identificadores alternativos do livro, será possível transmitir uma matriz deles, e o botão aparecerá caso uma visualização esteja disponível para qualquer um deles.
      Object opt_options : opcional: um mapa de nome-valor usado para configurar o comportamento do botão. Atualmente, uma opção é compatível: alternativeUrl. Por exemplo, para ter o botão de visualização do Google vinculado a uma página de visualização personalizada no site, basta transmitir o seguinte como um segundo argumento para GBS_insertPreviewButtonLink:
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }