معالج المعاينة

تم تصميم معالج المعاينة للسماح لك بمعاينة المعاينات بسرعة وسهولة وموثوقية مع موقعك الإلكتروني. يمكنك تضمين عارض كتاب أو رابط إلى بحث الكتب أو حتى إضافة نافذة "نافذة منبثقة" للمعاينة إلى موقعك، كل ما عليك فعله هو إنشاء الرمز ولصقه على صفحتك. يمكنك أيضًا تخصيص هذا الرمز باستخدام بعض وظائف JavaScript البسيطة.


معالج المعاينة هو مكتبة صغيرة سهلة الاستخدام تم إنشاؤها بالاستناد إلى واجهات برمجة التطبيقات الروابط الديناميكية والمُشاهد المضمّن. إذا كنت مطوّر برامج متقدمًا وتبحث عن دمج مخصّص، ننصحك باستخدام واجهات برمجة التطبيقات الأساسية مباشرةً.

إنشاء رمز المعاينة

أمثلة على المعاينات التي تم إنشاؤها

تم إنشاء الأمثلة التالية باستخدام "معالج المعاينة".

تخصيص الرمز

بالإضافة إلى استخدام المعالج أعلاه، يمكنك استدعاء بعض وظائف "مساعد" 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، ru، ru، sl، ru، ru، ru، ver، ru، ru، ru، ru.

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_insertمعاينةButtonPopup

GBS_insertPreviewButtonPopup(identifiers)
    إذا كانت معاينة الكتاب متاحة، تكتب هذه الدالة زر "معاينة Google". يؤدي النقر على هذا الزر إلى فتح "نافذة معاينة عائمة" في أعلى الصفحة. إذا لم تكن هناك معاينة متوفّرة، يعني هذا أنّ الزر غير مرسوم.

    قد يرغب مطوّرو برامج أكثر تطورًا في واجهة برمجة تطبيقات المشاهد المضمّنة، والتي تستخدمها هذه الوظيفة داخليًا.

    المعلّمات:
      string, Array identifier - عنوان URL للمعاينة أو معرّف كتاب، مثل رقم ISBN أو OCLC أو رقم LCCN اطّلِع على تنسيق طلب الروابط الديناميكية. إذا كنت تعرف عدة معرّفات بديلة للكتاب، يمكنك تمرير مجموعة من هذه المعرّفات، وسيظهر الزر إذا كانت المعاينة متاحة لأي معرّف. 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    إذا كانت معاينة الكتاب متاحة، تكتب هذه الوظيفة زر "معاينة Google" الذي يؤدي ببساطة إلى صفحة معاينة للكتاب. يؤدي هذا الرابط تلقائيًا إلى المعاينة على "كتب Google"، ولكن يمكنك أيضًا:
    • رابطًا إلى عنوان 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' }