ดูตัวอย่างวิซาร์ด

ตัวช่วยแสดงตัวอย่างได้รับการออกแบบมาเพื่อให้คุณรวมตัวอย่างกับเว็บไซต์ของคุณได้อย่างรวดเร็ว ง่ายดาย และเชื่อถือได้ คุณสามารถฝังเครื่องมือดูหนังสือ ลิงก์ไปยัง Book Search หรือแม้กระทั่งเพิ่มหน้าต่าง "ป๊อปอัป" หน้าตัวอย่างลงในเว็บไซต์ของคุณ สิ่งที่คุณต้องทำก็คือสร้างโค้ดและวางโค้ดลงในหน้าเว็บของคุณ นอกจากนี้คุณยังสามารถปรับแต่งโค้ดนี้โดยใช้ฟังก์ชัน JavaScript ง่ายๆ บางอย่าง


วิซาร์ดการแสดงตัวอย่างเป็นไลบรารีอำนวยความสะดวกที่เรียบง่ายซึ่งเราสร้างขึ้นโดยต่อยอดมาจาก API ของลิงก์แบบไดนามิกและผู้ดูแบบฝัง หากคุณเป็นนักพัฒนาซอฟต์แวร์ขั้นสูงที่ต้องการการผสานรวมที่กำหนดเอง โปรดลองใช้ API ที่เกี่ยวข้องโดยตรง

สร้างโค้ดตัวอย่าง

ตัวอย่างตัวอย่างที่สร้างขึ้น

ตัวอย่างต่อไปนี้สร้างขึ้นโดยใช้วิซาร์ดการแสดงตัวอย่าง

ปรับแต่งโค้ด

นอกจากการใช้วิซาร์ดข้างต้นแล้ว คุณยังสามารถเรียกใช้ฟังก์ชัน "ตัวช่วย" ของ JavaScript โดยตรงได้โดยตรงอีกด้วย โดยคุณควรโหลดไลบรารีวิซาร์ดการแสดงตัวอย่างก่อน วิธีหนึ่งที่ทำได้คือการเพิ่มแท็กต่อไปนี้ลงในส่วน <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-s,

GBS_setViewerOptions

GBS_setViewerOptions(optionObj)
    พารามิเตอร์:
      Object optionsObj - ชุดคู่คีย์-ค่าที่ส่งไปยังตัวสร้าง DefaultViewer ของ Embedded Viewer API โดยทั่วไป ตัวเลือกนี้ใช้สำหรับการปรับแต่งขั้นสูง

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    ฟังก์ชันนี้มีไว้สำหรับผู้เผยแพร่เนื้อหาในโปรแกรมพาร์ทเนอร์ โดยจะตั้งค่าเว็บไซต์การค้นหาแบบร่วมแบรนด์ให้ใช้เมื่อแทรกลิงก์ตัวอย่างไปยัง Book Search การเรียกใช้ฟังก์ชันนี้ก่อนแทรกปุ่มช่วยให้แน่ใจว่าผู้ใช้จะเห็นโลโก้ของพาร์ทเนอร์เหนือตัวอย่างใน Book Search
    พารามิเตอร์:
      string cobrandName - ชื่อแบรนด์ร่วมที่จะเพิ่มไปยัง URL ต่างๆ ของ Book Search โดยปกติแล้วจะเป็นชื่อที่อยู่หลัง /p/ ใน URL ตัวอย่างของการค้นหาแบบร่วมแบรนด์ที่มีอยู่

      ตัวอย่างเช่น การตั้งค่าเป็น 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" ออกมา การคลิกปุ่มนี้จะเปิดหน้าต่าง "แสดงตัวอย่างแบบลอย" ที่ด้านบนของหน้าขึ้นมา หากไม่มีหน้าตัวอย่าง หมายความว่าจะไม่มีการวาดปุ่มดังกล่าว

    นักพัฒนาซอฟต์แวร์ที่มีความเชี่ยวชาญเพิ่มขึ้นอาจสนใจใช้ Embedded Viewer 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 ลิงก์กับหน้าตัวอย่างที่กำหนดเองในเว็บไซต์ ให้ส่งข้อมูลต่อไปนี้เป็นอาร์กิวเมนต์ที่ 2 ไปยัง GBS_insertPreviewButtonLink
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }