Мастер предварительного просмотра
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Мастер предварительного просмотра создан для того, чтобы вы могли быстро, легко и надежно интегрировать предварительный просмотр с вашим сайтом. Вы можете встроить средство просмотра книг, ссылку на Поиск книг или даже добавить на свой сайт «всплывающее» окно предварительного просмотра — все, что вам нужно сделать, это сгенерировать код и вставить его на свою страницу. Вы также можете настроить этот код, используя некоторые простые функции JavaScript.
Мастер предварительного просмотра — это простая удобная библиотека, которую мы создали на основе наших API- интерфейсов динамических ссылок и встроенного средства просмотра . Если вы опытный разработчик, которому нужна индивидуальная интеграция, рассмотрите возможность прямого использования базовых API.
Создайте код предварительного просмотра
Примеры созданных превью
Следующие примеры были созданы с помощью мастера предварительного просмотра.
- viewwizard-embed : встраивает на страницу средство просмотра книг.
- viewwizard-popup : добавляет кнопку, по которой можно нажать, чтобы открыть плавающий предварительный просмотр на странице.
- viewwizard-linktogbs : вставляет кнопку, которая ссылается на предварительный просмотр на сайте Поиска книг.
- viewwizard-customurl : показывает кнопку, ведущую к определенному URL-адресу.
Настройте свой код
Помимо использования мастера, описанного выше, вы можете напрямую вызывать некоторые простые «вспомогательные» функции JavaScript. Для этого сначала следует загрузить библиотеку Preview Wizard. Один из способов сделать это — добавить следующий тег в раздел <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-PT, ro, ru, sr, sk, sl, es, sv, th, tr, uk и vi.
GBS_setViewerOptions
GBS_setViewerOptions(optionObj)
Параметры: Object optionsObj — набор пар ключ-значение, передаваемый конструктору DefaultViewer 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(identifiers)
Если доступен предварительный просмотр книги, эта функция записывает кнопку «Предварительный просмотр Google». При нажатии на эту кнопку открывается «плавающее окно предварительного просмотра» прямо в верхней части страницы. Если предварительный просмотр недоступен, кнопка не отображается. Более опытных разработчиков может заинтересовать Embedded Viewer API , который эта функция использует внутри себя.
Параметры: 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 "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-06-28 UTC.
[null,null,["Последнее обновление: 2024-06-28 UTC."],[],[],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' } `"]]
