Користувачі можуть шукати в Google Пошуку книги та їхніх авторів. Завдяки цьому типу даних вони зможуть одразу ж купити потрібну книгу (наприклад, роман Війна і мир) або взяти її напрокат. Якщо ви продаєте книги, завантажте в Google фід з описаними тут структурованими даними. У нашій специфікації є дії ReadAction (купити книгу) та BorrowAction (взяти напрокат).

Дії ReadAction і BorrowAction перетворюються в блоках знань та інших панелях Google на посилання «Купити» і «У бібліотеці». Натиснувши на таке посилання, користувач переходить на сторінку книги на вашому сайті або у вашому додатку.
Порядок постачальників у блоці знань визначається індивідуально для кожного користувача. Тобто у кожного з них постачальники будуть розташовані по-різному, і навіть для одного й того самого користувача в різних випадках блок знань може бути різним. Це залежить від кількох факторів. Наприклад, якщо користувач часто натискає на посилання одного з постачальників, то цей постачальник, швидше за все, буде розташовуватися вище за інших у блоці знань. Змінити цей порядок вручну не можна.
Початок роботи
Щоб реалізувати дії, пов’язані з книгами, створіть фід відповідно до специфікації структурованих даних Book. Але попередньо вивчіть наступні розділи:
- Правила
- Створення фіду
- Перевірка фіду за допомогою інструменту валідації
- Розміщення фіду
- Відправлення фіду на перевірку
- Оновлення фіду
Правила
Якщо ви хочете, щоб ваші книги з’являлися в результатах пошуку, ознайомтеся з важливою інформацією та основними поняттями. Також не забувайте, що ваш фід повинен відповідати стандартизованим вимогам до цього формату.
Щоб виконати ці вимоги, вивчіть інформацію, наведену в цій статті, а також загальні рекомендації щодо використання структурованих даних і Головне про Пошук. Ці вимоги поділяються на такі категорії:
Твори та видання
У цій документації використовуються два терміни, пов’язані з книгами:
- Твір. Абстрактна книга, яка характеризується такими атрибутами, як назва, автор і мова оригіналу.
- Видання. Певний набір примірників книги, який характеризується такими атрибутами, як рік видання, назва видання та номер ISBN.
Наприклад, Війна і мир — це твір, який може мати кілька видань: перше, друге, скорочене, переклад англійською мовою тощо.
Про цю різницю (не завжди очевидну) особливо важливо пам’ятати при створенні фіду. Є два елементи Book:
Book(Work) – твір. Це елементBookверхнього рівня:workExample– це властивість елементаWork, яка позначає один єдиний примірник елементаBook(Edition).- У кожного елемента
Workповинна бути хоча б одна властивістьworkExample.
Book(Edition) – видання. Це елементBookнижнього рівня.
Кожен твір може мати кілька видань. Видання рекомендується об’єднувати в якомога більші групи. Так алгоритмам Google буде легше обробити всю інформацію про книгу і представити її в Пошуку. При необхідності їх можна розбити на кілька записів з творами, але тоді кожен запис повинен мати:
- унікальний ідентифікатор
@id; - хоча б одне видання з номером ISBN або іншим підтримуваним ідентифікатором.
Бібліотечні мережі та філії
Library entity – елемент Library верхнього рівня. Це узагальнене поняття, до якого входить елемент LibrarySystem (бібліотечна мережа) та елементи Library (member) (філія бібліотеки), які відносяться до цієї мережі.
Елемент LibrarySystem – це абстрактне поняття, що позначає бібліотечну мережу, яка складається з філій бібліотеки. Наприклад, Публічну бібліотеку Остіна (штат Техас) можна представити елементом LibrarySystem. На її сайті вказано, що це мережа публічних бібліотек, які обслуговують місто Остін у штаті Техас. Вона складається з 20 афілійованих бібліотек, або філій.
Кожен елемент LibrarySystem повинен мати хоча б один елемент Library (member), навіть якщо в реальності бібліотека не входить до бібліотечної мережі. У такому разі просто вважається, що вона є єдиною філією в мережі. На відміну від бібліотечної мережі, філія бібліотеки не є абстракцією та має фізичну адресу.
Кожна філія (елемент Library (member)) повинна належати хоча б до однієї бібліотечної мережі (елемент LibrarySystem).
Номер ISBN та інші підтримувані ідентифікатори
Номер ISBN — це основна ознака, яка використовується, коли Пошук зіставляє дані фіду з даними Google. Для всіх книг, які ви хочете зробити доступними в результатах пошуку, потрібно вказати номер ISBN або інший підтримуваний ідентифікатор. В іншому випадку ваші книги можуть не зіставлятися з запитами користувачів і не відображатися на сторінці результатів.
Для Пошуку Google бажано використовувати номери у форматі ISBN-13, але також допускаються такі ідентифікатори:
- номер OCLC (система Комп’ютерного бібліотечного онлайн-центру);
- номер LCCN (система Бібліотеки Конгресу);
- номер JP e-code (система японського Комітету з вивчення та управління кодами електронних видань).
Посилання
Щоб користувачам було зручно знаходити ваші книги, посилання в фіді повинні відповідати наступним правилам:
- Якщо контент дублюється, використовуйте як посилання канонічний URL, який містить назву та іншу інформацію про книгу.
- Коли користувач натискає на посилання, щоб прочитати книгу, він повинен перейти на сторінку, де він може купити її або взяти напрокат. Не налаштовуйте переадресацію на сторінки, де потрібно знову натиснути на посилання, щоб виконати ці дії, наприклад, на сторінку з результатами пошуку або описом книги.
Створення фіду
Якщо книги на вашому сайті продаються, завантажте в Google фід Book. Наша служба підтримки повідомить вам, як це зробити.
Якщо книги на вашому сайті видаються на певний час, завантажте два фіди: Book та Library. Наша служба підтримки повідомить вам, як це зробити.
Вимоги до розміру, кількості та формату
Враховуйте наведені нижче вимоги.
- Розмір файлу:
- Розмір нестисненого файлу з фідом не повинен перевищувати 1 ГБ.
- Перед стисненням розмір файлу не повинен перевищувати 1 ГБ. В іншому випадку його потрібно розбити на кілька файлів.
- Файли з фідами можна стискати, використовуючи такі формати: ZIP, GZ, TAR, TAR.GZ, JAR, AR, ARJ, CPIO або DUMP.
- Якщо у вас є кілька файлів з фідами, їх можна завантажити окремо або включити в файл індексу Sitemap.
- Окремі файли з фідами повинні мати розширення
.json.
Вимоги до змісту фіду
Дотримуйтесь перелічених нижче вимог до змісту фіду.
- У фіді не повинно бути неактивних елементів. Неактивними вважаються елементи, у яких у властивості
availabilityEndsзадана минула дата, і ті, яких більше немає на вашому сайті. - Усі посилання на контент (наприклад,
urlTemplate) і всі URL (наприклад,url) у фіді повинні бути робочими. URL-адреси, які використовуються для тестування, розробки або інших цілей, відмінних від робочих, не допускаються. - Усі URL (наприклад,
url) повинні бути канонічними. - Для кожного елемента в фіді повинні бути задані наступні властивості:
- унікальний ідентифікатор
@id; - унікальний URL
url; - унікальне посилання на контент
urlTemplate.
- унікальний ідентифікатор
Перевірка фіду за допомогою інструменту валідації
Якщо перевірка фіду за допомогою інструменту валідації показала наявність помилок або попереджень, рекомендуємо виконати наступні дії, щоб їх усунути:
- Виберіть потрібний варіант у полі Перевірити. Для елемента
Bookце має бути Дія з книгами. - Переконайтеся, що в значенні параметра
@typeнемає помилок. - Перевірте, чи правильно вказано значення параметра
@context. Установіть значення"@context": "https://schema.org"і дляReadAction, і дляBorrowAction.
Розміщення фіду
Завершивши створення фіду, помістіть його в надійне сховище так, щоб Google мав до нього доступ для періодичного оновлення інформації про ваші книги.
Де можна розміщувати фіди
Підтримуються наступні варіанти розміщення:
| Хостинг | Підтримувані методи автентифікації | |
|---|---|---|
| Хмарне сховище Google | Дозвіл для Спостерігача об’єктів у сховищі | |
| HTTPS | Ім’я користувача та пароль або сертифікат клієнта для HTTP-з’єднання | |
| SFTP | Пароль або ключ з кодовою фразою (або обидва ці варіанти) | |
| AWS S3 | Ідентифікатор ключа та ключ доступу | |
Відправлення фіду на перевірку
Перш ніж ваші книги з’являться в Пошуку Google, наші фахівці повинні перевірити якість посилань на контент, що використовуються у фіді. Настійно рекомендуємо вручну перевірити хоча б деякі з них. Ці посилання повинні вести на сторінки, на яких можна купити книгу або отримати її на час.
Щоб подати запит на перевірку фіду, вкажіть наступну інформацію:
- де знаходиться фід — URL файлу з фідом;
- спосіб автентифікації — облікові дані для доступу Google до фіду.
Оновлення фіду
Ми рекомендуємо оновлювати фід щодня, але в кінцевому підсумку періодичність оновлення залежить від того, як часто змінюється ваш каталог. Також враховуйте наступне:
- Google Search не підтримує оновлення в режимі реального часу.
- Google Пошук зчитує фід один раз на добу і індексує контент (як правило) протягом двох днів.
- Якщо термін доступності видання в найближчому майбутньому буде змінено, вкажіть точні дати за допомогою властивостей
availabilityStartsтаavailabilityEnds. Якщо елемент недоступний, його необхідно видалити.
Типи структурованих даних
Щоб контент міг з’явитися в структурованих результатах пошуку, необхідно встановити всі зазначені тут обов’язкові властивості. Ви також можете додати рекомендовані властивості, щоб користувачі отримували більше корисної інформації.
Елемент DataFeed
Кожен файл із фідом даних schema.org, переданий у Google, повинен містити єдиний елемент DataFeed на кореневому рівні. Усі елементи Book та Library повинні бути перелічені в полі dataFeedElement елемента DataFeed.
Google підтримує наступні властивості:
| Обов’язкові властивості | |
|---|---|
@context | Має мати значення |
@type | Має мати значення |
data |
Повинні мати як значення один елемент Приклад використання для фіду { "@context": "https://schema.org", "@type": "DataFeed", "dataFeedElement": [ { "@context": "https://schema.org", "@type": "Book", "@id": "https://example.com/work/the_catcher_in_the_rye", "url": "https://example.com/work/the_catcher_in_the_rye", "name": "The Catcher in the Rye", "author": { "@type": "Person", "name": "J.D. Salinger" }, "sameAs": "https://en.wikipedia.org/wiki/The_Catcher_in_the_Rye", "workExample": [ { "@type": "Book", "@id": "https://example.com/edition/the_catcher_in_the_rye_paperback", "isbn": "9787543321724", "bookEdition": "Mass Market Paperback", "bookFormat": "https://schema.org/Paperback", "inLanguage": "en", ... }, ... ] } ], "dateModified": "2018-09-10T13:58:26.892Z" } Приклад використання для фіду { "@context": "https://schema.org", "@type": "DataFeed", "dataFeedElement": [ { "@context": "https://schema.org", "@type": "LibrarySystem", "@id": "https://example.com/library-systems/100", "name": "Santa Clara County Library District", "additionalProperty": [ { "@type": "PropertyValue", "name": "librarytype", "value": "public" } ], ... }, ... ], "dateModified": "2018-09-10T13:58:26.892Z" } |
date | Дата і час останнього оновлення фіду у форматі ISO 8601. |
Елемент Book
Повне визначення елемента Book наведено на сторінці schema.org/Book. Однак вам достатньо ознайомитися з описаними нижче властивостями. Для кожної книги, включеної до фіду, необхідно вказати обов’язкові властивості. Ви також можете задати рекомендовані властивості, щоб користувачі отримували більше корисної інформації.
Елемент Book (Work)
Цей елемент Book відноситься до верхнього рівня розмітки і відповідає твору.
Google підтримує наступні властивості:
| Обов’язкові властивості | |
|---|---|
@context | Має мати значення |
@id | Унікальний ідентифікатор книги у форматі URL. Цей ідентифікатор не повинен повторюватися в межах вашої організації. Його не можна змінювати. Використання формату URL — рекомендація, а не вимога. Це не обов’язково має бути робоче посилання, але домен, зазначений в ідентифікаторі |
@type | Має мати значення |
author |
Автори книги. |
name | Назва книги. |
url | URL сторінки з презентацією або описом книги на вашому сайті. Це посилання допомагає точно зіставити контент у фіді з контентом у базах даних Google. Значення цієї властивості може збігатися зі значенням властивості Для фактичних цільових сторінок у Пошуку Google використовується URL, зазначений у властивості |
work |
Видання твору. |
| Рекомендовані властивості | |
|---|---|
same | URL сторінки з інформацією, що ідентифікує твір. Це може бути сторінка книги у Вікіпедії, Вікіданих, Віртуальному каталозі міжнародного нормативного контролю інформації про твори та їх авторів (VIAF) або на сайті Бібліотеки Конгресу. |
Елемент Book (Edition)
Цей елемент Book використовується у властивості workExample і позначає видання твору.
Google підтримує наступні властивості:
| Обов’язкові властивості | |
|---|---|
@id | Унікальний ідентифікатор книги у форматі URL. Цей ідентифікатор не повинен повторюватися в межах вашої організації. Його не можна змінювати. Використання формату URL — рекомендація, а не вимога. Це не обов’язково має бути робоче посилання, але домен, зазначений в ідентифікаторі |
@type | Має мати значення |
book | Формат видання. Можливі значення:
|
in | Основна мова видання. Вкажіть двобуквений код за стандартом ISO 639-1 alpha-2. |
isbn | Номер ISBN-13 видання. Якщо у вас є номер ISBN-10, перетворіть його у формат ISBN-13. |
potential | Дія, яку користувачі виконують з книгою, — покупка або завантаження. Детальніше: |
| Рекомендовані властивості | |
|---|---|
author |
Автори видання. |
book | Інформація про видання книги у довільному форматі, наприклад |
date | Дата публікації видання у форматі РРРР-ММ-ДД або РРРР. Можна вказати точну дату або тільки рік. |
identifier | Зовнішній або інший ідентифікатор, що дозволяє точно ідентифікувати видання. Ідентифікаторів може бути кілька. Детальніше: Ця властивість може повторюватися. |
name | Назва видання. Використовуйте цю властивість, тільки якщо назва видання відрізняється від назви твору. |
same | URL вебсторінки з детальною інформацією, яка дозволяє однозначно ідентифікувати видання. Наприклад, сторінка з описом цього видання у Вікіпедії. Не використовуйте повторно властивість |
url | URL сторінки з презентацією або описом видання на вашому сайті. Значення цієї властивості може збігатися зі значенням властивості |
Приклад Book (Edition):
"workExample": { "@type": "Book", "@id": "https://example.com/book/100", "inLanguage": "en", "isbn": "9787543321724", "bookEdition": "20 Anniversary Edition", "datePublished": "2000-02-26", "bookFormat": "https://schema.org/Hardcover", "potentialAction": {...} }
Приклад Book (Edition) з кількома властивостями workExample:
"workExample": [ { "@type": "Book", "@id": "https://example.com/book/200", "inLanguage": "zh", "isbn": "9787543321721", "bookEdition": "2nd Edition", "bookFormat": "https://schema.org/Hardcover", "potentialAction": {...} }, { "@type": "Book", "@id": "https://example.com/book/300", "inLanguage": "zh", "isbn": "9787543321722", "bookEdition": "1st Edition", "bookFormat": "https://schema.org/EBook", "potentialAction": {...} } ]
Елемент Person або Organization (author)
З використанням елемента Person або Organization задається властивість author.
| Обов’язкові властивості | |
|---|---|
@type | Повинно мати значення |
name | Ім’я людини або назва організації. |
| Рекомендовані властивості | |
|---|---|
same | URL вебсторінки з детальною інформацією, яка дозволяє однозначно ідентифікувати людину або організацію. Наприклад, це може бути сторінка у Вікіпедії. |
Приклад author:
"author": { "@type": "Person", "name": "William Shakespeare" }
Приклад з кількома властивостями author:
"author": [ { "@type": "Person", "name": "William Shakespeare" }, { "@type": "Person", "name": "Victor Hugo", "sameAs": "https://en.wikipedia.org/wiki/Victor_Hugo" } ]
Елемент PropertyValue (identifier)
Елемент PropertyValue використовується у властивості identifier елемента Edition.
| Обов’язкові властивості | |
|---|---|
@type | Має мати значення |
property | Тип ідентифікатора. Може приймати наступні значення (див. розділ Номер ISBN та інші підтримувані ідентифікатори):
|
value | Значення ідентифікатора. Зовнішній ідентифікатор, що дозволяє точно ідентифікувати видання. Із зовнішнього ідентифікатора слід видалити всі початкові нецифрові символи. |
Приклад identifier:
"identifier": { "@type": "PropertyValue", "propertyID": "OCLC_NUMBER", "value": "110123456" }
Приклад з кількома властивостями identifier:
"identifier": [ { "@type": "PropertyValue", "propertyID": "OCLC_NUMBER", "value": "110123456" }, { "@type": "PropertyValue", "propertyID": "LCCN", "value": "220123456" },{ "@type": "PropertyValue", "propertyID": "JP_E-CODE", "value": "12345678901234567890" }]
Приклад фіда Read Action Book у JSON-файлі
{ "@context": "https://schema.org", "@type": "DataFeed", "dataFeedElement": [ { "@context": "https://schema.org", "@type": "Book", "@id": "https://example.com/work/the_catcher_in_the_rye", "url": "https://example.com/work/the_catcher_in_the_rye", "name": "The Catcher in the Rye", "author": { "@type": "Person", "name": "J.D. Salinger" }, "sameAs": "https://en.wikipedia.org/wiki/The_Catcher_in_the_Rye", "workExample": [ { "@type": "Book", "@id": "https://example.com/edition/the_catcher_in_the_rye_paperback", "isbn": "9787543321724", "bookEdition": "Mass Market Paperback", "bookFormat": "https://schema.org/Paperback", "inLanguage": "en", "url": "https://example.com/edition/the_catcher_in_the_rye_paperback", "datePublished": "1991-05-01", "identifier": { "@type": "PropertyValue", "propertyID": "OCLC_NUMBER", "value": "1057320822" }, "potentialAction": { "@type": "ReadAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://example.com/store/9787543321724", "actionPlatform": [ "https://schema.org/DesktopWebPlatform", "https://schema.org/AndroidPlatform", "https://schema.org/IOSPlatform" ] }, "expectsAcceptanceOf": { "@type": "Offer", "category": "purchase", "price": 6.99, "priceCurrency": "USD", "availabilityStarts": "2020-01-01T11:0:00-04:00", "availabilityEnds": "2050-06-30T23:59:00-04:00", "eligibleRegion": { "@type": "Country", "name": "US" } } } }, { "@type": "Book", "@id": "https://example.com/edition/the_catcher_in_the_rye_hardcover", "isbn": "9780316769532", "bookEdition": "Hardcover", "bookFormat": "https://schema.org/Hardcover", "inLanguage": "en", "url": "https://example.com/edition/the_catcher_in_the_rye_hardcover", "datePublished": "1951-07-16", "potentialAction": { "@type": "ReadAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://example.com/store/9780316769532", "actionPlatform": [ "https://schema.org/DesktopWebPlatform", "https://schema.org/AndroidPlatform", "https://schema.org/IOSPlatform" ] }, "expectsAcceptanceOf": [ { "@type": "Offer", "category": "nologinrequired", "availabilityStarts": "2020-01-01T11:0:00-04:00", "availabilityEnds": "2050-06-30T23:59:00-04:00", "eligibleRegion": [ { "@type": "Country", "name": "US" }, { "@type": "Country", "name": "GB" } ] }, { "@type": "Offer", "category": "Subscription", "availabilityStarts": "2020-01-01T11:0:00-04:00", "availabilityEnds": "2050-06-30T23:59:00-04:00", "eligibleRegion": { "@type": "Country", "name": "IN" } } ] } } ] } ], "dateModified": "2018-09-10T13:58:26.892Z" }
Приклад фіда Borrow Action Book у JSON-файлі
{ "@context": "https://schema.org", "@type": "DataFeed", "dataFeedElement": [ { "@context": "https://schema.org", "@type": "Book", "@id": "https://example.com/work/the_catcher_in_the_rye", "url": "https://example.com/work/the_catcher_in_the_rye", "name": "The Catcher in the Rye", "author": { "@type": "Person", "name": "J.D. Salinger" }, "sameAs": "https://en.wikipedia.org/wiki/The_Catcher_in_the_Rye", "workExample": [ { "@type": "Book", "@id": "https://example.com/edition/the_catcher_in_the_rye_paperback", "isbn": "9787543321724", "bookEdition": "Mass Market Paperback", "bookFormat": "https://schema.org/Paperback", "inLanguage": "en", "url": "https://example.com/edition/the_catcher_in_the_rye_paperback", "datePublished": "1991-05-01", "identifier": { "@type": "PropertyValue", "propertyID": "OCLC_NUMBER", "value": "1057320822" }, "potentialAction": { "@type": "BorrowAction", "lender": { "@type": "LibrarySystem", "@id": "https://example.com/librarySystem/100" }, "target": { "@type": "EntryPoint", "urlTemplate": "https://example.com/borrow?bookId=170", "actionPlatform": [ "https://schema.org/DesktopWebPlatform", "https://schema.org/AndroidPlatform", "https://schema.org/IOSPlatform" ] } } }, { "@type": "Book", "@id": "https://example.com/edition/the_catcher_in_the_rye_hardcover", "isbn": "9780316769532", "bookEdition": "Hardcover", "bookFormat": "https://schema.org/Hardcover", "inLanguage": "en", "url": "https://example.com/edition/the_catcher_in_the_rye_hardcover", "datePublished": "1951-07-16", "potentialAction": { "@type": "BorrowAction", "lender": { "@type": "LibrarySystem", "@id": "https://example.com/librarySystem/100" }, "target": [ { "@type": "EntryPoint", "urlTemplate": "https://example.com/borrow?bookId=170", "actionPlatform": [ "https://schema.org/DesktopWebPlatform" ] }, { "@type": "EntryPoint", ` "urlTemplate": "https://example.com/mobile/borrow?bookId=170", "actionPlatform": [ "https://schema.org/AndroidPlatform", "https://schema.org/IOSPlatform" ] } ] } } ] } ], "dateModified": "2018-09-10T13:58:26.892Z" }
Елемент Read Action (potential Action)
Елемент ReadAction використовується у властивості potentialAction. В елементі ReadAction визначаються посилання на контент, які надають доступ до книги, продавець, у якого її можна купити, і критерії, яким повинні відповідати користувачі (реєстрація, вхід в обліковий запис, місцеположення або інші вимоги для доступу до книги).
| Обов’язкові властивості | |
|---|---|
@type | Має мати значення |
expects | Визначення критеріїв користувачів, які можуть отримати доступ до книги. Якщо вказано кілька властивостей Ця властивість може повторюватися. |
expects | Має мати значення |
expects | Тип властивості
|
expects | Країна, в якій діє пропозиція ( Ця властивість може повторюватися. |
expects | Має мати значення |
expects | Код країни у форматі ISO 3166-1 alpha-2. |
target | Специфікація посилання на контент з інформацією про підтримувану платформу. Щоб визначити різні посилання на контент для різних платформ, можна використовувати кілька властивостей Ця властивість може повторюватися. |
target. | Має мати значення |
target. | Платформи, для яких можна використовувати посилання на контент. Можливі значення:
Ця властивість може повторюватися. |
target. | Посилання, яке веде безпосередньо до вмісту на цільовій сторінці. |
| Рекомендовані властивості | |
|---|---|
expects | Час закінчення періоду доступності. За допомогою цієї властивості можна вказати точний час, до якого книга буде доступна користувачам. |
expects | Час початку періоду доступності. За допомогою цієї властивості можна вказати точний час, коли книга стане доступною для користувачів. |
expects | Ціна купівлі книги. Ця властивість є обов’язковою, якщо категорії ( |
expects | Валюта, у якій вказана ціна, у форматі з трьох літер ISO 4217. |
Приклад ReadAction:
"potentialAction": { "@type": "ReadAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://example.com/purchase?bookId=170", "actionPlatform": [ "https://schema.org/DesktopWebPlatform", "https://schema.org/AndroidPlatform", "https://schema.org/IOSPlatform" ] }, "expectsAcceptanceOf": { "@type": "Offer", "category": "purchase", "price": 9.99, "priceCurrency": "USD", "availabilityStarts": "2018-04-01T11:01:00-04:00", "availabilityEnds": "2018-06-30T23:59:00-04:00", "eligibleRegion": { "@type": "Country", "name": "US" } } }
Приклад ReadAction з кількома властивостями EntryPoint:
"potentialAction": { "@type": "ReadAction", "target": [ { "@type": "EntryPoint", "urlTemplate": "https://example.com/purchase?bookId=170", "actionPlatform": [ "https://schema.org/DesktopWebPlatform" ] }, { "@type": "EntryPoint", "urlTemplate": "https://example.com/mobile/purchase?bookId=170", "actionPlatform": [ "https://schema.org/AndroidPlatform", "https://schema.org/IOSPlatform" ] } ], "expectsAcceptanceOf": [ { "@type": "Offer", "category": "noLoginRequired", "availabilityStarts": "2018-04-01T11:01:00-04:00", "availabilityEnds": "2018-06-30T23:59:00-04:00", "eligibleRegion": [ { "@type": "Country", "name": "US" }, { "@type": "Country", "name": "GB" } ] }, { "@type": "Offer", "category": "Subscription", "availabilityStarts": "2018-04-01T11:01:00-04:00", "availabilityEnds": "2018-06-30T23:59:00-04:00", "eligibleRegion": { "@type": "Country", "name": "IN" } } ] }
Елемент Borrow Action (potential Action)
Елемент BorrowAction використовується у властивості potentialAction. В елементі BorrowAction визначаються посилання на контент, які надають доступ до книги, бібліотека, де її можна взяти, і критерії, яким повинні відповідати користувачі (реєстрація, вхід в обліковий запис, місцеположення або інші вимоги для доступу до книги).
| Обов’язкові властивості | |
|---|---|
@type | Має мати значення |
lender | Бібліотечна мережа, у якій можна отримати це видання. |
lender. | Ідентифікатор бібліотечної мережі |
lender. | Має мати значення |
target | Специфікація посилання на контент з інформацією про підтримувану платформу. Щоб встановити посилання на контент для різних платформ, використовуйте масив Ця властивість може повторюватися. |
target. | Має мати значення |
target. | Платформи, для яких можна використовувати посилання на контент. Можливі значення:
Ця властивість може повторюватися. |
target. | Посилання, яке веде безпосередньо до вмісту на цільовій сторінці. |
Приклад BorrowAction:
"potentialAction": { "@type": "BorrowAction", "lender": { "@type": "LibrarySystem", "@id": "https://example.com/librarySystem/100" }, "target": { "@type": "EntryPoint", "urlTemplate": "https://example.com/borrow?bookId=170", "actionPlatform": [ "https://schema.org/DesktopWebPlatform", "https://schema.org/AndroidPlatform", "https://schema.org/IOSPlatform" ] } }
Приклад BorrowAction з кількома властивостями EntryPoint:
"potentialAction": { "@type": "BorrowAction", "lender": { "@type": "LibrarySystem", "@id": "https://example.com/librarySystem/100" }, "target": [ { "@type": "EntryPoint", "urlTemplate": "https://example.com/borrow?bookId=170", "actionPlatform": [ "https://schema.org/DesktopWebPlatform" ] }, { "@type": "EntryPoint", ` "urlTemplate": "https://example.com/mobile/borrow?bookId=170", "actionPlatform": [ "https://schema.org/AndroidPlatform", "https://schema.org/IOSPlatform" ] } ] }
Елемент Library
Повне визначення елемента Library наведено на сторінці schema.org/Library. Однак вам достатньо ознайомитися з описаними нижче властивостями. Для кожної бібліотеки, включеної до фіду, необхідно вказати обов’язкові властивості. Крім того, ви можете задати рекомендовані властивості, щоб додати більше інформації про свій контент і підвищити зручність використання.
Цей елемент Library є елементом Library верхнього рівня. Це абстрактний конструкт, що складається з елемента LibrarySystem (бібліотечна мережа), який включає елементи Library (member) нижнього рівня, що відносяться до LibrarySystem.
Library і Book – це різні фіди. І якщо ви створюєте фід Library, його не слід змішувати з фідом Book. Детальніше про створення фідів…
Елемент LibrarySystem
Елемент LibrarySystem позначає мережу бібліотечних філій.
| Обов’язкові властивості | |
|---|---|
@context | Має мати значення |
@id | Унікальний ідентифікатор бібліотечної системи у форматі URL. Його не можна змінювати. Він інтерпретується як непрозорий рядок, тому вказувати робоче посилання необов’язково. Домен, зазначений в ідентифікаторі |
@type | Має мати значення |
additional | Додаткова властивість, яка позначає тип бібліотеки. |
additional | Має мати значення |
additional | Має мати значення |
additional | Тип бібліотеки. Можливі значення:
|
member | Філії бібліотечної мережі. |
name | Назва бібліотечної мережі, наприклад |
url | URL сторінки з презентацією або описом бібліотечної мережі. Це посилання допомагає Пошуку точно зіставити контент у фіді з контентом у базах даних Google. Для фактичних цільових сторінок у Пошуку Google використовується URL, вказаний у властивості |
Елемент Library (member)
Елемент Library (member) використовується у властивості member елемента LibrarySystem. Елемент Library (member) позначає один філіал бібліотечної мережі.
| Обов’язкові властивості | |
|---|---|
@id | Унікальний ідентифікатор бібліотечної філії у форматі URL. Його не можна змінювати. Він інтерпретується як непрозорий рядок, тому вказувати робоче посилання необов’язково. Домен, зазначений в ідентифікаторі |
@type | Має мати значення |
location | Поштова адреса філії бібліотеки. Деякі властивості можуть бути непридатними в тій чи іншій країні. Використовуйте всі властивості, які потрібні для адрес ваших бібліотек. Приклад для елемента { "@type": "Library", "@id": "https://example.com/library-branches/1001", "name": "Campbell Library", "location": { "@type": "PostalAddress", "streetAddress": "77 Harrison Ave", "addressLocality": "Campbell", "addressRegion": "CA", "postalCode": "95008", "addressCountry": "US" } } Приклад для елемента { "@type": "Library", "@id": "https://example.com/library-branches/1003", "name": "Tokyo Metropolitan Central Library", "location": { "@type": "PostalAddress", "streetAddress": "7-13-5 Minamiazabu, Minato City", "addressLocality": "Tokyo", "postalCode": "106-0047", "addressCountry": "JP" } } |
location. | Має мати значення |
location. | Код країни у форматі ISO 3166-1, наприклад |
location. | Населений пункт, наприклад |
location. | Регіон, область, штат тощо, наприклад |
location. | Поштовий індекс, наприклад |
location. | Поштова адреса, наприклад |
name | Назва філії бібліотеки. |
Приклад JSON-файлу з фідом Library System
{ "@context": "https://schema.org", "@type":"LibrarySystem", "@id":"https://example.com/library-systems/100", "name":"Santa Clara County Library District", "additionalProperty":[ { "@type":"PropertyValue", "name":"librarytype", "value":"public" } ], "member":[ { "@type":"Library", "@id":"https://example.com/library-branches/1001", "name":"Campbell Library", "location":{ "@type":"PostalAddress", "streetAddress":"77 Harrison Ave", "addressLocality":"Campbell", "addressRegion":"CA", "postalCode":"95008", "addressCountry":"US" } }, { "@type":"Library", "@id":"https://example.com/library-branches/1002", "name":"Gilroy Library", "location":{ "@type":"PostalAddress", "streetAddress":"350 W 6th St", "addressLocality":"Gilroy", "addressRegion":"CA", "postalCode":"95020", "addressCountry":"US" } } ] }