Assistant de prévisualisation

L'assistant de prévisualisation est conçu pour vous permettre d'intégrer des aperçus de manière rapide, facile et fiable à votre site. Vous pouvez intégrer une visionneuse de livres, un lien vers Google Recherche de Livres ou même ajouter une fenêtre "pop-up" d'aperçu à votre site. Il vous suffit de générer le code et de le coller sur votre page. Vous pouvez également personnaliser ce code à l'aide de quelques fonctions JavaScript simples.


L'assistant de prévisualisation est une bibliothèque pratique simple que nous avons développée sur nos API Dynamic Links et Visionneuse intégrée. Si vous êtes un développeur avancé et que vous recherchez une intégration personnalisée, envisagez d'utiliser directement les API sous-jacentes.

Générer votre code d'aperçu

Exemples d'aperçus générés

Les exemples suivants ont été générés à l'aide de l'assistant de prévisualisation.

Personnaliser votre code

Outre l'utilisation de l'assistant ci-dessus, vous pouvez appeler directement quelques fonctions d'assistance JavaScript simples. Pour ce faire, vous devez d'abord charger la bibliothèque de l'assistant de prévisualisation. Pour ce faire, vous pouvez ajouter la balise suivante à la section <head> de votre page:

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

Après avoir chargé la bibliothèque d'aperçu, vous pouvez appeler l'une des fonctions suivantes à partir des balises <script> de l'élément <body> de votre document. Par exemple, si vous souhaitez insérer le bouton "Google Preview" (Aperçu Google), vous devez placer le code nécessaire dans un élément <script> à la position souhaitée du bouton sur la page.

GBS_setLanguage

GBS_setLanguage(languageCode)
    Modifie la langue des boutons ou du texte ajoutés après l'appel de cette fonction. y compris la langue du bouton "Aperçu Google", la langue de l'interface de l'aperçu intégré, etc.
    Paramètres :
      string languageCode : code de langue RFC 3066 souhaité (la valeur par défaut est "en" pour l'anglais). Les codes de langue actuellement acceptés sont les suivants : 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, ru, ru, sl

GBS_setViewerOptions

GBS_setViewerOptions(optionObj)
    Paramètres :
      Object optionsObj : ensemble de paires clé/valeur transmises au constructeur DefaultViewer de l'API Embedded Viewer. En règle générale, il est utilisé pour les personnalisations avancées.

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    Destinée aux éditeurs du Programme Partenaires, cette fonction permet de définir le site de recherche co-brandée à utiliser lorsque vous insérez des liens d'aperçu dans Google Recherche de Livres. En appelant cette fonction avant d'insérer un bouton, vous vous assurez que les utilisateurs voient bien le logo du partenaire au-dessus des aperçus de Google Recherche de Livres.
    Paramètres :
      string cobrandName : nom du co-branding à ajouter aux URL Recherche de Livres. Il s'affiche généralement après /p/ dans les URL d'aperçu de recherche co-brandée existantes.

      Par exemple, si vous définissez la valeur sur sup, l'utilisateur est redirigé vers des liens du type
      https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover
      au lieu des liens par défaut
      https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover

GBS_insertEmbeddedViewer

GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
    Insère un aperçu de livre intégré partout où cette fonction est appelée. Si l'aperçu n'est pas disponible, aucun lecteur ne s'affiche.
    Paramètres :
      Number opt_width : largeur souhaitée de la visionneuse, en pixels.
      Number opt_height : hauteur souhaitée de la visionneuse, en pixels.

GBS_insertPreviewButtonPopup

GBS_insertPreviewButtonPopup(identifiers)
    Si l'aperçu du livre est disponible, cette fonction affiche un bouton "Aperçu Google". Cliquez sur ce bouton pour ouvrir une "fenêtre d'aperçu flottante" juste au-dessus de votre page. Si aucun aperçu n'est disponible, le bouton n'est pas dessiné.

    Les développeurs plus expérimentés peuvent s'intéresser à l'API Embedded Viewer, que cette fonction utilise en interne.

    Paramètres :
      string, Array identifier : URL d'aperçu ou identifiant de livre (numéro ISBN, OCLC ou LCCN, par exemple). Consultez l'article Format des requêtes de liens dynamiques. Si vous disposez de plusieurs identifiants alternatifs pour le livre, vous pouvez transmettre un tableau de ces identifiants. Le bouton s'affichera si un aperçu est disponible pour l'un d'entre eux. 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    Si l'aperçu du livre est disponible, cette fonction affiche un bouton "Google Preview" (Aperçu Google) qui redirige simplement l'utilisateur vers une page d'aperçu du livre. Par défaut, ce lien renvoie vers l'aperçu sur Google Livres, mais vous pouvez également :
    • un lien vers une URL sur votre site (qui doit à son tour contenir un lecteur intégré). Pour ce faire, transmettez une option alternativeUrl facultative.
    • vers une version co-brandée de la page d'aperçu du livre, si la fonction GBS_setCobrandName est appelée avant cette fonction.
    Si aucun aperçu n'est disponible pour l'utilisateur, aucun bouton n'est affiché sur la page.
    Paramètres :
      string, Array identifier : URL d'aperçu ou identifiant de livre (numéro ISBN, OCLC ou LCCN, par exemple). Consultez l'article Format des requêtes de liens dynamiques. Si vous disposez de plusieurs identifiants alternatifs pour le livre, vous pouvez transmettre un tableau de ces identifiants. Le bouton s'affichera si un aperçu est disponible pour l'un d'entre eux.
      Object opt_options – facultatif : mappage nom/valeur utilisé pour configurer le comportement du bouton. Actuellement, une option est disponible: alternativeUrl. Par exemple, pour que le bouton "Aperçu Google" renvoie vers une page d'aperçu personnalisée sur votre site, il vous suffit de transmettre le code suivant en tant que deuxième argument à GBS_insertPreviewButtonLink:
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }