Структуровані дані для дій, пов’язаних з книгами (Book)

Користувачі можуть шукати в 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 — це основна ознака, яка використовується, коли Пошук зіставляє дані фіду з даними 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. Якщо елемент недоступний, його необхідно видалити.

Щоб контент міг з’явитися в структурованих результатах пошуку, необхідно встановити всі зазначені тут обов’язкові властивості. Ви також можете додати рекомендовані властивості, щоб користувачі отримували більше корисної інформації.

Кожен файл із фідом даних schema.org, переданий у Google, повинен містити єдиний елемент DataFeed на кореневому рівні. Усі елементи Book та Library повинні бути перелічені в полі dataFeedElement елемента DataFeed.

Google підтримує наступні властивості:

Обов’язкові властивості
@context

Text

Має мати значення https://schema.org.

@type

Text

Має мати значення DataFeed.

dataFeedElement

Book або LibrarySystem

Повинні мати як значення один елемент Book або LibrarySystem. Також як значення можна використовувати масив, що складається тільки з елементів Book або тільки з елементів LibrarySystem. Не використовуйте масиви, в яких є і елементи Book, і елементи LibrarySystem.

Приклад використання для фіду Book:

 
 
{
  "@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"
}

Приклад використання для фіду LibrarySystem:

 
 
{
  "@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"
}
dateModified

DateTime

Дата і час останнього оновлення фіду у форматі ISO 8601.

Повне визначення елемента Book наведено на сторінці schema.org/Book. Однак вам достатньо ознайомитися з описаними нижче властивостями. Для кожної книги, включеної до фіду, необхідно вказати обов’язкові властивості. Ви також можете задати рекомендовані властивості, щоб користувачі отримували більше корисної інформації.

Цей елемент Book відноситься до верхнього рівня розмітки і відповідає твору.

Google підтримує наступні властивості:

Обов’язкові властивості
@context

Text

Має мати значення https://schema.org.

@id

Text

Унікальний ідентифікатор книги у форматі URL. Цей ідентифікатор не повинен повторюватися в межах вашої організації. Його не можна змінювати. Використання формату URL — рекомендація, а не вимога. Це не обов’язково має бути робоче посилання, але домен, зазначений в ідентифікаторі @id, повинен належати вашій організації.

@type

Text

Має мати значення Book.

author

Person або Organization

Автори книги.

name

Text

Назва книги.

url

URL

URL сторінки з презентацією або описом книги на вашому сайті. Це посилання допомагає точно зіставити контент у фіді з контентом у базах даних Google. Значення цієї властивості може збігатися зі значенням властивості workExample.target.urlTemplate.

Для фактичних цільових сторінок у Пошуку Google використовується URL, зазначений у властивості workExample.target.urlTemplate.

workExample

Book (Edition)

Видання твору.

Рекомендовані властивості
sameAs

URL

URL сторінки з інформацією, що ідентифікує твір. Це може бути сторінка книги у Вікіпедії, Вікіданих, Віртуальному каталозі міжнародного нормативного контролю інформації про твори та їх авторів (VIAF) або на сайті Бібліотеки Конгресу.

Цей елемент Book використовується у властивості workExample і позначає видання твору.

Google підтримує наступні властивості:

Обов’язкові властивості
@id

Text

Унікальний ідентифікатор книги у форматі URL. Цей ідентифікатор не повинен повторюватися в межах вашої організації. Його не можна змінювати. Використання формату URL — рекомендація, а не вимога. Це не обов’язково має бути робоче посилання, але домен, зазначений в ідентифікаторі @id, повинен належати вашій організації.

@type

Text

Має мати значення Book.

bookFormat

Enum

Формат видання. Можливі значення:

  • https://schema.org/AudiobookFormat
  • https://schema.org/EBook
  • https://schema.org/Hardcover
  • https://schema.org/Paperback
inLanguage

Text

Основна мова видання. Вкажіть двобуквений код за стандартом ISO 639-1 alpha-2.

isbn

Text

Номер ISBN-13 видання. Якщо у вас є номер ISBN-10, перетворіть його у формат ISBN-13.

potentialAction

ReadAction або BorrowAction

Дія, яку користувачі виконують з книгою, — покупка або завантаження. Детальніше: ReadAction, BorrowAction.

Рекомендовані властивості
author

Person або Organization

Автори видання.

bookEdition

Text

Інформація про видання книги у довільному форматі, наприклад 2nd Edition (2-ге видання).

datePublished

Date

Дата публікації видання у форматі РРРР-ММ-ДД або РРРР. Можна вказати точну дату або тільки рік.

identifier

PropertyValue

Зовнішній або інший ідентифікатор, що дозволяє точно ідентифікувати видання. Ідентифікаторів може бути кілька. Детальніше: PropertyValue (identifier).

Ця властивість може повторюватися.

name

Text

Назва видання. Використовуйте цю властивість, тільки якщо назва видання відрізняється від назви твору.

sameAs

URL

URL вебсторінки з детальною інформацією, яка дозволяє однозначно ідентифікувати видання. Наприклад, сторінка з описом цього видання у Вікіпедії. Не використовуйте повторно властивість sameAs елемента Work.

url

URL

URL сторінки з презентацією або описом видання на вашому сайті. Значення цієї властивості може збігатися зі значенням властивості workExample.target.urlTemplate.

Приклад 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.

Обов’язкові властивості
@type

Text

Повинно мати значення Person або Organization.

name

Text

Ім’я людини або назва організації.

Рекомендовані властивості
sameAs

URL

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 елемента Edition.

Обов’язкові властивості
@type

Text

Має мати значення PropertyValue.

propertyID

Text

Тип ідентифікатора. Може приймати наступні значення (див. розділ Номер ISBN та інші підтримувані ідентифікатори):

  • OCLC_NUMBER
  • LCCN
  • JP_E-CODE
value

Text

Значення ідентифікатора. Зовнішній ідентифікатор, що дозволяє точно ідентифікувати видання. Із зовнішнього ідентифікатора слід видалити всі початкові нецифрові символи.

Приклад 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"
    }]
 
 
{
  "@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"
}
 
 
{
  "@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"
}

Елемент ReadAction використовується у властивості potentialAction. В елементі ReadAction визначаються посилання на контент, які надають доступ до книги, продавець, у якого її можна купити, і критерії, яким повинні відповідати користувачі (реєстрація, вхід в обліковий запис, місцеположення або інші вимоги для доступу до книги).

Обов’язкові властивості
@type

Text

Має мати значення ReadAction.

expectsAcceptanceOf

Offer

Визначення критеріїв користувачів, які можуть отримати доступ до книги. Якщо вказано кілька властивостей Offer, то доступ до контенту може отримати користувач, який відповідає будь-якому з критеріїв Offer.

Ця властивість може повторюватися.

expectsAcceptanceOf.@type

Text

Має мати значення Offer.

expectsAcceptanceOf.category

Text

Тип властивості Offer. Можливі значення:

  • nologinrequired. Дія доступна користувачам без входу в обліковий запис або здійснення оплати.
  • free. Дія доступна лише користувачам, які увійшли в обліковий запис, але оплата або оформлення платної підписки не потрібні.
  • subscription. Книга стає доступною після оформлення платної підписки на ваші послуги.
  • purchase. Книгу можна тільки купити.
  • rental. Книга буде доступна протягом певного часу після оплати.
expectsAcceptanceOf.eligibleRegion

Country

Країна, в якій діє пропозиція (Offer). Ви можете вибрати регіон, в якому користувачі зможуть купити або прочитати книгу.

Ця властивість може повторюватися.

expectsAcceptanceOf.eligibleRegion.@type

Text

Має мати значення Country.

expectsAcceptanceOf.eligibleRegion.name

Text

Код країни у форматі ISO 3166-1 alpha-2.

target

EntryPoint

Специфікація посилання на контент з інформацією про підтримувану платформу. Щоб визначити різні посилання на контент для різних платформ, можна використовувати кілька властивостей EntryPoint.

Ця властивість може повторюватися.

target.@type

Text

Має мати значення EntryPoint.

target.actionPlatform

Text

Платформи, для яких можна використовувати посилання на контент. Можливі значення:

  • https://schema.org/DesktopWebPlatform
  • https://schema.org/AndroidPlatform
  • https://schema.org/IOSPlatform

Ця властивість може повторюватися.

target.urlTemplate

URL

Посилання, яке веде безпосередньо до вмісту на цільовій сторінці.

Рекомендовані властивості
expectsAcceptanceOf.availabilityEnds

DateTime

Час закінчення періоду доступності. За допомогою цієї властивості можна вказати точний час, до якого книга буде доступна користувачам.

expectsAcceptanceOf.availabilityStarts

DateTime

Час початку періоду доступності. За допомогою цієї властивості можна вказати точний час, коли книга стане доступною для користувачів.

expectsAcceptanceOf.price

Number

Ціна купівлі книги. Ця властивість є обов’язковою, якщо категорії (category) елемента Offer присвоєно значення purchase або rental.

expectsAcceptanceOf.priceCurrency

Text

Валюта, у якій вказана ціна, у форматі з трьох літер 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"
      }
    }
  ]
}

Елемент BorrowAction використовується у властивості potentialAction. В елементі BorrowAction визначаються посилання на контент, які надають доступ до книги, бібліотека, де її можна взяти, і критерії, яким повинні відповідати користувачі (реєстрація, вхід в обліковий запис, місцеположення або інші вимоги для доступу до книги).

Обов’язкові властивості
@type

Text

Має мати значення BorrowAction.

lender

LibrarySystem

Бібліотечна мережа, у якій можна отримати це видання.

lender.@id

URL

Ідентифікатор бібліотечної мережі LibrarySystem (її повний опис має бути наведено окремо, у фіді бібліотеки).

lender.@type

Text

Має мати значення LibrarySystem.

target

EntryPoint

Специфікація посилання на контент з інформацією про підтримувану платформу. Щоб встановити посилання на контент для різних платформ, використовуйте масив EntryPoint.

Ця властивість може повторюватися.

target.@type

Text

Має мати значення EntryPoint.

target.actionPlatform

Text

Платформи, для яких можна використовувати посилання на контент. Можливі значення:

  • https://schema.org/DesktopWebPlatform
  • https://schema.org/AndroidPlatform
  • https://schema.org/IOSPlatform

Ця властивість може повторюватися.

target.urlTemplate

URL

Посилання, яке веде безпосередньо до вмісту на цільовій сторінці.

Приклад 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 наведено на сторінці schema.org/Library. Однак вам достатньо ознайомитися з описаними нижче властивостями. Для кожної бібліотеки, включеної до фіду, необхідно вказати обов’язкові властивості. Крім того, ви можете задати рекомендовані властивості, щоб додати більше інформації про свій контент і підвищити зручність використання.

Цей елемент Library є елементом Library верхнього рівня. Це абстрактний конструкт, що складається з елемента LibrarySystem (бібліотечна мережа), який включає елементи Library (member) нижнього рівня, що відносяться до LibrarySystem.

Library і Book – це різні фіди. І якщо ви створюєте фід Library, його не слід змішувати з фідом Book. Детальніше про створення фідів

Елемент LibrarySystem позначає мережу бібліотечних філій.

Обов’язкові властивості
@context

Text

Має мати значення https://schema.org.

@id

URL

Унікальний ідентифікатор бібліотечної системи у форматі URL. Його не можна змінювати. Він інтерпретується як непрозорий рядок, тому вказувати робоче посилання необов’язково. Домен, зазначений в ідентифікаторі @id, повинен належати вашій організації.

@type

Text

Має мати значення LibrarySystem.

additionalProperty

PropertyValue

Додаткова властивість, яка позначає тип бібліотеки.

additionalProperty.@type

Text

Має мати значення PropertyValue.

additionalProperty.name

Text

Має мати значення librarytype.

additionalProperty.value

Text

Тип бібліотеки. Можливі значення:

  • public
  • academic
  • corporate
  • government
  • school
  • special
member

Library

Філії бібліотечної мережі.

name

Text

Назва бібліотечної мережі, наприклад The Southwestern League of Libraries.

url

URL

URL сторінки з презентацією або описом бібліотечної мережі. Це посилання допомагає Пошуку точно зіставити контент у фіді з контентом у базах даних Google. Для фактичних цільових сторінок у Пошуку Google використовується URL, вказаний у властивості workExample.target.urlTemplate.

Елемент Library (member) використовується у властивості member елемента LibrarySystem. Елемент Library (member) позначає один філіал бібліотечної мережі.

Обов’язкові властивості
@id

URL

Унікальний ідентифікатор бібліотечної філії у форматі URL. Його не можна змінювати. Він інтерпретується як непрозорий рядок, тому вказувати робоче посилання необов’язково. Домен, зазначений в ідентифікаторі @id, повинен належати вашій організації.

@type

Text

Має мати значення Library.

location

PostalAddress

Поштова адреса філії бібліотеки. Деякі властивості можуть бути непридатними в тій чи іншій країні. Використовуйте всі властивості, які потрібні для адрес ваших бібліотек.

Приклад для елемента 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"
  }
}

Приклад для елемента location в Японії:

 
 
{
  "@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.@type

Text

Має мати значення PostalAddress.

location.addressCountry

Text

Код країни у форматі ISO 3166-1, наприклад US.

location.addressLocality

Text

Населений пункт, наприклад Mountain View.

location.addressRegion

Text

Регіон, область, штат тощо, наприклад CA.

location.postalCode

Text

Поштовий індекс, наприклад 94043

location.streetAddress

Text

Поштова адреса, наприклад 1600 Amphitheatre Pkwy.

name

Text

Назва філії бібліотеки.

 
 
{
   "@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"
         }
      }
   ]
}