Структурированные данные Book actions (Book)

Book actions делают Google Поиск точкой входа для поиска книг и авторов. Это позволяет пользователям Поиска быстро покупать или брать книги, которые они находят, прямо из результатов поиска. Например, пользователь может выполнить поиск по запросу Charlotte’s Web и получить результаты, которые позволят им купить или взять книгу. Как поставщик книг, вы можете предоставить фид данных в Google с помощью структурированной схемы данных, представленной здесь. Наша спецификация предоставляет
ReadAction для покупки книги и BorrowAction для того, чтобы взять книгу.

Действия чтения и заимствования, которые включены в панели, отображают варианты покупки или заимствования книги. С помощью предоставленных вами ссылок действия чтения и заимствования направляют пользователей прямо из панели знаний и других поверхностей Google на страницу книги на вашем веб-сайте или в приложении.

Порядок поставщиков в панели знаний персонализирован и динамичен для каждого пользователя. Это означает, что разные пользователи видят разный порядок, и один и тот же пользователь может видеть разный порядок в разное время. Существует множество факторов, влияющих на заданный порядок. Например, если пользователь часто нажимает на ссылку определенного поставщика в панели знаний, этот поставщик с большей вероятностью будет расположен выше в списке. Контролировать порядок невозможно.

Начало работы

Чтобы успешно реализовать Book actions, вы должны создать свой фид в соответствии с определениями типов структурированных данныхBook actions, но сначала ознакомьтесь со следующими разделами:

• Рекомендации
• Создайте свой фид
• Протестируйте свой фид с помощью инструмента проверки фидов данных
• Разместите файл фида
• Отправьте файл фида на проверку
• Обновляйте свой фид по мере необходимости

Рекомендации

Чтобы гарантировать, что ваши книги могут быть надежно представлены в Поиске, важно, чтобы вы были знакомы с некоторыми важными деталями и ключевыми концепциями. Кроме того, ваш фид должен соответствовать некоторым стандартизированным форматам спецификаций.

Чтобы помочь вам в этом, следуйте рекомендациям, описанным здесь, в дополнение к
общим рекомендациям по структурированным данным и
Основам Поиска. Рекомендации следующие:

• Произведения и издания
• Библиотечные системы и члены библиотек
• ISBN и другие поддерживаемые идентификаторы
• Ссылки

Произведения и издания

На протяжении всей этой документации мы используем два разных термина, когда говорим о книге:

• Произведение: Абстрактная концепция книги. В частности, метаданные, такие как название, автор и оригинальный язык, являются атрибутами произведения.
• Издание: Конкретная копия книги. В частности, метаданные, такие как год публикации, название издания и Международный стандартный книжный номер (ISBN), являются атрибутами издания.

Например, Charlotte’s Web является произведением, но каждая разновидность, в которой она выпускается, является изданием. В этом случае произведение Charlotte’s Web может иметь первое издание, второе издание, сокращенное издание, издание на французском языке и так далее.

Это различие особенно важно в фиде, где оно может быть не сразу очевидно. Существует две сущности Book сущности:

• Book (Произведение) является “верхним уровнем” Book
  сущности:
  • workExample является свойством Произведения и указывает один и только один экземпляр Book (Издание).
  • Должен быть как минимум один workExample для каждого Произведения.
• Book (Издание) является “нижним уровнем” Book
  сущности.

Полезно помнить, что у одного произведения может быть несколько изданий. Мы рекомендуем вам группировать эти издания вместе, насколько это возможно. Это помогает системам Google использовать всю соответствующую информацию о книге и отображать ее в Поиске. Если необходимо, вы можете разбить их на несколько записей произведений, но каждая запись произведения должна иметь следующее:

• Другой @id.
• Как минимум одно издание с ISBN или другим поддерживаемым идентификатором.

Библиотечные системы и члены библиотек

Сущность Library является «верхним уровнем» Library типа сущности. Это абстрактная конструкция, состоящая из сущности LibrarySystem и каждой сущности
Library (member) этой библиотечной системы.

Сущность LibrarySystem является абстракцией и представляет собой совместную сеть библиотек- участников. Например, Публичную библиотеку Остина можно определить как сущность
LibrarySystem . На сайте Публичной библиотеки Остина они описывают себя как публичную библиотечную систему , обслуживающую Остин, штат Техас. Она состоит из 20 аффилированных библиотек или библиотек- участников.

. Каждая сущность LibrarySystem требует наличия как минимум одной сущности Library (member)
, даже если в реальности библиотека не является частью какой-либо библиотечной системы. В этом сценарии для целей реализации действия Book библиотека является единственным
участником своей собственной библиотечной системы. Для целей реализации действия Book, в отличие от библиотечной системы, библиотека- участник не является абстракцией и поэтому имеет физический адрес.

И наоборот, каждая сущность Library (member) должна принадлежать как минимум к одной сущности
LibrarySystem .

ISBN и другие поддерживаемые идентификаторы

ISBN — это основной сигнал для сопоставления данных вашего фида с данными Google в Google Search. Вы должны предоставить ISBN или другой поддерживаемый идентификатор для всех книг, которые хотите отображать в результатах поиска. Без этого ваши книги, скорее всего, не будут сопоставлены и, следовательно, не будут показаны.

Google Search предпочитает ISBN-13, но вы можете предоставить следующие альтернативы:

• Номер Online Computer Library Center (OCLC)
• Контрольный номер Библиотеки Конгресса (LCCN)
• JP e-code

Ссылки

Чтобы обеспечить пользователям наилучшие возможности поиска ваших книг, ссылки в вашем фиде должны соответствовать следующим рекомендациям:

• Если у вас есть дублирующиеся страницы для одного и того же контента, ссылка должна быть
  каноническим URL , содержащим название книги и другую информацию о ней.
• После того как пользователь нажимает на ссылку действия чтения или заимствования, он должен быть перенаправлен на страницу, которая напрямую поддерживает покупку или заимствование книги. В частности, не направляйте ссылки действий на страницы с дополнительными ссылками, которые нужно нажать для покупки или заимствования контента. Например, не отправляйте пользователей на страницу результатов поиска или страницу с кратким описанием продукта.

Создайте свой фид

Если ваш сайт продает книги для покупки пользователями, вы должны загрузить фид
Book . Команда поддержки Google свяжется с вами и предоставит подробную информацию о том, как и куда загрузить фид.

Если ваш сайт предоставляет книги для заимствования пользователями, вы должны загрузить два отдельных фида: фид
Book и фид
Library . Команда поддержки Google свяжется с вами и предоставит подробную информацию о том, как и куда загрузить фид.

Соблюдайте требования к размеру, количеству и формату файлов фида

Требования следующие:

• Требования к размеру файла фида:
  • Размер несжатого файла фида должен быть менее 1 ГБ.
  • Файл фида, который подлежит сжатию, должен быть менее 1 ГБ. Если ваш несжатый файл фида превышает 1 ГБ, вы должны разделить его на несколько файлов.
• Вы можете сжимать файлы фидов. Они должны быть отформатированы в виде архива zip, gz, tar, tar.gz, JAR, ar, arj, cpio или dump.
• Если у вас несколько файлов фидов, вы можете загрузить их как есть или, если хотите, включить их в состав
  файла индекса sitemap.
• Отдельные файлы фидов должны иметь .json расширение имени файла.

Соблюдайте требования к контенту фида

Особое внимание уделите следующим требованиям к контенту фида, которые вы должны соблюдать:

• Фид не должен содержать устаревшие сущности. Устаревшие сущности — это сущности, у которых
  availabilityEnds установлено на прошедшую дату, или сущности, которые больше не доступны на вашем сайте.
• Все глубокие ссылки, такие как urlTemplate, и все URL-адреса, такие как
  url, которые вы включаете в свой фид, должны быть рабочими (production) URL-адресами. Не используйте QA, тестовые или любые другие нерабочие URL-адреса.
• Все URL-адреса, такие как url, должны быть
  каноническими.
• Каждая сущность в вашем фиде должна содержать следующие свойства:
  • Уникальный ID: @id
  • Уникальный URL-адрес: url
  • Уникальная глубокая ссылка: urlTemplate

Протестируйте свой фид с помощью инструмента проверки Data Feed

Мы рекомендуем следующие шаги по устранению неполадок для решения распространенных ошибок и предупреждений в инструменте проверки Data Feed:

• Убедитесь, что в поле Validate on выбрана правильная опция. Выберите Books Action для сущности Book .

• Проверьте, правильно ли написано значение @type .
• Убедитесь, что значение @context установлено правильно. Установите
  "@context": "https://schema.org" как для ReadAction , так и для
  BorrowAction.

Разместите файл фида

Когда файл фида готов, разместите его в защищенном месте. Google регулярно считывает фид, чтобы ваш контент был актуальным.

Методы хостинга

Поддерживаются следующие методы хостинга фидов:

Чтобы ваш контент был доступен в Google Search, команда поддержки Google проверяет качество глубоких ссылок в вашем фиде. Мы настоятельно рекомендуем вручную протестировать некоторые глубокие ссылки, чтобы убедиться, что они открывают страницу, где пользователи могут купить или взять книги.

Примечание:

Место размещения:

• URL-адрес вашего файла фида. Аутентификация хоста, если применимо:
• Учетные данные для аутентификации, позволяющие Google получить файл фида с вашего хоста. Обновляйте фид по мере необходимости

Мы рекомендуем обновлять фид ежедневно, но это зависит от того, как часто меняется ваш каталог. Учитывайте следующие условия и советы:

Google Search не поддерживает обновления в реальном времени.

• Google Search считывает ваш фид один раз в день и обычно индексирует контент в течение двух дней.
• Если ожидается изменение доступности издания, используйте
• tr
  availabilityStarts и availabilityEnds
  чтобы задать точные даты. Если объект больше недоступен, полностью удалите его.

Определения типов структурированных данных

Вы должны включить обязательные свойства, перечисленные здесь, чтобы ваш контент мог отображаться в структурированных результатах поиска. Вы также можете добавить рекомендуемые свойства, чтобы предоставить больше информации о вашем контенте, что может улучшить пользовательский опыт.

Сущность DataFeed

Каждый файл ленты данных schema.org, предоставляемый Google, должен содержать одну сущность
DataFeed на корневом уровне. Все сущности
Book и
Library должны быть перечислены в поле
dataFeedElement сущности DataFeed .

Поддерживаемые Google свойства:

Book сущность

Хотя полное определение Book доступно на
schema.org/Book, вам нужно учитывать только следующие свойства. Вы должны определить обязательные свойства для каждой книги, которую решите включить в свой фид. Вы также можете определить рекомендуемые свойства, чтобы добавить больше информации о вашем контенте, что может улучшить пользовательский опыт.

Book (Work)

Эта Book сущность является сущностью верхнего уровня. Она представляет собой произведение.

Поддерживаемые Google свойства следующие:

Book (Edition)

Свойство workExample использует эту Book сущность. Она представляет
издание произведения. Ключевой момент:.

Поддерживаемые Google свойства:

Пример Книга (Издание):

Пример Книга (Издание) с несколькими workExample свойства:

Персона или Организация (автор)

Свойство автор книги использует сущность
Персона или Организация .

Пример автор:

Пример с несколькими автор свойствами:

PropertyValue (идентификатор)

Свойство идентификатор сущности Издание использует сущность PropertyValue
.

Пример идентификатор:

Пример с несколькими идентификатор свойствами:

Пример ReadAction Книга JSON-файл ленты

Пример BorrowAction Книга JSON-файл ленты

ReadAction (potentialAction)

Свойство potentialAction использует сущность ReadAction .
ReadAction определяет ваши глубокие ссылки для доступа к книге, розничного продавца, у которого есть эта книга, и критерии, которым должны соответствовать пользователи. Критерии могут включать статус членства, статус входа в систему, местоположение или любые другие требования для доступа к книге.

Пример ReadAction:

Пример ReadAction с несколькими свойствами EntryPoint :

BorrowAction (potentialAction)

Свойство potentialAction использует сущность BorrowAction .
BorrowAction определяет ваши глубокие ссылки для доступа к книге, библиотеку, в которой она находится, и критерии, которым должны соответствовать пользователи. Критерии могут включать статус членства, статус входа в систему, местоположение или любые другие требования для доступа к книге.

Пример BorrowAction:

Пример BorrowAction с несколькими Точка входа свойства:

Библиотека сущность

Хотя полное определение Библиотека доступно по адресу
schema.org/Library, вам нужно учитывать только следующие свойства. Вы должны определить обязательные свойства для каждой библиотеки, которую решите включить в свой фид. Вы также можете определить рекомендуемые свойства, чтобы добавить больше информации о вашем контенте, что может улучшить пользовательский опыт.

Эта Библиотека сущность является сущностью верхнего уровня типа Библиотека
. Это абстрактная конструкция, состоящая из сущности
LibrarySystem и каждой сущности более низкого уровня
Библиотека (участник) этой
LibrarySystem.

Фид Библиотека отличается от фида Книга . Поэтому любой фид Библиотека
, который вы можете внедрить, должен быть полностью отделен от вашего фида Книга . Для получения дополнительной информации обратитесь к разделу
Создание вашего фида.

LibrarySystem

Сущность LibrarySystem представляет собой совместную сеть участников.

Library (member)

Свойство member сущности LibrarySystem использует сущность Library (member) .
Library (member) представляет собой отдельную библиотеку member
данной библиотечной системы.

Пример LibrarySystem JSON-файл ленты