Assistant de prévisualisation

L'assistant de prévisualisation est conçu pour vous permettre d'intégrer rapidement, facilement et de manière fiable des aperçus à votre site. Vous pouvez intégrer une visionneuse de livres, créer un lien vers Google Recherche de Livres ou ajouter une fenêtre pop-up d'aperçu sur 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 développée en plus de nos API Dynamic Links et Lecteur intégré. 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

En plus d'utiliser l'assistant ci-dessus, vous pouvez appeler directement des fonctions d'aide 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>

Une fois la bibliothèque d'aperçu chargée, vous pouvez appeler l'une des fonctions suivantes à partir des balises <script> du fichier <body> de votre document. Par exemple, si vous souhaitez insérer le bouton "Google Preview", vous devez insérer le code dans un élément <script> à la position souhaitée pour le 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. Cela comprend la langue du bouton "Google Preview", la langue de l'interface de l'aperçu intégré, etc.
    Paramètres :
      string languageCode - Code de langue RFC 3066 souhaité (par défaut, "en" pour l'anglais). Les codes de langue suivants sont actuellement compatibles : 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-BR, ro, r, r, ru, ru, ru, r, r, r

GBS_setViewerOptions

GBS_setViewerOptions(optionObj)
GBS_setViewerOptions(optionObj)
    Paramètres:
      Object optionsObj - Ensemble de paires clé/valeur transmises au constructeur par défaut de l'API Viewer. Ce type est généralement utilisé pour les personnalisations avancées.

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    Ce document est destiné aux éditeurs qui participent au Programme Partenaire. Il définit le site de recherche co-brandée à utiliser lors de l'insertion de liens d'aperçu dans Book Search. Si vous appelez cette fonction avant d'insérer un bouton, les utilisateurs peuvent voir le logo du partenaire au-dessus des aperçus Google Recherche de Livres.
    Paramètres :
      string cobrandName - Nom de la comarque à ajouter aux URL de Recherche de Livres. Il s'agit généralement du texte qui suit /p/ dans les URL d'aperçu de la recherche co-brandée existantes.

      Par exemple, si vous définissez la valeur sur sup, l'utilisateur sera redirigé vers des liens tels que
      https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover
      plutôt que vers les liens par défaut.
      https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover

GBS_InsérerLecteur intégré

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 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 "Google Preview". Cliquez sur ce bouton pour ouvrir une "fenêtre d'aperçu flottante" en haut de la page. Si aucun aperçu n'est disponible, le bouton n'est pas affiché.

    Des développeurs plus sophistiqués pourraient être intéressés par l'API Visionneuse intégrée, que cette fonction utilise en interne.

    Paramètres :
      string, Array identifier : URL d'aperçu ou identifiant de livre, comme un numéro ISBN, OCLC ou LCCN. Consultez Format de demande Dynamic Links. Si vous connaissez plusieurs des autres identifiants du livre, vous pouvez transmettre plusieurs 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 renvoie un bouton "Google Preview" qui redirige simplement vers la page d'aperçu du livre. Par défaut, ce lien renvoie vers l'aperçu sur Google Livres. Toutefois, vous pouvez également :
    • à une URL de votre site (qui devrait à son tour contenir une visionneuse intégrée). Pour ce faire, transmettez une option alternativeUrl facultative.
    • Lien vers une version co-brandée de la page d'aperçu du livre, si GBS_setCobrandName est appelé avant cette fonction.
    Si aucun aperçu n'est disponible, aucun bouton n'apparaît sur la page.
    Paramètres :
      string, Array identifier : URL d'aperçu ou identifiant de livre, comme un numéro ISBN, OCLC ou LCCN. Consultez Format de demande Dynamic Links. Si vous connaissez plusieurs des autres identifiants du livre, vous pouvez transmettre plusieurs 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 acceptée: alternativeUrl. Par exemple, pour que le bouton "Aperçu" de Google redirige les utilisateurs vers une page d'aperçu personnalisée de votre site, il suffit de transmettre le code suivant en tant que deuxième argument à GBS_insertPreviewButtonLink :
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }