झलक दिखाने वाला विज़र्ड

झलक विज़र्ड को इस तरह से डिज़ाइन किया गया है कि आप अपनी साइट की झलक को तेज़ी से, आसानी से, और भरोसे के साथ इंटिग्रेट कर सकें. आप किताब व्यूअर एम्बेड कर सकते है, 'किताब की खोज' का लिंक दे सकते हैं या अपनी साइट में एक झलक "पॉपअप" विंडो भी जोड़ सकते हैं—आपको बस कोड जनरेट करना होगा और उसे अपने पेज पर चिपकाना होगा. आपके पास कुछ आसान JavaScript फ़ंक्शन का इस्तेमाल करके, इस कोड को पसंद के मुताबिक बनाने का भी विकल्प है.


झलक विज़र्ड एक आसान सुविधा लाइब्रेरी है. इसे हमने डाइनैमिक लिंक और एम्बेड किए गए व्यूअर एपीआई की मदद से बनाया है. अगर आप एक बेहतर डेवलपर हैं और आपको पसंद के मुताबिक बनाए गए इंटिग्रेशन की ज़रूरत है, तो सीधे तौर पर बुनियादी एपीआई का इस्तेमाल करें.

झलक कोड जनरेट करना

जनरेट की गई झलक के उदाहरण

नीचे दिए गए उदाहरण, प्रीव्यू विज़र्ड का इस्तेमाल करके जनरेट किए गए थे.

  • preview विज़र्ड-एम्बेड: पेज पर किताब व्यूअर को एम्बेड करता है.
  • झलक विज़र्ड-पॉपअप: एक बटन जोड़ता है, जिस पर क्लिक करके पेज पर फ़्लोटिंग झलक देखी जा सकती है.
  • previewwizard-linktogbs: एक बटन को शामिल करता है जो किताब सर्च साइट पर किताब की झलक से लिंक करता है.
  • preview विज़र्ड-customurl: इस फ़ंक्शन में किसी खास यूआरएल पर जाने वाला बटन दिखता है.

अपने कोड को पसंद के मुताबिक बनाएं

ऊपर बताए गए विज़र्ड का इस्तेमाल करने के अलावा, आप कुछ आसान JavaScript "helper" फ़ंक्शन को सीधे कॉल कर सकते हैं. ऐसा करने के लिए, आपको पहले Preview विज़र्ड लाइब्रेरी लोड करनी होगी. ऐसा करने का एक तरीका यह है कि आप अपने पेज के <head> सेक्शन में इस टैग को जोड़ें:

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

झलक लाइब्रेरी लोड करने के बाद, अपने दस्तावेज़ के <body> में मौजूद <script> टैग में जाकर, इनमें से किसी भी फ़ंक्शन को कॉल किया जा सकता है. उदाहरण के लिए, अगर आपको "Google का प्रीव्यू" बटन डालना है, तो ऐसा करने के लिए कोड को <script> एलिमेंट में, पेज में बटन के हिसाब से अपनी पसंद की जगह पर डालें.

GBS_setLanguage

GBS_setLanguage(languageCode)
    इस फ़ंक्शन को कॉल करने के बाद जोड़े गए किसी भी बटन या टेक्स्ट की भाषा बदल देता है. इसमें "Google झलक" बटन की भाषा, एम्बेड की गई झलक की इंटरफ़ेस भाषा वगैरह शामिल है.
    पैरामीटर:
      string languageCode - आपकी पसंद का आरएफ़सी 3066 भाषा कोड (अंग्रेज़ी के लिए डिफ़ॉल्ट रूप से 'en' होता है). फ़िलहाल, इन भाषाओं के कोड का इस्तेमाल किया जा सकता है: 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, ko, lv, lt, no, pl, pt-BR, pt-PT, pl, pt-BR, pt-PT,

GBS_setViewerOptions

GBS_setViewerOptions(optionObj)
    पैरामीटर:
      Object optionsObj - की-वैल्यू पेयर का सेट, जिसे एम्बेड किए गए व्यूअर एपीआई के DefaultViewer कंस्ट्रक्टर को पास किया गया है. आम तौर पर, इसका इस्तेमाल बेहतर कस्टमाइज़ेशन के लिए किया जाता है.

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    यह फ़ंक्शन, इसे Partner Program में पब्लिशर के इस्तेमाल के लिए बनाया गया है. इस फ़ंक्शन की मदद से, को-ब्रैंडेड सर्च साइट को बुक सर्च में झलक वाले लिंक डालते समय इस्तेमाल किया जा सकता है. बटन लगाने से पहले इस फ़ंक्शन को कॉल करने से, यह सुनिश्चित होता है कि उपयोगकर्ता को पुस्तक खोज पूर्वावलोकन के ऊपर भागीदार का लोगो दिखाई दे.
    पैरामीटर:
      string cobrandName - किसी भी Book Search यूआरएल में जोड़ा जाने वाला कोब्रैंड नाम. यह आम तौर पर मौजूदा को-ब्रैंडेड खोज की झलक दिखाने वाले यूआरएल में /p/ के बाद आता है.

      उदाहरण के लिए, इस वैल्यू को sup पर सेट करने पर, उपयोगकर्ता को डिफ़ॉल्ट लिंक के बजाय
      https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover
      जैसे लिंक पर भेजा जाएगा https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover

GBS_insertEmbeddedViewer

GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
    जहां भी इस फ़ंक्शन को कॉल किया जाता है वहां एम्बेड की गई किताब की झलक शामिल की जाती है. अगर झलक उपलब्ध नहीं है, तो कोई दर्शक नहीं दिखाया जाता.
    पैरामीटर:
      Number opt_width - दर्शक की मनचाही चौड़ाई, पिक्सल में.
      Number opt_height - दर्शक की लंबाई (पिक्सल में).

GBS_insertPreviewButtonPopup

GBS_insertPreviewButtonPopup(identifiers)
    अगर किताब की झलक उपलब्ध है, तो यह फ़ंक्शन "Google पर झलक देखें" बटन लिखता है. इस बटन को क्लिक करने से, आपके पेज के ठीक ऊपर "फ़्लोटिंग झलक विंडो" खुलती है. अगर कोई झलक उपलब्ध नहीं है, तो बटन नहीं बनाया जाएगा.

    ज़्यादा बेहतर डेवलपर को एम्बेड किए गए दर्शक एपीआई में दिलचस्पी हो सकती है, जिसका इस्तेमाल यह फ़ंक्शन अंदरूनी तौर पर करता है.

    पैरामीटर:
      string, Array identifier - झलक का यूआरएल या किताब का आइडेंटिफ़ायर, जैसे कि ISBN, OCLC या LCCN नंबर. डाइनैमिक लिंक के अनुरोध का फ़ॉर्मैट देखें. अगर आपको किताब के कई वैकल्पिक आइडेंटिफ़ायर के बारे में पता है, तो इन आइडेंटिफ़ायर के कलेक्शन को पास किया जा सकता है. अगर इनमें से किसी भी आइडेंटिफ़ायर की झलक उपलब्ध होगी, तो यह बटन दिखेगा. 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    अगर किताब की झलक उपलब्ध है, तो यह फ़ंक्शन एक "Google पर झलक देखें" बटन लिखता है जो सिर्फ़ किताब के झलक पेज से लिंक करता है. डिफ़ॉल्ट रूप से, यह Google Books पर किताब की झलक से लिंक होता है. हालांकि, यहां दिए गए काम भी किए जा सकते हैं:
    • लिंक किया गया है (जिसमें, एम्बेड किया गया व्यूअर शामिल होना चाहिए). alternativeUrl विकल्प को पास करके, ऐसा किया जा सकता है.
    • को किताब के झलक दिखाने वाले पेज के को-ब्रैंडेड वर्शन के लिंक का इस्तेमाल करना होगा. ऐसा तब ही होगा, जब इस फ़ंक्शन से पहले GBS_setCobrandName का इस्तेमाल किया जाए.
    अगर उपयोगकर्ता को झलक देखने की सुविधा उपलब्ध नहीं है, तो पेज पर कोई बटन नहीं खोला जाएगा.
    पैरामीटर:
      string, Array identifier - झलक का यूआरएल या किताब का आइडेंटिफ़ायर, जैसे कि ISBN, OCLC या LCCN नंबर. डाइनैमिक लिंक के अनुरोध का फ़ॉर्मैट देखें. अगर आपको किताब के कई वैकल्पिक आइडेंटिफ़ायर के बारे में पता है, तो इन आइडेंटिफ़ायर के कलेक्शन को पास किया जा सकता है. अगर इनमें से किसी भी आइडेंटिफ़ायर की झलक उपलब्ध होगी, तो यह बटन दिखेगा.
      Object opt_options - ज़रूरी नहीं - नाम और वैल्यू वाला मैप, जिसका इस्तेमाल बटन के काम करने के तरीके को कॉन्फ़िगर करने के लिए किया जाता है. फ़िलहाल, सिर्फ़ एक विकल्प मान्य है: alternativeUrl. उदाहरण के लिए, अगर आप अपनी साइट के कस्टम झलक पेज से Google के 'झलक देखें' बटन को लिंक करना चाहते हैं, तो नीचे दी गई जानकारी को दूसरे तर्क के तौर पर GBS_insertPreviewButtonLink को दें:
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }