אשף התצוגה המקדימה

אשף התצוגה המקדימה מאפשר לכם לשלב תצוגות מקדימות עם האתר שלכם במהירות, בקלות ובאמינות. אפשר להטמיע מציג ספרים, לקשר לחיפוש ספרים או אפילו להוסיף חלון קופץ לתצוגה מקדימה באתר – כל מה שצריך לעשות הוא ליצור את הקוד ולהדביק אותו בדף. אפשר גם להתאים אישית את הקוד הזה באמצעות כמה פונקציות פשוטות של JavaScript.


אשף התצוגה המקדימה הוא ספריית נוחות פשוטה שפיתחנו לצד קישורים דינמיים וממשקי צפייה מוטמעים. אם אתם מפתחים מתקדמים שמעוניינים בשילוב מותאם אישית, מומלץ להשתמש ישירות בממשקי ה-API.

יצירת קוד התצוגה המקדימה

דוגמאות לתצוגה מקדימה שנוצרה

הדוגמאות הבאות נוצרו באמצעות אשף התצוגה המקדימה.

התאמה אישית של הקוד

בנוסף לשימוש באשף שלמעלה, אפשר לקרוא ישירות לפונקציות פשוטות של JavaScript בשם "helper". לשם כך, עליך לטעון תחילה את הספרייה 'אשף התצוגה המקדימה'. דרך אחת לעשות זאת היא להוסיף את התג הבא לקטע <head> בדף שלך:

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

לאחר טעינה של ספריית התצוגה המקדימה, ניתן לקרוא לכל אחת מהפונקציות הבאות מתוך תגי <script> ב-<body> של המסמך. למשל, אם רוצים להוסיף את הלחצן 'תצוגה מקדימה של Google', יש להוסיף את הקוד לאלמנט <script> במיקום הרצוי של הדף בדף.

GBS_setLanguage

GBS_setLanguage(languageCode)
    משנים את השפה של כל לחצן או טקסט שמתווספים אחרי קריאה לפונקציה הזו. כולל השפה של הלחצן "תצוגה מקדימה של Google", שפת הממשק של התצוגה המקדימה המוטמעת וכן הלאה.
    פרמטרים:
      string languageCode – קוד השפה הרצוי של RFC 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, pt-BR, pt, r, t, tr, tr, tr, tr, tr, t, tr, tr, t, tr, t, tr, t, tr, t, tr, t, t, tr, RT, RT

GBS_setViewerOptions

GBS_setViewerOptions(optionObj)

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    הפונקציה הזו מיועדת לשימוש של מוציאים לאור בתוכנית השותפים. הפונקציה הזו מגדירה את האתר חיפוש במיתוג משותף שנועד להוסיף קישורים לתצוגה מקדימה לחיפוש ספרים. קריאה לפונקציה הזו לפני הוספת לחצן מבטיחה שהמשתמשים יראו את הלוגו של השותף מעל התצוגות המקדימות של החיפוש בספרים.
    פרמטרים:
      string cobrandName - שם המותג המשותף שצריך להוסיף לכתובות ה-URL של חיפוש הספרים. בדרך כלל השם הזה מופיע אחרי /p/ בכתובות ה-URL של התצוגה המקדימה ב'חיפוש ממותג'.

      לדוגמה, הגדרת הערך ל-sup תשלח את המשתמש לקישורים כמו
      https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover
      במקום ברירת המחדל
      https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover

GBS_insertInsertViewer

GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
    הפונקציה מוסיפה תצוגה מקדימה של ספר מוטמע בכל מקום שבו מתבצעת קריאה לפונקציה הזו. אם התצוגה המקדימה לא זמינה, אף צופה לא מוצג.
    פרמטרים:
      Number opt_width – הרוחב הרצוי של הצופה, בפיקסלים.
      Number opt_height – הגובה הרצוי של הצופה, בפיקסלים.

GBS_insertPreviewButtonPop-up

GBS_insertPreviewButtonPopup(identifiers)
    אם התצוגה המקדימה של הספר זמינה, הפונקציה הזו כותבת לחצן "תצוגה מקדימה של Google". לחיצה על הלחצן הזה פותחת "חלון תצוגה צף" בחלק העליון של הדף. אם אין תצוגה מקדימה זמינה, הלחצן לא משורטט.

    מפתחים מתוחכמים יותר עשויים להתעניין ב-API בעל הרשאת צפייה מוטמעת, שבו משתמשת הפונקציה הזו באופן פנימי.

    פרמטרים:
      string, Array identifier – כתובת URL לתצוגה מקדימה או מזהה ספר כמו ISBN, OCLC או מספר LCCN. פורמט הבקשה לבקשות בקישורים דינמיים אם ידוע לכם על כמה מזהים חלופיים עבור הספר, תוכלו להעביר מערך של המזהים האלה, והלחצן יופיע אם יש תצוגה מקדימה לאחד מהם. 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    אם התצוגה המקדימה של הספר זמינה, הפונקציה הזו כותבת לחצן "תצוגה מקדימה של Google" שמפנה אל דף התצוגה המקדימה של הספר. כברירת מחדל, הקישור מקשר לתצוגה המקדימה ב-Google Books, אבל אפשר גם:
    • להוסיף קישור לכתובת ה-URL באתר (שיכולה לכלול גם צופה מוטמע). כדי לעשות זאת, אפשר להעביר את האפשרות האופציונלית alternativeUrl.
    • קישור לגרסה של מותג משותף של דף התצוגה המקדימה של הספר, אם קראו ל-GBS_setCobrandName לפני הפונקציה הזו.
    אם אין תצוגה מקדימה זמינה למשתמש, לא יודפס דף בדף.
    פרמטרים:
      string, Array identifier – כתובת URL לתצוגה מקדימה או מזהה ספר כמו ISBN, OCLC או מספר LCCN. פורמט הבקשה לבקשות בקישורים דינמיים אם ידוע לכם על כמה מזהים חלופיים עבור הספר, תוכלו להעביר מערך של המזהים האלה, והלחצן יופיע אם יש תצוגה מקדימה לאחד מהם.
      Object opt_options – אופציונלי – מפת שם-ערך המשמשת להגדרת ההתנהגות של הלחצן. כרגע יש תמיכה באפשרות אחת: alternativeUrl. לדוגמה, כדי שלחצן התצוגה המקדימה של Google יקשר לדף תצוגה מקדימה מותאם אישית באתר, פשוט צריך להעביר את המידע הבא כארגומנט שני אל GBS_insertPreviewButtonLink:
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }