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

تم تصميم "معالج المعاينة" للسماح لك بدمج المعاينات بسرعة وسهولة وموثوقية مع موقعك الإلكتروني. يمكنك تضمين عارض كتب، أو رابط إلى بحث الكتب، أو حتى إضافة نافذة "نافذة منبثقة" للمعاينة إلى موقعك—كل ما عليك فعله هو إنشاء الرمز ولصقه في صفحتك. يمكنك أيضًا تخصيص هذه الرمز باستخدام بعض دوال 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 وpt-ru وpt-ru.

GBS_setViewerOptions

GBS_setViewerOptions(optionObj)
    المعلَمات:
      Object optionsObj - هي مجموعة من أزواج المفتاح/القيمة التي يتم تمريرها إلى دالة إنشاء المُشاهد التلقائي الخاصة بواجهة برمجة التطبيقات inline Viewer API. وعادةً ما يستخدم هذا لإجراء عمليات التخصيص المتقدمة.

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_insertEmbeddedViewer

GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
    إدراج معاينة كتاب مضمّنة أينما يتم استدعاء هذه الدالة إذا كانت المعاينة غير متاحة، لن يتم عرض أي مُشاهد.
    المَعلمات:
      Number opt_width - العرض المطلوب للعارض، بالبكسل.
      Number opt_height : ارتفاع العارض بالبكسل المطلوب

GBS_insertPreviewButtonPopup

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' }