'एम्बेड किए गए दर्शक एपीआई' के दस्तावेज़ में मौजूद सभी उदाहरणों के बारे में यहां बताया गया है. इसके अलावा, बेहतर सिद्धांत दिखाने के लिए कई और डेमो शामिल किए गए हैं.
डेवलपर की गाइड के उदाहरण
ये बुनियादी उदाहरण, डेवलपर की गाइड में दिखते हैं. साथ ही, इनमें एम्बेड किए गए व्यूअर एपीआई के सबसे सामान्य इस्तेमाल के बारे में जानकारी दी गई है.
- किताब को आसान बनाना
एम्बेड किए गए व्यूअर एपीआई के उदाहरण के तौर पर "नमस्ते, दुनिया" का उदाहरण. इसमें एपीआई को लोड करने और किसी खास किताब के साथ दर्शक को जोड़ने का तरीका बताया गया है. - किताब की भाषा
इस उदाहरण में, दर्शकों के इंटरफ़ेस की भाषा बदलने का तरीका बताया गया है. इस मामले में, ब्राज़ीलियन पॉर्चुगीज़ का इस्तेमाल किया जाएगा. - book-not found
इससे कॉलबैक फ़ंक्शन जोड़ने का तरीका पता चलता है. यह फ़ंक्शन तब कॉल किया जाता है, जब दर्शक दी गई किताब लोड नहीं कर पाता. ऐसी शर्तों को अच्छी तरह से मैनेज करने के लिए, इस उदाहरण को बनाया जा सकता है. - book-success
यह कॉलबैक फ़ंक्शन जोड़ने का तरीका बताता है, जिसे तब कहा जाता है, जब दर्शक किसी किताब के साथ शुरू कर देता है और प्रोग्राम के हिसाब से उसमें बदलाव करने के लिए तैयार होता है. - किताब को ऐनिमेट करना
यह देखने के लिए कि दर्शक को JavaScript का इस्तेमाल करके, प्रोग्राम के ज़रिए कंट्रोल कैसे किया जा सकता है, झलक एक झलक के तौर पर दिखती है. यह हर तीन सेकंड में अपने-आप फ़्लिप होकर अगले पेज पर पहुंच जाती है.
व्यूअर का प्रोग्राम के हिसाब से कंट्रोल
दर्शक आपको उस कोड का इस्तेमाल करने की सुविधा देता है जो उपयोगकर्ता, दर्शक से इंटरैक्ट करके कर सकता है. नीचे दिए गए उदाहरणों से पता चलता है कि यह कैसे काम आ सकता है.
- किताब के इंटरैक्शन कंट्रोल
काम करने के इस उदाहरण में उन सभी इंटरैक्शन के तरीकों के बारे में बताया गया है जो दर्शक के साथ काम करते हैं. इनमें ज़ूम, NextPage, goToPage, और हाइलाइट करने के फ़ंक्शन भी शामिल हैं. - book-इंटरैक्शन-openatpage
कॉलबैक और goToPage फ़ंक्शन का इस्तेमाल करके, किसी खास पेज पर किताब देखने वाले को अपने आप खोलने का तरीका दिखाता है.
Books API और डाइनैमिक लिंक के साथ जोड़ना
बेहतर ऐप्लिकेशन बनाते समय, एम्बेड किए गए व्यूअर एपीआई को Books एपीआई या डाइनैमिक लिंक सुविधा के साथ जोड़ना आपके लिए मददगार हो सकता है. उदाहरण के लिए, पहले से यह जानना उपयोगी हो सकता है कि एम्बेड करने के लिए कोई खास झलक उपलब्ध होगी या नहीं (उदाहरण के लिए, यह तय करने की कि उपयोगकर्ता को अपनी साइट पर झलक विंडो खोलने का विकल्प दें या नहीं). इसके अलावा, यह भी हो सकता है कि आपको किसी खास किताब के आइडेंटिफ़ायर की जानकारी न हो और आपको पहले Books API का इस्तेमाल करके, "इसे देखना" है. नीचे दिए गए उदाहरणों में बताया गया है कि ये कार्रवाइयां कैसे की जाएं.
- book-Dynamiclinks-zippy
यहां हमने देखा कि कोई किताब पहले एम्बेड करने के लिए उपलब्ध है या नहीं. अगर उपलब्ध हो और सिर्फ़ उपलब्ध हो, तो हम "झलक दिखाने वाला zippy" दिखाते हैं. इस पर क्लिक करने से, किताब की झलक इनलाइन दिखती है. - booksapi-titlesearch
इस उदाहरण में, किसी किताब के लिए खोज क्वेरी डालकर, एम्बेड किए गए व्यूअर को खोला जा सकता है. इसमें आपकी जोड़ी गई क्वेरी का, एम्बेड किया जा सकने वाला पहला नतीजा अपने-आप दिखेगा. यह खोज के नतीजों को ऐक्सेस करने के लिए, Data API के JSON आउटपुट फ़ॉर्मैट का इस्तेमाल करता है.