झलक दिखाने वाले विज़ार्ड को इस तरह से डिज़ाइन किया गया है कि आप अपनी साइट पर झलक को जल्दी, आसानी से, और सही तरीके से इंटिग्रेट कर सकें. किसी किताब व्यूअर को जोड़ा जा सकता है और उसे किताब से लिंक किया जा सकता है. इसके अलावा, अपनी साइट में "पॉप-अप" विंडो की झलक भी जोड़ी जा सकती है. आपको बस कोड जनरेट करना होगा और उसे अपने पेज पर चिपकाना होगा. JavaScript के कुछ आसान फ़ंक्शन का इस्तेमाल करके, इस कोड को पसंद के मुताबिक भी बनाया जा सकता है.
झलक दिखाने वाला विज़ार्ड एक आसान सुविधा लाइब्रेरी है, जिसे हमने अपने डाइनैमिक लिंक और एम्बेड किए गए दर्शक एपीआई के ऊपर बनाया है. अगर आप एक ऐसे डेवलपर हैं जो पसंद के मुताबिक इंटिग्रेशन करना चाहते हैं, तो सीधे दिए गए एपीआई का इस्तेमाल करें.
अपना झलक कोड जनरेट करें
जनरेट की गई झलकों के उदाहरण
नीचे दिए गए उदाहरण, झलक दिखाने वाले विज़र्ड का इस्तेमाल करके जनरेट किए गए हैं.
- preview विज़ार्ड-एम्बेड करें: यह किसी पेज व्यूअर को पेज पर एम्बेड करता है.
- preview विज़ार्ड-पॉपअप: यह एक बटन जोड़ता है, जिसे पेज पर फ़्लोटिंग झलक खोलने के लिए क्लिक किया जा सकता है.
- preview विज़ार्ड-linktogbs: बुक बटन साइट पर झलक दिखाने वाले बटन को शामिल करता है.
- preview विज़ार्ड-कस्टम यूआरएल: यह एक बटन दिखाता है, जो किसी खास यूआरएल पर ले जाता है.
अपने कोड को पसंद के मुताबिक बनाएं
ऊपर दिए गए विज़ार्ड का इस्तेमाल करने के अलावा, आप कुछ आसान JavaScript "हेल्पर" फ़ंक्शन को सीधे कॉल कर सकते हैं. ऐसा करने के लिए, आपको पहले झलक दिखाने वाले विज़ार्ड की लाइब्रेरी लोड करनी चाहिए. ऐसा करने का एक तरीका यह है कि आप अपने पेज के <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' होता है). आप वह
GBS_setViewerOptions
GBS_setViewerOptions(optionObj)
-
पैरामीटर:
Object optionsObj
- एम्बेड किए गए व्यूअर एपीआई के DefaultViewer कंस्ट्रक्टर को भेजे गए की-वैल्यू पेयर का सेट. आम तौर पर, इसका इस्तेमाल बेहतर कस्टमाइज़ेशन के लिए किया जाता है.
GBS_setCobrandName
GBS_setCobrandName(cobrandName)
-
पार्टनर कार्यक्रम में पब्लिशर ने इस सुविधा का इस्तेमाल किया है. यह फ़ंक्शन, को-ब्रैंडेड खोज साइट को सेट करता है. इसका मकसद, 'किताब की खोज' में झलक दिखाने वाले लिंक को जोड़ते समय इस्तेमाल करना है. इस बटन को लगाने से पहले, इस फ़ंक्शन को कॉल करने से यह पक्का हो जाता है कि उपयोगकर्ताओं को बुक सर्च की झलक के ऊपर, पार्टनर का लोगो दिखेगा.
-
पैरामीटर:
string cobrandName
- किसी भी किताब के खोज वाले यूआरएल में जोड़ा जाने वाला को-ब्रैंड का नाम. यह आम तौर पर, मौजूदा को-ब्रैंडेड खोज की झलक वाले यूआरएल में /p/
के बाद आता है.
उदाहरण के लिए, sup
की वैल्यू सेट करने पर, उपयोगकर्ता डिफ़ॉल्ट लिंक के बजाय,
https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover
जैसे लिंक पर पहुंच जाएगा
https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover
GBS_insertembedViewer
GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
-
जहां भी इस फ़ंक्शन को कॉल किया जाता है, वहां एम्बेड की गई किताब की झलक दिखती है. अगर झलक उपलब्ध नहीं है, तो कोई दर्शक नहीं दिखाया जाता है.
-
पैरामीटर:
string identifier
- ISBN या OCLC या LCCN नंबर जैसा झलक दिखाने वाला यूआरएल या किताब की पहचान करने वाला नंबर. डाइनैमिक लिंक के लिए अनुरोध का फ़ॉर्मैट देखें.
Number opt_width
- दर्शक की पसंदीदा चौड़ाई, पिक्सल में.
Number opt_height
- दर्शक की पसंदीदा ऊंचाई, पिक्सल में.
GBS_insertpreviewButtonपॉपअप
GBS_insertPreviewButtonPopup(identifiers)
-
अगर किताब की झलक उपलब्ध है, तो यह फ़ंक्शन "Google झलक" बटन लिखता है. इस बटन पर क्लिक करने से, आपके पेज के सबसे ऊपर "फ़्लोटिंग प्रीव्यू विंडो" खुलती है. अगर कोई झलक उपलब्ध नहीं है, तो बटन नहीं बनाया गया है.
ज़्यादा बेहतर डेवलपर की दिलचस्पी एम्बेड किए गए दर्शक एपीआई में हो सकती है. यह फ़ंक्शन अंदरूनी तौर पर इस्तेमाल करता है.
-
पैरामीटर:
string, Array identifier
- ISBN या OCLC या LCCN नंबर जैसा झलक दिखाने वाला यूआरएल या किताब की पहचान करने वाला नंबर. डाइनैमिक लिंक के लिए अनुरोध का फ़ॉर्मैट देखें. अगर आपको किताब के कई वैकल्पिक पहचानकर्ताओं के बारे में पता है, तो आप इनमें से किसी पहचानकर्ता की श्रेणी पास कर सकते हैं. साथ ही, उनमें से किसी भी एक की झलक उपलब्ध होने पर बटन दिखेगा.
GBS_insertpreviewButtonLink
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' }