Strukturovaná data knih (BookActions)

Book Actions( Knihy) jsou vstupním bodem pro vyhledávání knih a autorů ve službě Google Search. Uživatelé vyhledávání tak mohou rychle nakupovat nebo si půjčovat nalezené knihy přímo z výsledků vyhledávání. Uživatel může například vyhledat knihu Šarlotina pavučinka a zobrazí se mu výsledky, které mu umožní knihu koupit nebo si ji vypůjčit. Jako poskytovatel knih můžete společnosti Google poskytnout zdroj dat pomocí zde uvedeného schématu strukturovaných dat. Specifikace poskytuje ReadAction, která umožňuje uživatelům knihu koupit, a BorrowAction, která umožňuje knihu vypůjčit.

★ Poznámka: Skutečný vzhled ve výsledcích vyhledávání se může lišit.

★ Poznámka: Aby bylo zajištěno robustní pokrytí a aby tato funkce lépe sloužil uživatelům vyhledávání, je v současné době omezena na poskytovatele knih s širokým výběrem dostupných knih. Pokud se chcete zapojit, zaregistrujte svůj zájem. Pokud projevíte zájem o tuto funkci, nezaručuje to vaši účast.

Akce čtení a akce výpůjčky, které jsou součástí panelů, zobrazují možnosti nákupu nebo výpůjčky knihy. Prostřednictvím odkazů, které poskytnete, akce na čtení a akce na výpůjčku posílají uživatele přímo ze znalostního panelu a dalších ploch Google na stránku s knihou na vašem webu nebo v aplikaci.

Pořadí poskytovatelů na znalostním panelu je personalizované a dynamické pro každého uživatele. To znamená, že různí uživatelé vidí různá pořadí a stejný uživatel může vidět různá pořadí v různých časech. Na dané pořadí má vliv celá řada faktorů. Například pokud uživatel často kliká na daný odkaz poskytovatele na panelu znalostí, je pravděpodobnější, že se tento poskytovatel umístí v pořadí výše. Pořadí nelze nijak ovlivnit.

Začněte

Chcete-li úspěšně implementovat akce Book, musíte vytvořit svůj kanál v souladu s definicemi strukturovaných datových typů akcí Book, ale nejprve si prostudujte následující části:

• Pokyny
• Vytvoření kanálu
• Otestujte svůj kanál pomocí nástroje pro ověřování datových kanálů
• Hostování souboru zdroje
• Odeslání souboru feedu ke kontrole
• V případě potřeby aktualizujte svůj kanál

Pokyny

Chcete-li zajistit, aby se vaše knihy spolehlivě objevily ve vyhledávání, je důležité, abyste znali některé důležité podrobnosti a klíčové pojmy. Dále musí váš zdroj splňovat některé standardizované specifikace formátu.

K tomu vám pomohou pokyny popsané zde, které doplňují obecné pokyny pro strukturovaná data a základní pokyny pro vyhledávání. Tyto pokyny jsou následující:

• Díla a edice
• Knihovní systémy a členové knihoven
• ISBN a další podporované identifikátory
• Odkazy

Díla a edice

V této dokumentaci používáme dva různé termíny, když mluvíme o knize:

• Dílo: Abstraktní pojem knihy. Konkrétně metadata, jako je název, autor a jazyk originálu, jsou atributy díla.
• Vydání: Konkrétní výtisk knihy. Konkrétně jsou atributy edice metadata, jako je rok vydání, název edice a mezinárodní standardní číslo knihy (ISBN).

Například Šarlotina pavučinka je dílo, ale každá jeho varianta je vydání. V tomto případě může mít dílo Šarlotina pavučinka první vydání, druhé vydání, zkrácené vydání, vydání francouzského překladu atd.

Toto rozlišení je důležité zejména ve feedu, kde nemusí být hned zřejmé. Existují dvě entity Kniha:

• Kniha (dílo – work) je entita Kniha “nejvyšší úrovně”:
  • workExample je vlastnost Díla a určuje jednu a pouze jednu instanci Knihy (vydání).
  • Pro každé Dílo musí existovat alespoň jeden workExample.
• Kniha (vydání- edition) je entita Book “nižší úrovně”.

Pomáhá si uvědomit, že může existovat více edic díla. Doporučujeme tato vydání co nejvíce seskupovat. To pomáhá systémům Google využít všechny relevantní informace o knize a zobrazit je ve vyhledávání. Pokud musíte, můžete je rozdělit do více záznamů o díle, ale každý záznam o díle musí mít následující údaje:

• Jiné @id.
• Alespoň jedno vydání s ISBN nebo jiným podporovaným identifikátorem.

Knihovní systémy a členové knihoven

★ Poznámka: Tento oddíl se týká poskytovatelů, kteří půjčují knihy.

Entita Knihovna je “nejvyšší úrovní” typu entity Knihovna. Je to abstraktní konstrukce, která se skládá z entity SytémKnihoven (LibrarySystem) a každé “nižší úrovně” entity Knihovna – člen (Library – member) tohoto knihovního systému.

Entita LibrarySystem je abstrakcí a představuje kooperativní síť členů knihovny. Například veřejnou knihovnu Austin Public Library lze zadat jako entitu LibrarySystem. Webové stránky Austin Public Library se popisují jako systém veřejných knihoven, který slouží Austinu v Texasu. Skládá se z 20 přidružených knihoven neboli členů knihovny.

Každá entita LibrarySystem vyžaduje alespoň jednu entitu Library (member), i když ve skutečnosti knihovna není součástí žádného knihovního systému. V tomto scénáři je pro účely implementace BookAction (akce Kniha) knihovna jediným členem svého vlastního knihovního systému. Pro účely implementace akce Kniha není na rozdíl od knihovního systému člen knihovny abstrakcí, a má tedy fyzickou adresu.

Naopak každá entita Knihovna (člen) musí patřit alespoň jedné entitě LibrarySystem.

ISBN a další podporované identifikátory

ISBN je hlavním usmiřovacím signálem, když vyhledávač Google porovnává vaše údaje s údaji společnosti Google. Musíte zadat ISBN nebo jiný podporovaný identifikátor pro všechny knihy, které chcete mít zobrazeny ve výsledcích vyhledávání. Bez něj je pravděpodobné, že vaše knihy nebude možné porovnat, a proto nebudou zobrazeny.

Vyhledávač Google upřednostňuje ISBN-13, ale alternativně můžete uvést následující údaje:

• Číslo Online Computer Library Center (OCLC)
• Kontrolní číslo Kongresové knihovny (LCCN)
• JP e-code

❗Varování: Vyhledávač Google neakceptuje ISBN-10. U knih, které obsahují pouze údaje ISBN-10, použijte nástroj pro převod ISBN na ISBN-13 před odesláním kanálu společnosti Google.

★ Poznámka: Pokud jde o knihy bez ISBN, můžete je stále uvést ve feedu. Uživatelům se však nemusí zobrazit ve vyhledávači Google. Následující postupy by však mohly usnadnit správné přiřazení:

• Všechny entity edice seskupte pod stejné dílo a zajistěte, aby alespoň jedna z edic měla ISBN, číslo OCLC, LCCN nebo elektronický kód JP. Vyhledávač Google může být schopen využít dostupné ISBN nebo jiný podporovaný identifikátor z jiné edice.
• Přidejte identifikátory třetích stran. Služba Google Search v současné době podporuje dvě široce používaná kontrolní čísla knihoven: OCLC Number nebo LCCN. Pokud máte některé z nich, uveďte je.

Odkazy

Abyste zajistili, že lidé vaše knihy najdou co nejlépe, musí odkazy ve vašem kanálu dodržovat následující pokyny:

• Pokud máte duplicitní stránky se stejným obsahem, musí být odkazem kanonická adresa URL, která obsahuje název knihy a další informace o knize.
• Poté, co uživatel klikne na odkaz přečtení nebo výpůjčky, musí být uživatel přesměrován na stránku, která přímo podporuje nákup nebo výpůjčku knihy. Konkrétně nesměřujte “akční” odkazy na stránky s více odkazy, na které je nutné kliknout, abyste si mohli obsah zakoupit nebo vypůjčit. Neposílejte například lidi na stránku s výsledky vyhledávání nebo na stránku se souhrnem produktů.

Vytvoření kanálu

Pokud vaše stránky prodávají knihy, které si uživatelé mohou koupit, musíte nahrát svůj knižní kanál. Obraťte se na zástupce společnosti Google a ověřte si podrobnosti o tom, jak a kam nahrát svůj kanál.

Pokud vaše stránky půjčují knihy uživatelům k vypůjčení, musíte nahrát dva samostatné kanály: kanál Knihy a kanál Knihovna. Obraťte se na zástupce společnosti Google a ověřte si podrobnosti o tom, jak a kam nahrát svůj kanál.

Dodržujte požadavky na velikost, množství a formát souborů feedu.

Požadavky jsou následující:

• Požadavky na velikost souboru feedu:
  • Velikost nekomprimovaného souboru feedu musí být menší než 1 GB.
  • Soubor feedu, který má být komprimován, musí mít velikost menší než 1 GB. Pokud nekomprimovaný soubor feedu přesahuje 1 GB, musíte nekomprimovaný soubor feedu rozdělit do více souborů.
• Soubory feedu můžete komprimovat. Musí být naformátovány do archivního souboru typu zip, gz, tar, tar.gz, JAR, ar, arj, cpio nebo dump.
• Pokud máte více souborů feedu, můžete je nahrát tak, jak jsou, nebo pokud chcete, můžete je zahrnout jako součást indexového souboru mapy webu.
• Jednotlivé soubory feedu musí mít příponu .json.

Dodržování požadavků na obsah feedu

Dbejte zejména na následující požadavky na obsah feedu, které musíte dodržovat:

• Feed nesmí obsahovat neaktuální entity. Neaktuální entity jsou entity s nastavením availabilityEnds na datum, které již uplynulo, nebo entity, které již nejsou na vašem webu dostupné.
• Všechny hluboké odkazy, například urlTemplate, a všechny adresy URL, například url, které do feedu zahrnete, musí být produkční adresy URL. Nepoužívejte QA, vývojové ani žádný jiný typ neprodukčních URL.
• Všechny adresy URL, například url, musí být kanonické.
• Každá entita ve vašem kanálu musí mít uvedeny následující vlastnosti:
  • Jedinečné ID: @id
  • Jedinečnou adresu URL: url
  • Jedinečný hluboký odkaz: urlTemplate

Otestujte svůj kanál pomocí nástroje pro ověřování datových kanálů

Pro řešení běžných chyb a varování v nástroji pro ověřování datových kanálů doporučujeme následující kroky:

• Ujistěte se, že máte v poli Validate on vybranou správnou možnost. Pro entitu Kniha vyberte možnost Book Action (Akce Knihy).
• Zkontrolujte, zda je hodnota @type napsána správně.
• Zkontrolujte, zda je správně nastavena hodnota @context. Nastavte hodnotu “@context”: “https://schema.org” pro ReadAction i BorrowAction.

Hostování souboru zdroje

Až bude váš soubor s informacemi připraven, umístěte jej na zabezpečené místo. Google pravidelně načítá soubor feedu, aby zajistil aktuálnost vašeho obsahu.

Způsoby hostování

Podporovány jsou následující metody hostování feedů:

Odeslání souboru feedu ke kontrole

Aby byl váš obsah dostupný ve vyhledávači Google, tým podpory Google přezkoumá kvalitu hlubokých odkazů ve vašem feedu. Důrazně doporučujeme, abyste některé z hlubokých odkazů ručně otestovali a potvrdili, zda otevírají stránku, kde si uživatelé mohou knihy koupit nebo vypůjčit.

★ Poznámka: Úspěšné použití této funkce spolu s formulářem, který musíte použít k odeslání svého kanálu, je omezeno na partnery.

Chcete-li požádat o přezkoumání svého kanálu, uveďte následující údaje:

• Místo hostitele: Adresa URL souboru s vaším feedem.
• Ověření hostitele, pokud je to relevantní: Ověřovací údaje, které společnosti Google umožní získat soubor feedu z vašeho hostitelského umístění.

V případě potřeby aktualizujte svůj kanál

Doporučujeme, abyste svůj kanál aktualizovali denně, ale v konečném důsledku to závisí na tom, jak často se váš katalog mění. Mějte na paměti následující podmínky a tipy:

• Vyhledávač Google nepodporuje aktualizace v reálném čase.
• Vyhledávač Google načítá váš kanál jednou denně a obvykle indexuje obsah do dvou dnů.
• Pokud se dá předvídat změna dostupnosti edice, použijte availabilityStarts a availabilityEnds k nastavení přesných dat. Pokud již entita není dostupná, odstraňte ji úplně

Definice strukturovaných datových typů

Aby byl váš obsah způsobilý pro zobrazení ve strukturovaných výsledcích vyhledávání, musíte zahrnout požadované vlastnosti uvedené zde. Můžete také zahrnout doporučené vlastnosti, abyste přidali více informací o svém obsahu, což může poskytnout lepší uživatelský zážitek.

Entita DataFeed

Každý soubor s datovým kanálem schema.org dodaný společnosti Google musí obsahovat jednu entitu DataFeed na kořenové úrovni. Všechny entity Book a Library musí být uvedeny v poli dataFeedElement entity DataFeed.

Vlastnosti podporované společností Google jsou následující:

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

Knižní subjekt (Book entity)

Úplná definice entity Book je k dispozici na adrese schema.org/Book, stačí však vzít v úvahu pouze následující vlastnosti. Požadované vlastnosti musíte definovat pro každou knihu, kterou se rozhodnete zahrnout do svého feedu. Můžete také definovat doporučené vlastnosti, které přidají více informací o obsahu, což může zajistit lepší uživatelský komfort.

Kniha (dílo)

Tato entita Book je typem entity nejvyšší úrovně. Představuje dílo.

💡Klíčový bod: Přečtěte si pokyny pro práce a edice, abyste pochopili rozdíl mezi oběma entitami knihy ve vaší implementaci.

Vlastnosti podporované společností Google jsou následující:

Kniha (vydání)

Vlastnost workExample používá tuto entitu Book. Představuje vydání díla.

💡Klíčový bod: Přečtěte si pokyny pro práci a edice, abyste pochopili rozdíl mezi oběma entitami Book ve vaší implementaci.

Vlastnosti podporované společností Google jsou následující:

Příklad knihy (vydání):

"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": {...}
        }

Příklad knihy (vydání) s více vlastnostmi 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": {...}
      }
 ]

Osoba nebo organizace (autor)

Vlastnost autor knihy používá entitu Osoba nebo Organizace.

Příklad autora:

"author": {
  "@type": "Person",
  "name": "William Shakespeare"
}

Příklad s více vlastnostmi autora:

"author": [
  {
    "@type": "Person",
    "name": "William Shakespeare"
  },
  {
    "@type": "Person",
    "name": "Victor Hugo",
    "sameAs": "https://en.wikipedia.org/wiki/Victor_Hugo"
  }
]

PropertyValue (identifikátor)

Vlastnost Identifier edice používá entitu PropertyValue.

Příklad identifikátoru:

 "identifier": {
      "@type": "PropertyValue",
      "propertyID": "OCLC_NUMBER",
      "value":  "110123456"
    }

Příklad s více vlastnostmi “identifikátor”:

 "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "OCLC_NUMBER",
      "value":  "110123456"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "LCCN",
      "value":  "220123456"
    },{
      "@type": "PropertyValue",
      "propertyID": "JP_E-CODE",
      "value":  "12345678901234567890"
    }]

Příklad souboru JSON ReadAction Book feed

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

Příklad souboru JSON BorrowAction Book feed

{
  "@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/borrowpurchase?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/borrowpurchase?bookId=170",
                "actionPlatform": [
                  "https://schema.org/DesktopWebPlatform"
                ]
              },
              {
                "@type": "EntryPoint",
                "urlTemplate": "https://example.com/mobile/borrowpurchase?bookId=170",
                "actionPlatform": [
                  "https://schema.org/AndroidPlatform",
                  "https://schema.org/IOSPlatform"
                ]
              }
            ]
          }
        }
      ]
    }
  ],
  "dateModified": "2018-09-10T13:58:26.892Z"
}

ReadAction (potentialAction)

Vlastnost potentialAction používá entitu ReadAction. ReadAction definuje vaše hluboké odkazy pro přístup ke knize, maloobchodníka, který knihu skladuje, a kritéria, která musí uživatelé splnit. Kritéria mohou zahrnovat stav členství, stav přihlášení, umístění nebo cokoli jiného, co je nutné pro přístup ke knize.

Příklad 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"
    }
  }
}

Příklad ReadAction s více vlastnostmi 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)

Vlastnost potentialAction používá entitu BorrowAction. BorrowAction definuje vaše hluboké odkazy pro přístup ke knize, knihovnu, která knihu skladuje, a kritéria, která musí uživatelé splňovat. Kritéria mohou zahrnovat stav členství, stav přihlášení, umístění nebo cokoli jiného, co je nutné pro přístup ke knize.

Příklad 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"
    ]
  }
}

Příklad BorrowAction s více vlastnostmi 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"
      ]
    }
  ]
}

Subjekt knihovny

Úplná definice entity Library je k dispozici na adrese schema.org/Library, stačí však vzít v úvahu pouze následující vlastnosti. Požadované vlastnosti musíte definovat pro každou knihovnu, kterou se rozhodnete zahrnout do svého kanálu. Můžete také definovat doporučené vlastnosti, které přidají více informací o obsahu, což může zajistit lepší uživatelské prostředí.

Tato entita Knihovna je nejvyšší úrovní entity typu Knihovna. Jedná se o abstraktní konstrukci, která se skládá z entity LibrarySystem (KnihovnaSystém) a každé nižší úrovně entity Library – member (Knihovna – člen) této LibrarySystem.

Subjekt Library se liší od subjektu Book. Proto musí být jakýkoli feed Library, který můžete implementovat, zcela oddělen od feedu Book. Další informace naleznete v části Vytvoření feedu.

💡Klíčový bod: Přečtěte si pokyny pro knihovní systémy a členy knihovny, abyste pochopili rozdíl mezi entitou nejvyšší úrovně Library, entitou LibrarySystem a entitou nižší úrovně Library ve vaší implementaci.

LibrarySystem

Entita LibrarySystem představuje kooperativní síť členů knihovny.

💡Klíčový bod: Přečtěte si pokyny pro knihovní systémy a členy knihovny, abyste pochopili rozdíl mezi entitou nejvyšší úrovně Library, entitou LibrarySystem a entitou nižší úrovně Library ve vaší implementaci.

Knihovna (člen)

Vlastnost member (člen) entity LibrarySystem (KnihovnaSystém) používá entitu Library (member). Library (member) reprezentuje jednoho člena knihovny daného knihovního systému.

💡Klíčový bod: Přečtěte si pokyny k systému knihoven a členům knihoven, abyste pochopili rozdíl mezi entitou nejvyšší úrovně Library, entitou LibrarySystem a entitou nižší úrovně Library ve vaší implementaci.

{
  "@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": "７-13-5 Minamiazabu, Minato City",
    "addressLocality": "Tokyo",
    "postalCode": "106-0047",
    "addressCountry": "JP"
  }
}

Příklad souboru JSON feedu LibrarySystem

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

Překlad, odborná a obsahová korektura: SEOPRAKTICKY.CZ

Použité zdroje

1. Book Schema for Google Search | Google Search Central | Documentation | Google for Developers. (n.d.). Google for Developers. [online]. Dostupné z: https://developers.google.com/search/docs/appearance/structured-data/book