Uporządkowane dane dotyczące działań związanych z książkami (Book)

Działania związane z książkami sprawiają, że wyszukiwarka Google staje się miejscem odkrywania książek i autorów. Dzięki temu użytkownicy wyszukiwarki mogą szybko kupić lub wypożyczyć znalezione pozycje bezpośrednio z poziomu wyników wyszukiwania. Na przykład po wpisaniu Pajęczyna Szarloty użytkownik może zobaczyć wyniki, które umożliwiają kupienie lub wypożyczenie książki. Jeśli jesteś dostawcą książek, możesz przekazać do Google plik danych z opisanym tu schematem uporządkowanych danych. Zawarte w naszej specyfikacji elementy ReadAction umożliwiają użytkownikom kupienie książki, a BorrowAction – jej wypożyczenie.

Działania związane z czytaniem i działania związane z wypożyczaniem, które są zintegrowane z panelami, powodują wyświetlanie opcji zakupu lub wypożyczenia książki. Dzięki podanym przez Ciebie linkom działania związane z czytaniem i działania związane z wypożyczaniem odsyłają użytkowników bezpośrednio z panelu wiedzy i innych usług Google na stronę książki w Twojej witrynie lub aplikacji.

Kolejność dostawców w panelu wiedzy jest dostosowana indywidualnie do każdego użytkownika i może się zmieniać. Oznacza to, że użytkownicy widzą wyniki w różnej kolejności. Co więcej, kolejność dostawców wyświetlanych danemu użytkownikowi może się zmieniać za każdym razem. Na kolejność może wpłynąć wiele różnych czynników. Jeśli na przykład użytkownik kliknie w panelu wiedzy link danego dostawcy, jest bardziej prawdopodobne, że ten dostawca zostanie wyświetlony na wyższej pozycji. Kolejności nie można kontrolować.

Pierwsze kroki

Aby zaimplementować działania związane z książkami, musisz utworzyć plik danych zgodnie z definicjami typów uporządkowanych danych używanych w przypadku tych działań. Najpierw jednak zapoznaj się z tymi sekcjami:

• Wytyczne
• Tworzenie pliku danych
• Testowanie pliku danych za pomocą narzędzia do weryfikacji pliku danych
• Hostowanie pliku danych
• Przesyłanie pliku danych do sprawdzenia
• Aktualizowanie pliku danych według potrzeb

Wytyczne

Aby zadbać o prawidłowe wyświetlanie książek w wyszukiwarce, musisz znać podstawowe pojęcia i ważne szczegółowe informacje. Pamiętaj, że Twój plik danych musi być zgodny ze specyfikacją standardowego formatu.

Przestrzegaj ogólnych wytycznych dotyczących uporządkowanych danych i Podstawowych zasad wyszukiwania oraz tych wytycznych:

• Utwory i wydania
• Systemy bibliotek i ich oddziały
• ISBN i inne obsługiwane identyfikatory
• Linki

Utwory i wydania

W tej dokumentacji w odniesieniu do książek używamy 2 różnych terminów:

• Utwór: abstrakcyjna koncepcja książki. Atrybutami utworu są takie metadane jak tytuł, autor czy język oryginału.
• Wydanie: wszystkie istniejące egzemplarze książki pochodzące z jednego składu drukarskiego. Atrybutami wydania są takie metadane jak rok publikacji, nazwa wydania czy numer ISBN (międzynarodowy znormalizowany numer książki).

Na przykład Pajęczyna Szarloty to utwór, ale egzemplarze pochodzące z jakiegokolwiek składu drukarskiego to wydanie. Utwór Pajęczyna Szarloty może być dostępny jako wydanie 1, wydanie 2, wydanie skrócone, wydanie w tłumaczeniu na język francuski itd.

To rozróżnienie jest szczególnie ważne w przypadku pliku danych, w którym może nie być to oczywiste. Istnieją 2 elementy Book:

• Book (Work) jest elementem Book najwyższego poziomu:
  • workExample to właściwość elementu Work, która określa tylko 1 wystąpienie Book (Edition).
  • W przypadku każdego elementu Work musi zostać podana co najmniej 1 właściwość workExample.
• Book (Edition) jest elementem Book niższego poziomu.

Warto pamiętać, że utwór może mieć wiele wydań. Zalecamy, by w miarę możliwości je grupować. Dzięki temu systemy Google mogą wykorzystać wszystkie istotne informacje o książce i wyświetlić je w wyszukiwarce. Jeśli to konieczne, możesz podzielić wydania na kilka rekordów utworu, ale każdy z nich musi zawierać:

• inną właściwość @id,
• co najmniej 1 wydanie z numerem ISBN lub innym obsługiwanym identyfikatorem.

Systemy bibliotek i ich oddziały

Library entity to typ elementu Library najwyższego poziomu. Jest to abstrakcyjny konstrukt, który składa się z elementu LibrarySystem i każdego elementu Library (member) niższego poziomu danego systemu bibliotek.

Element LibrarySystem jest abstrakcyjny i odpowiada wspólnej sieci oddziałów biblioteki. Na przykład Miejska Biblioteka Publiczna we Wrocławiu może zostać określona jako element LibrarySystem. Według strony wrocławskiej biblioteki miejskiej jest to system bibliotek publicznych działający we Wrocławiu, stolicy Dolnego Śląska. Składa się on z 40 filii lub oddziałów.

Każdy element LibrarySystem musi zawierać co najmniej 1 element Library (member), nawet jeśli w rzeczywistości biblioteka nie jest częścią żadnego systemu bibliotek. W takiej sytuacji, aby umożliwić implementację działań związanych z książkami, biblioteka jest jedynym oddziałem własnego systemu. Na potrzeby implementacji działań związanych z książkami oddział biblioteki, w przeciwieństwie do jej systemu, nie jest abstrakcyjny i ma konkretny adres.

I na odwrót – każdy element Library (member) musi należeć do co najmniej 1 elementu LibrarySystem.

ISBN i inne obsługiwane identyfikatory

ISBN to główny sygnał uzgodnienia otrzymywany, gdy wyszukiwarka Google dopasuje dane z pliku danych do danych Google. Musisz podać numer ISBN lub inny obsługiwany identyfikator w przypadku wszystkich książek, które mają się wyświetlać w wynikach wyszukiwania. Jeśli tego nie zrobisz, prawdopodobnie nie uda się dopasować i w konsekwencji wyświetlić Twoich książek.

Preferowanym przez wyszukiwarkę Google numerem jest ISBN-13, ale możesz też podać:

• numer OCLC (Online Computer Library Center),
• numer LCCN (Library of Congress Control Number),
• e-kod JP.

Linki

Aby użytkownicy mogli łatwo znaleźć Twoje książki, zadbaj o to, by linki w pliku danych były zgodne z tymi wytycznymi:

• Jeśli masz zduplikowane strony zawierające te same treści, pamiętaj, by użyć kanonicznego adresu URL z tytułem książki i innymi informacjami o niej.
• Po kliknięciu linku działania związanego z czytaniem lub działania związanego z wypożyczaniem użytkownik powinien trafić na stronę, która umożliwia bezpośredni zakup lub wypożyczenie książki. Linki działań nie mogą wskazywać stron z kolejnymi linkami, które trzeba kliknąć, by kupić lub wypożyczyć daną treść. Nie należy na przykład przekierowywać użytkowników na stronę wyników wyszukiwania ani stronę z podsumowaniem wiadomości o produkcie.

Tworzenie pliku danych

Jeśli w swojej witrynie sprzedajesz książki, musisz przesłać plik danych Book. Skontaktuj się z przedstawicielem Google i dowiedz się, jak i na jaki adres przesłać plik danych.

Jeśli w swojej witrynie wypożyczasz książki, musisz przesłać 2 osobne pliki danych: Book i Library. Skontaktuj się z przedstawicielem Google i dowiedz się, jak i na jaki adres przesłać pliki danych.

Przestrzegaj wymagań dotyczących rozmiaru, ilości i formatu pliku danych

Oto obowiązujące wymagania:

• Wymagania dotyczące rozmiaru pliku danych:
  • Rozmiar nieskompresowanego pliku danych nie może przekraczać 1 GB.
  • Oznacza to, że plik danych, który ma zostać skompresowany, musi być mniejszy niż 1 GB. Jeśli jest większy, musisz podzielić go na kilka mniejszych plików.
• Możesz skompresować pliki danych do formatu ZIP, GZ, TAR, TAR.GZ, JAR, AR, ARJ, CPIO lub innego formatu zrzutu archiwum.
• Jeśli masz kilka plików danych, możesz je przesłać w niezmienionej postaci lub dodać do pliku indeksu mapy witryny.
• Pojedyncze pliki danych muszą mieć rozszerzenie nazwy pliku .json.

Przestrzegaj wymagań dotyczących treści pliku danych

Zwróć szczególną uwagę na te wymagania dotyczące treści pliku danych:

• Plik danych nie może zawierać nieaktualnych elementów. Są to elementy, które nie są już dostępne w witrynie lub mają właściwość availabilityEnds ustawioną na datę z przeszłości.
• Wszystkie precyzyjne linki, takie jak urlTemplate, i wszystkie adresy URL, takie jak url, które uwzględniasz w pliku danych, muszą być produkcyjnymi wersjami adresów URL. Nie używaj nieprodukcyjnych adresów URL wykorzystywanych na przykład podczas kontroli jakości lub programowania.
• Wszystkie adresy URL, takie jak url, muszą być kanoniczne.
• Każdy element w pliku danych musi określać te właściwości:
  • unikalny identyfikator: @id,
  • unikalny adres URL: url,
  • unikalny precyzyjny link: urlTemplate.

Testowanie pliku danych za pomocą narzędzia do weryfikacji pliku danych

Zalecamy wykonanie opisanych poniżej czynności, by za pomocą narzędzia do weryfikacji pliku danych naprawić typowe błędy i zakończyć ostrzeżenia:

• Sprawdź, czy w polu Validate on: (Zweryfikuj) jest wybrana odpowiednia opcja. W przypadku elementu Book wybierz Książki .

• Sprawdź, czy wartość @type jest poprawnie zapisana.
• Sprawdź, czy wartość @context jest prawidłowo ustawiona. W przypadku ReadAction i BorrowAction ustaw "@context": "https://schema.org".

Hostowanie pliku danych

Gdy Twój plik danych będzie gotowy, umieść go w bezpiecznej lokalizacji. Google regularnie pobiera plik danych, by mieć pewność, że jego treść jest aktualna.

Metody hostowania

Oto obsługiwane metody hostowania pliku danych:

Przesyłanie pliku danych do sprawdzenia

Aby Twoje treści były dostępne w wyszukiwarce Google, zespół pomocy Google musi sprawdzić jakość precyzyjnych linków w Twoim pliku danych. Zdecydowanie zalecamy ręczne przetestowanie niektórych precyzyjnych linków. W ten sposób upewnisz się, czy rzeczywiście przekierowują na stronę, na której użytkownicy mogą kupować lub wypożyczać książki.

W swojej prośbie o sprawdzenie pliku danych podaj te informacje:

• Lokalizacja hosta: adres URL pliku danych.
• Uwierzytelnianie hosta (jeśli jest używane): dane uwierzytelniające, dzięki którym Google może pobrać plik danych z Twojej lokalizacji hosta.

Aktualizowanie pliku danych według potrzeb

Chociaż zalecamy codzienne aktualizowanie pliku danych, ostatecznie zależy to od tego, jak często zmienia się Twój katalog. Zapoznaj się z tymi uwagami i wskazówkami:

• Wyszukiwarka Google nie obsługuje aktualizacji w czasie rzeczywistym.
• Wyszukiwarka Google pobiera plik danych raz dziennie i zwykle indeksuje jego zawartość w ciągu 2 dni.
• Jeśli w dostępności wydania zachodzi dająca się przewidzieć zmiana, użyj właściwości availabilityStarts i availabilityEnds, aby ustawić dokładne daty. Jeśli element nie jest już dostępny, usuń go całkowicie.

Definicje typów uporządkowanych danych

Aby treści mogły się wyświetlać w uporządkowanych wynikach wyszukiwania, musisz w nich uwzględnić wymienione poniżej wymagane właściwości. Możesz też dodać właściwości zalecane, by wzbogacić informacje o treściach i zwiększyć w ten sposób wygodę użytkowników.

Element DataFeed

Każdy przesłany do Google plik danych schema.org musi zawierać 1 element DataFeed poziomu głównego. Wszystkie elementy Book i Library muszą być wymienione w polu dataFeedElement elementu DataFeed.

Właściwości obsługiwane przez Google:

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

Element Book

Pełną definicję elementów Book znajdziesz na schema.org/Book. Najważniejsze są jednak tylko poniższe właściwości. W przypadku każdej książki, którą chcesz uwzględnić w pliku danych, musisz określić wymagane właściwości. Możesz też zdefiniować właściwości zalecane, by wzbogacić informacje i zwiększyć w ten sposób wygodę użytkowników.

Book (Work)

Ten element Book jest typem elementu najwyższego poziomu. Odpowiada on utworowi.

Właściwości obsługiwane przez Google:

Book (Edition)

Właściwość workExample używa tego elementu Book. Odpowiada on wydaniu danego utworu.

Właściwości obsługiwane przez Google:

Przykładowy element 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": {...}
        }

Przykładowy element Book (Edition) z kilkoma właściwościami 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 lub Organization (author)

Właściwość author książki korzysta z elementu Person lub Organization.

Przykładowy element author:

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

Przykładowy element author z kilkoma właściwościami:

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

PropertyValue (identifier)

Właściwość identifier elementu Edition korzysta z elementu PropertyValue.

Przykładowy element identifier:

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

Przykładowy element identifier z kilkoma właściwościami:

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

Przykładowy plik danych ReadAction Book w formacie 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"
}

Przykładowy plik danych BorrowAction Book w formacie 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/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)

Właściwość potentialAction korzysta z elementu ReadAction. ReadAction określa precyzyjne linki umożliwiające dostęp do książki, a także sprzedawcę książki oraz kryteria, jakie muszą spełniać użytkownicy. Te kryteria mogą obejmować stan członkostwa, stan logowania, lokalizację lub inne informacje wymagane do uzyskania dostępu do książki.

Przykładowy element 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"
    }
  }
}

Przykładowy element ReadAction z kilkoma właściwościami 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)

Właściwość potentialAction korzysta z elementu BorrowAction. BorrowAction określa precyzyjne linki umożliwiające dostęp do książki, a także bibliotekę, w której znajduje się dana książka, oraz kryteria, jakie muszą spełniać użytkownicy. Te kryteria mogą obejmować stan członkostwa, stan logowania, lokalizację lub inne informacje wymagane do uzyskania dostępu do książki.

Przykładowy element 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"
    ]
  }
}

Przykładowy element BorrowAction z kilkoma właściwościami 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"
      ]
    }
  ]
}

Element Library

Pełną definicję elementów Library znajdziesz na schema.org/Library. Najważniejsze są jednak tylko poniższe właściwości. W przypadku każdej biblioteki, którą chcesz uwzględnić w pliku danych, musisz określić wymagane właściwości. Możesz też zdefiniować właściwości zalecane, by wzbogacić informacje i zwiększyć w ten sposób wygodę użytkowników.

Ten element Library jest typem elementu Library najwyższego poziomu. Jest to abstrakcyjny konstrukt, który składa się z elementu LibrarySystem i każdego elementu Library (member) niższego poziomu w ramach LibrarySystem.

Plik danych Library różni się od pliku danych Book. Dlatego każdy zaimplementowany plik danych Library musi być całkowicie niezależny od pliku danych Book. Więcej informacji znajdziesz w sekcji Tworzenie pliku danych.

LibrarySystem

Element LibrarySystem odpowiada wspólnej sieci oddziałów biblioteki.

Library (member)

Właściwość member elementu LibrarySystem korzysta z elementu Library (member). Library (member) odpowiada pojedynczemu oddziałowi danego systemu bibliotek.

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

Przykładowy plik danych LibrarySystem w formacie JSON

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