Anteprima guidata

La procedura guidata di anteprima è progettata per consentirti di integrare le anteprime nel tuo sito in modo rapido, semplice e affidabile. Puoi incorporare un visualizzatore di libri, inserire un link a Ricerca Libri o persino aggiungere una finestra popup di anteprima al tuo sito: devi solo generare il codice e incollarlo nella tua pagina. Puoi anche personalizzare questo codice utilizzando alcune semplici funzioni JavaScript.


La procedura guidata di anteprima è una semplice e pratica libreria che abbiamo costruito sfruttando le nostre API Dynamic Links e Embedded Viewer. Se sei uno sviluppatore avanzato e alla ricerca di un'integrazione personalizzata, valuta la possibilità di utilizzare direttamente le API sottostanti.

Genera il codice di anteprima

Esempi di anteprime generate

I seguenti esempi sono stati generati utilizzando la procedura guidata di anteprima.

Personalizza il codice

Oltre a utilizzare la procedura guidata descritta sopra, puoi chiamare direttamente alcune semplici funzioni "helper" di JavaScript. Per farlo, devi prima caricare la libreria della procedura guidata di anteprima. Un modo per farlo è aggiungere il seguente tag alla sezione <head> della pagina:

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

Dopo aver caricato la libreria di anteprima, puoi chiamare una delle seguenti funzioni dai tag <script> all'interno dell'elemento <body> del documento. Ad esempio, per inserire il pulsante "Anteprima Google", devi inserire il codice per farlo in un elemento <script> nella posizione desiderata del pulsante all'interno della pagina.

GBS_setLanguage

GBS_setLanguage(languageCode)
    Modifica la lingua di eventuali pulsanti o testo aggiunti dopo la chiamata di questa funzione. tra cui la lingua del pulsante "Anteprima Google", la lingua dell'interfaccia dell'anteprima incorporata e così via.
    Parametri:
      string languageCode . Il codice lingua RFC 3066 desiderato (il valore predefinito è "en" per l'inglese). I codici lingua attualmente supportati sono 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, ru, pt-BR, pt-sk, ros, tr, s

GBS_setViewerOptions

GBS_setViewerOptions(optionObj)
    Parametri:
      Object optionsObj : un insieme di coppie chiave-valore passate al costruttore DefaultViewer dell'API Embedded Viewer. In genere, viene utilizzato per personalizzazioni avanzate.

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    Questa funzione, destinata agli editori che aderiscono al Programma partner, consente di impostare l'utilizzo del sito Ricerca co-branded durante l'inserimento di eventuali link di anteprima nella Ricerca Libri. Chiamare questa funzione prima di inserire un pulsante garantisce che gli utenti vedano il logo del partner sopra le anteprime di Google Ricerca Libri.
    Parametri:
      string cobrandName . Il nome del co-branding da aggiungere a qualsiasi URL di Google Ricerca Libri. In genere si tratta di quello che segue /p/ negli URL di anteprima della ricerca co-branding esistenti.

      Ad esempio, se il valore viene impostato su sup, l'utente verrà indirizzato a link come
      https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover
      anziché il valore predefinito
      https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover

GBS_insertEmbeddedViewer

GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
    Inserisce un'anteprima del libro incorporata dove viene chiamata questa funzione. Se l'anteprima non è disponibile, non viene mostrato alcun visualizzatore.
    Parametri:
      Number opt_width : la larghezza desiderata del visualizzatore, in pixel.
      Number opt_height : l'altezza desiderata del visualizzatore, in pixel.

GBS_insertPreviewButtonPopup

GBS_insertPreviewButtonPopup(identifiers)
    Se l'anteprima del libro è disponibile, questa funzione crea un pulsante "Anteprima Google". Se fai clic su questo pulsante, si apre una "finestra di anteprima mobile" nella parte superiore della pagina. Se non è disponibile alcuna anteprima, il pulsante non è disegnato.

    Gli sviluppatori più sofisticati possono considerare l'API Embedded Viewer, che questa funzione utilizza internamente.

    Parametri:
      string, Array identifier . Un URL di anteprima o un identificatore del libro, ad esempio un numero ISBN, OCLC o LCCN. Consulta Formato della richiesta di Dynamic Links. Se conosci diversi identificatori alternativi per il libro, puoi trasmettere un array di questi identificatori e il pulsante verrà visualizzato se è disponibile un'anteprima per uno qualsiasi di questi identificatori. 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    Se l'anteprima del libro è disponibile, questa funzione crea un pulsante "Anteprima Google" che rimanda a una pagina di anteprima del libro. Per impostazione predefinita, questo link rimanda all'anteprima su Google Libri, ma puoi anche:
    • Rimandano a un URL sul tuo sito (che a sua volta dovrebbe contenere un visualizzatore incorporato). Puoi farlo passando un'opzione facoltativa alternativeUrl.
    • Creare un link a una versione in co-branding della pagina di anteprima del libro, se GBS_setCobrandName viene chiamato prima di questa funzione.
    Se non è disponibile nessuna anteprima per l'utente, nella pagina non viene visualizzato alcun pulsante.
    Parametri:
      string, Array identifier . Un URL di anteprima o un identificatore del libro, ad esempio un numero ISBN, OCLC o LCCN. Consulta Formato della richiesta di Dynamic Links. Se conosci diversi identificatori alternativi per il libro, puoi trasmettere un array di questi identificatori e il pulsante verrà visualizzato se è disponibile un'anteprima per uno qualsiasi di questi identificatori.
      Object opt_options (facoltativo): una mappa nome-valore utilizzata per configurare il comportamento del pulsante. Al momento è supportata un'opzione: alternativeUrl. Ad esempio, per fare in modo che il pulsante Anteprima Google rimandi a una pagina di anteprima personalizzata sul tuo sito, trasmetti semplicemente il seguente argomento come secondo argomento a GBS_insertPreviewButtonLink:
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }