Asistente de vista previa

El asistente de vista previa está diseñado para permitirte integrar vistas previas de forma rápida, fácil y confiable con tu sitio. Puedes incorporar un lector de libros, vincular a 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 con algunas funciones simples de JavaScript.


El asistente de vista previa es una biblioteca de conveniencia sencilla que creamos sobre la base de nuestras APIs de Dynamic Links y Embedded Viewer. Si eres un desarrollador avanzado que busca una integración personalizada, considera usar directamente las APIs subyacentes.

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 utilizar el asistente anterior, puedes llamar directamente a algunas funciones simples de ayuda de JavaScript. 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>

Una vez cargada la biblioteca de vista previa, puedes llamar a cualquiera de las siguientes funciones desde las etiquetas <script> dentro del <body> de tu documento. Por ejemplo, si deseas insertar el botón "Vista previa de Google", deberás colocar el código correspondiente 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 que se llame 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” para inglés). Los códigos de idioma admitidos actualmente son 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.

GBS_setViewerOptions

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

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    Esta función, que está diseñada para que lo usen los editores del Programa de socios, establece el sitio de Búsqueda de marca compartida que se usará cuando se inserten 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 encima de las vistas previas de Búsqueda de libros.
    Parámetros:
      string cobrandName : Es el nombre de marca compartida que se agregará a todas las URLs de Búsqueda de libros. Por lo general, es lo que aparece después de /p/ en las URLs de vista previa de la Búsqueda de marcas asociadas.

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

GBS_insertEmbeddedViewer

GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
    Inserta una vista previa de un libro incorporado en cualquier lugar que se llame 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 visor en píxeles.

GBS_insertPreviewButtonPopup

GBS_insertPreviewButtonPopup(identifiers)
    Si la vista previa del libro está disponible, esta función escribe un 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 tu página. Si no hay una vista previa disponible, el botón no se dibuja.

    Es posible que a los desarrolladores más sofisticados les interese la API de Embedded Viewer, que esta función usa internamente.

    Parámetros:
      string, Array identifier : Es una URL de vista previa o un identificador de libro, como un ISBN, OCLC o LCCN. Consulta Formato de solicitud de Dynamic Links. Si conoces varios identificadores alternativos para el libro, puedes pasar un array 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 incluye un botón "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 de Google Libros, pero también puedes hacer lo siguiente:
    • un vínculo a una URL de tu sitio (que, a su vez, debe contener un visor incorporado). Para ello, pasa una opción alternativeUrl opcional.
    • vínculo 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 una 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 ISBN, OCLC o LCCN. Consulta Formato de solicitud de Dynamic Links. Si conoces varios identificadores alternativos para el libro, puedes pasar un array de estos identificadores, y el botón aparecerá si hay una vista previa disponible para cualquiera de ellos.
      Object opt_options (opcional): 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 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' }