معالج المعاينة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تم تصميم "معالج المعاينة" للسماح لك بدمج المعاينات بسرعة وسهولة وموثوقية مع موقعك الإلكتروني. يمكنك تضمين عارض كتب، أو رابط إلى بحث الكتب، أو حتى إضافة نافذة "نافذة منبثقة" للمعاينة إلى موقعك—كل ما عليك فعله هو إنشاء الرمز ولصقه في صفحتك. يمكنك أيضًا تخصيص هذه الرمز باستخدام بعض دوال 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)
هذه الوظيفة مخصَّصة ليستخدمها الناشرون في برنامج الشركاء، ولذلك تحدّد هذه الوظيفة ميزة البحث ذو العلامات التجارية الشريكة التي سيتم استخدامها عند إدراج روابط معاينة الكتب. يضمن استدعاء هذه الوظيفة قبل إدراج زر أن يرى المستخدمون شعار الشريك أعلى معاينات "بحث الكتب".
GBS_insertEmbeddedViewer
GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
إدراج معاينة كتاب مضمّنة أينما يتم استدعاء هذه الدالة إذا كانت المعاينة غير متاحة، لن يتم عرض أي مُشاهد.
المَعلمات:
Number opt_width - العرض المطلوب للعارض، بالبكسل.
Number opt_height : ارتفاع العارض بالبكسل المطلوب
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' }
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-06-28 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-06-28 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Preview Wizard\n\nThe Preview Wizard is designed to let you quickly, easily, and reliably integrate previews with your site. You can embed a book viewer, link to Book Search, or even add a preview \"popup\" window to your site---all you need to do is [generate the code](#generateCode) and paste it onto your page. You can also [customize this code](#customizeYourCode) using some simple JavaScript functions.\n\nThe Preview Wizard is a simple convenience library we built on top of our [Dynamic Links](/books/docs/dynamic-links) and [Embedded Viewer](/books/docs/viewer/developers_guide) APIs. If you're an advanced developer looking for customized integration, consider\nusing the underlying APIs directly.\n\nGenerate your preview code\n--------------------------\n\n#### Enter book identifiers\n\nTell us all the ISBNs or other identifiers you know of for this book. If we can find a preview associated with any of these numbers, we can make it available to your site's users:\n\n|--------------------------------------|---|\n| ISBN OCLC number LCCN Book Search ID | |\n| ISBN OCLC number LCCN Book Search ID | |\n| ISBN OCLC number LCCN Book Search ID | |\n\n[Enter more identifiers...](about:invalid#zGoSafez)\n\n#### Choose how to show the book preview\n\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| If a preview is available for this book, what should the user see on your page? |---|------------------------------------------------------------------------| | | An embedded book viewer. Viewer size: pixels wide, pixels high | | | A button that opens a floating book viewer. | | | A button that links to the book's preview page on Book Search. | | | A button that goes to a custom preview page on your site. Preview URL: | If no preview can be found for the specified book(s), the preview or button will be automatically disabled and nothing will appear. | |\n\n#### Select your language\n\nChinese (Simplified) Chinese (Traditional) Dutch English French German Italian Japanese Portuguese (Brazilian) Russian Spanish\n\n#### Generate code for your web page\n\nExamples of generated previews\n------------------------------\n\nThe following examples were generated using the Preview Wizard.\n\n- [previewwizard-embed](/books/examples/previewwizard-embed): Embeds a book viewer on the page.\n- [previewwizard-popup](/books/examples/previewwizard-popup): Adds a button that can be clicked to open a floating preview over the page.\n- [previewwizard-linktogbs](/books/examples/previewwizard-linktogbs): Inserts a button that links to the preview on the Book Search site.\n- [previewwizard-customurl](/books/examples/previewwizard-customurl): Shows a button that goes to a specific URL.\n\nCustomize your code\n-------------------\n\nIn addition to using the wizard above, you can call some simple JavaScript \"helper\" functions directly. To do this, you should first load the Preview Wizard library. One way to do this is by adding the following tag to the `\u003chead\u003e` section of your page: \n\n```\n\u003cscript type=\"text/javascript\" src=\"https://books.google.com/books/previewlib.js\"\u003e\u003c/script\u003e\n```\n\nHaving loaded the preview library, you can then call any of the following functions from within `\u003cscript\u003e` tags inside your document's `\u003cbody\u003e`. For example, if you'd like to insert the \"Google Preview\" button, you'd put the code to do so in a `<script\u003e` element at the button's desired position within the page.\n\n### GBS_setLanguage\n\n```\nGBS_setLanguage(languageCode)\n```\n\nChanges the language of any buttons or text added after this function is called. This includes the language of the \"Google Preview\" button, the interface language of the embedded preview, and so on.\n\n\u003c!-- --\u003e\n\n**Parameters:** *string*` languageCode ` - The desired RFC 3066 language code (default is 'en' for English). Currently supported language codes include 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-PT, ro, ru, sr, sk, sl, es, sv, th, tr, uk, and vi.\n\n### GBS_setViewerOptions\n\n```\nGBS_setViewerOptions(optionObj)\n```\n\n**Parameters:** *Object*` optionsObj ` - A set of key-value pairs passed to the Embedded Viewer API's [DefaultViewer constructor](/books/docs/viewer/reference#google.books.DefaultViewer). Typically, this is used for advanced customizations.\n\n### GBS_setCobrandName\n\n```\nGBS_setCobrandName(cobrandName)\n```\n\nIntended for use by publishers in the [Partner Program](https://books.google.com/partner), this function sets the [Co-Branded Search](https://books.google.com/support/partner/bin/answer.py?hl=en&answer=65113) site to be used when inserting any preview links to Book Search. Calling this function before inserting a button ensures that users see the partner's logo above the Book Search previews.\n\n\u003c!-- --\u003e\n\n**Parameters:** *string*` cobrandName ` - The cobrand name to be added to any Book Search URLs. This is typically what comes after `/p/` in existing Co-Branded Search preview URLs.\n- For example, setting the value to `sup` will send the user to links like \n `https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover` \n rather than the default \n `https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover`\n\n### GBS_insertEmbeddedViewer\n\n```\nGBS_insertEmbeddedViewer(identifier, opt_width, opt_height)\n```\n\nInserts an embedded book preview wherever this function is called. If the preview is unavailable, no viewer is shown.\n\n\u003c!-- --\u003e\n\n**Parameters:** *string*` identifier ` - A preview URL or book identifier such as an ISBN, OCLC, or LCCN number. See [Dynamic Links request format](/books/docs/dynamic-links#requestFormat).\n\u003c!-- --\u003e\n\n*Number*` opt_width ` - The desired width of the viewer, in pixels.\n\u003c!-- --\u003e\n\n*Number*` opt_height ` - The desired height of the viewer, in pixels.\n\n### GBS_insertPreviewButtonPopup\n\n```\nGBS_insertPreviewButtonPopup(identifiers)\n```\n\nIf the book preview is available, this function writes out a \"Google Preview\" button. Clicking this button opens a \"floating preview window\" right on top of your page. If no preview is available, the button is not drawn.\n- More sophisticated developers may be interested in the [Embedded Viewer API](/books/docs/viewer/developers_guide), which this function uses internally.\n\n\u003c!-- --\u003e\n\n**Parameters:** *string, Array*` identifier ` - A preview URL or book identifier such as an ISBN, OCLC, or LCCN number. See [Dynamic Links request format](/books/docs/dynamic-links#requestFormat). If you know of several alternative identifiers for the book, you can pass an array of these identifiers, and the button will appear if a preview is available for any one of them.\n\n### GBS_insertPreviewButtonLink\n\n```\nGBS_insertPreviewButtonLink(identifiers, opt_options)\n```\n\nIf the book preview is available, this function writes out a \"Google Preview\" button that simply links off to a preview page for the book. By default, this links to the preview on Google Books, but you can also:\n- link to a URL on your site (which should, in turn contain an embedded viewer). You can do this by passing an optional `alternativeUrl` option.\n- link to a Co-Branded version of the book preview page, if [GBS_setCobrandName](#GBS_setCobrandName) is called before this function.\nIf no preview is available to the user, no button is drawn onto the page.\n\n\u003c!-- --\u003e\n\n**Parameters:** *string, Array*` identifier ` - A preview URL or book identifier such as an ISBN, OCLC, or LCCN number. See [Dynamic Links request format](/books/docs/dynamic-links#requestFormat). If you know of several alternative identifiers for the book, you can pass an array of these identifiers, and the button will appear if a preview is available for any one of them.\n\u003c!-- --\u003e\n\n*Object*` opt_options ` - *optional* - A name-value map used to configure the behavior of the button. Currently one option is supported: `alternativeUrl`. For example, to have the Google Preview button link to a custom preview page on your site, simply pass the following as a second argument to `GBS_insertPreviewButtonLink`: \n` { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' } `"]]
