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

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


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

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

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

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

  • previewwizard-embed: ฝังผู้ดูหนังสือในหน้าเว็บ
  • previewwizard-popup: เพิ่มปุ่มที่คลิกเพื่อเปิดตัวอย่างแบบลอยในหน้าเว็บได้
  • previewwizard-linktogbs: แทรกปุ่มที่ลิงก์ไปยังตัวอย่างบนเว็บไซต์ Book Search
  • previewwizard-customurl: แสดงปุ่มที่ไปยัง URL หนึ่ง

ปรับแต่งโค้ดของคุณ

นอกเหนือจากการใช้วิซาร์ดข้างต้นแล้ว คุณสามารถเรียกใช้ฟังก์ชัน "ผู้ช่วย" แบบ JavaScript ง่ายๆ บางอย่างได้โดยตรง ในการดําเนินการนี้ คุณควรโหลดไลบรารีวิซาร์ดดูตัวอย่างก่อน วิธีหนึ่งที่ทําได้คือการเพิ่มแท็กต่อไปนี้ลงในส่วน <head> ของหน้าเว็บ

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

เมื่อโหลดไลบรารีตัวอย่างแล้ว คุณจะเรียกฟังก์ชันต่อไปนี้ได้จากภายใน <script> แท็กภายใน <body> ของเอกสาร ตัวอย่างเช่น หากคุณต้องการแทรกปุ่ม "Google Preview" คุณจะต้องวางโค้ดเพื่อดําเนินการในองค์ประกอบ <script> ในตําแหน่งที่ต้องการของปุ่มภายในหน้าเว็บ

ภาษา GBS_set

GBS_setLanguage(languageCode)
    เปลี่ยนภาษาของปุ่มหรือข้อความที่เพิ่มเข้ามาหลังจากเรียกใช้ฟังก์ชันนี้แล้ว ข้อมูลนี้รวมถึงภาษาของปุ่ม "Google Preview" ภาษาของอินเทอร์เฟซสําหรับการแสดงตัวอย่างแบบฝัง และอื่นๆ
    พารามิเตอร์:
      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, stv th, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro, ro

ตัวเลือก GBS_setViewer Options

GBS_setViewerOptions(optionObj)
    พารามิเตอร์:
      Object optionsObj - ชุดคู่คีย์-ค่าที่ส่งไปยังเครื่องมือสร้าง ID ของโปรแกรมดูโค้ดแบบฝัง ซึ่งโดยปกติจะใช้สําหรับการปรับแต่งขั้นสูง

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_insertViewViewer

GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
    แทรกตัวอย่างหนังสือที่ฝังทุกครั้งที่มีการเรียกใช้ฟังก์ชันนี้ หากไม่มีตัวอย่าง แสดงว่าไม่มีผู้ดู
    พารามิเตอร์:
      Number opt_width - ความกว้างที่ผู้ชมต้องการในหน่วยพิกเซล
      Number opt_height - ความสูงของผู้ชมในหน่วยพิกเซล

GBS_insertดูตัวอย่างปุ่มป๊อปอัป

GBS_insertPreviewButtonPopup(identifiers)
    หากมีตัวอย่างหนังสือ ฟังก์ชันนี้จะเขียนปุ่ม "Google Preview" การคลิกปุ่มนี้จะเปิด "หน้าต่างตัวอย่างแบบลอย" ที่ด้านบนของหน้า หากไม่มีการแสดงตัวอย่าง ระบบจะไม่วาดปุ่มดังกล่าว

    นักพัฒนาซอฟต์แวร์ที่ซับซ้อนกว่าอาจสนใจใช้ Embedded Viewer API ซึ่งฟังก์ชันนี้จะใช้ภายใน

    พารามิเตอร์:
      string, Array identifier - URL ตัวอย่างหรือตัวระบุหนังสือ เช่น ISBN, หมายเลข OCLC หรือ LCCN ดูรูปแบบคําขอลิงก์แบบไดนามิก หากทราบตัวระบุทางเลือกอื่นๆ ของหนังสือ คุณจะส่งอาร์เรย์ของตัวระบุเหล่านี้ได้ และปุ่มจะปรากฏหากมีการแสดงตัวอย่างตัวระบุ 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    หากมีตัวอย่างหนังสือ ฟังก์ชันนี้จะเขียนปุ่ม "Google Preview" ที่เพียงแค่ลิงก์ไปยังหน้าแสดงตัวอย่างของหนังสือ โดยค่าเริ่มต้น การดําเนินการนี้จะลิงก์ไปยังตัวอย่างใน Google Books แต่คุณจะทําสิ่งต่อไปนี้ได้ด้วย
    • ลิงก์ไปยัง URL บนไซต์ของคุณ (ซึ่งควรจะมีผู้ดูแบบฝัง) ซึ่งทําได้โดยใช้ตัวเลือก alternativeUrl ที่ไม่บังคับ
    • ลิงก์ไปยังหน้าตัวอย่างหนังสือแบบร่วมแบรนด์ หากมีการเรียกใช้ GBS_setCobrandName ก่อนฟังก์ชันนี้
    หากไม่มีการแสดงตัวอย่างผู้ใช้ ระบบจะไม่วาดปุ่มในหน้าดังกล่าว
    พารามิเตอร์:
      string, Array identifier - URL ตัวอย่างหรือตัวระบุหนังสือ เช่น ISBN, หมายเลข OCLC หรือ LCCN ดูรูปแบบคําขอลิงก์แบบไดนามิก หากทราบตัวระบุทางเลือกอื่นๆ ของหนังสือ คุณจะส่งอาร์เรย์ของตัวระบุเหล่านี้ได้ และปุ่มจะปรากฏหากมีการแสดงตัวอย่างตัวระบุ
      Object opt_options - ไม่บังคับ - ใช้การแมปค่าชื่อเพื่อกําหนดค่าลักษณะการทํางานของปุ่ม ปัจจุบันระบบรองรับ 1 ตัวเลือก: alternativeUrl เช่น หากต้องการให้ปุ่มแสดงตัวอย่างของ Google ลิงก์ไปยังหน้าตัวอย่างที่กําหนดเองในเว็บไซต์ เพียงส่งข้อความต่อไปนี้เป็นอาร์กิวเมนต์ที่ 2 กับ GBS_insertPreviewButtonLink
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }