Asistente de vista previa

El asistente de vista previa está diseñado para permitirte integrar de manera rápida, fácil y confiable vistas previas con tu sitio. Puedes incorporar un visualizador de libros, vincular la Búsqueda de libros o incluso agregar una ventana emergente de vista previa a tu sitio. Todo lo que necesitas hacer es generar el código y pegarlo en tu página. También puedes personalizar este código mediante algunas funciones simples de JavaScript.


El asistente de vista previa es una biblioteca de conveniencia simple que se basa en nuestras API de Dynamic Links y Visualizador incorporado. Si eres un desarrollador avanzado que busca una integración personalizada, considera usar las API subyacentes directamente.

Genera tu código de vista previa

Ejemplos de vistas previas generadas

Los siguientes ejemplos se generaron con el asistente de vista previa.

Personaliza tu código

Además de usar el asistente anterior, puedes llamar a algunas funciones simples de "ayuda" de JavaScript directamente. Para ello, primero debes cargar la biblioteca del asistente de vista previa. Una forma de hacerlo es agregar la siguiente etiqueta a la sección <head> de tu página:

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

Después de cargar la biblioteca de vista previa, puedes llamar a cualquiera de las siguientes funciones desde las etiquetas <script> dentro de <body> del documento. Por ejemplo, si deseas insertar el botón "Vista previa de Google", debes colocar el código en un elemento <script> en la posición deseada del botón dentro de la página.

GBS_setLanguage

GBS_setLanguage(languageCode)
    Cambia el idioma de cualquier botón o texto que se agregue después de llamar a esta función. Esto incluye el idioma del botón "Vista previa de Google", el idioma de la interfaz de la vista previa incorporada, etc.
    Parámetros:
      string languageCode : Es el código de idioma RFC 3066 deseado (el valor predeterminado es "en" en inglés). Los códigos de idioma admitidos actualmente incluyen 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, r, r, r, r, r, r, r, r, r, r, s, r, le,

Opciones de GBS_setViewer

GBS_setViewerOptions(optionObj)
    Parámetros:
      Object optionsObj : Un conjunto de pares clave-valor que se pasan al constructor de DefaultViewer de la API de Embed Viewer. Por lo general, se usa para personalizaciones avanzadas.

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    Esta función, que está diseñada para que la usen los publicadores del Programa de socios, establece el sitio de búsqueda de marca compartida para usar cuando se insertan vínculos de vista previa en la Búsqueda de libros. Llamar a esta función antes de insertar un botón garantiza que los usuarios vean el logotipo del socio sobre las vistas previas de la Búsqueda de libros.
    Parámetros:
      string cobrandName : Es el nombre de la marca registrada que se agregará a las URL de la Búsqueda de libros. Por lo general, es lo que sigue a /p/ en las URL de vista previa de la Búsqueda de marca compartida existentes.

      Por ejemplo, configurar el valor en sup enviará al usuario a vínculos como
      https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover
      en lugar de al predeterminado
      https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover

GBS_insertEmbeddedViewer

GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
    Inserta una vista previa del libro incorporada cuando se llama a esta función. Si la vista previa no está disponible, no se muestra ningún visualizador.
    Parámetros:
      Number opt_width : Es el ancho deseado del visor, en píxeles.
      Number opt_height : Es la altura deseada del usuario en píxeles.

GBS_insertPreviewButtonPopup

GBS_insertPreviewButtonPopup(identifiers)
    Si la vista previa del libro está disponible, esta función escribe el botón "Vista previa de Google". Al hacer clic en este botón, se abre una "ventana de vista previa flotante" en la parte superior de la página. Si no hay ninguna vista previa disponible, no se dibujará el botón.

    Los desarrolladores más sofisticados pueden estar interesados en la API de Embed Viewer, que esta función utiliza internamente.

    Parámetros:
      string, Array identifier : Es una URL de vista previa o un identificador de libro, como un número ISBN, OCLC o LCCN. Consulta el formato de solicitud de Dynamic Links. Si conoces varios identificadores alternativos para el libro, puedes pasar un conjunto de estos identificadores y el botón aparecerá si hay una vista previa disponible para cualquiera de ellos. 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    Si la vista previa del libro está disponible, esta función escribe un botón que dice "Vista previa de Google" que simplemente vincula a una página de vista previa del libro. De forma predeterminada, se vincula a la vista previa en Google Libros, pero también puedes hacer lo siguiente:
    • a una URL de tu sitio (que, a su vez, debe incluir un visor incorporado). Para ello, pasa una opción alternativeUrl opcional.
    • Vincular a una versión de marca compartida de la página de vista previa del libro si se llama a GBS_setCobrandName antes de esta función.
    Si no hay ninguna vista previa disponible para el usuario, no se dibujará ningún botón en la página.
    Parámetros:
      string, Array identifier : Es una URL de vista previa o un identificador de libro, como un número ISBN, OCLC o LCCN. Consulta el formato de solicitud de Dynamic Links. Si conoces varios identificadores alternativos para el libro, puedes pasar un conjunto de estos identificadores y el botón aparecerá si hay una vista previa disponible para cualquiera de ellos.
      Object opt_options (opcional): Es un mapa de nombre y valor que se usa para configurar el comportamiento del botón. Por el momento, se admite una opción: alternativeUrl. Por ejemplo, para que el botón Vista previa de Google se vincule a una página de vista previa personalizada en tu sitio, simplemente pasa lo siguiente como segundo argumento a GBS_insertPreviewButtonLink:
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }