Kitap işlemleri (Book) yapılandırılmış verileri

Kitap işlemleri, Google Arama'yı, kitapları ve yazarları keşfetmek için bir giriş noktası haline getirir. Böylece, Arama kullanıcıları buldukları kitapları doğrudan arama sonuçlarından satın alabilir veya ödünç alabilir. Örneğin, Charlotte'un Sevgi Ağı'nı arayan bir kullanıcıya kitabı satın alma veya ödünç alma imkanı sunan sonuçlar gösterilebilir. Bir kitap sağlayıcısı olarak, buradaki yapılandırılmış veri şemasını kullanarak Google'a bir veri feed'i sağlayabilirsiniz. Spesifikasyonumuz, kullanıcılara kitap satın almak için ReadAction, kitap ödünç almak içinse BorrowAction işlemini sağlar.

Panellere dahil edilen okuma işlemleri ve ödünç işlemleri, kitabı satın alma veya ödünç alma seçeneklerini görüntüler. Sağladığınız bağlantılar yoluyla, okuma işlemleri ve ödünç alma işlemleri kullanıcıları bilgi panelinden ve diğer Google yüzeylerinden doğruca web sitenizdeki veya uygulamanızdaki bir kitap sayfasına gönderir.

Bilgi panelindeki sağlayıcıların sıralaması her kullanıcıya göre kişiselleştirilir ve dinamik olarak sunulur. Bu da farklı kullanıcıların farklı sıralamalar gördüğü ve aynı kullanıcının farklı zamanlarda farklı sıralamalar görebileceği anlamına gelir. Belirli bir sıralamayı etkileyen çeşitli faktörler vardır. Örneğin, bir kullanıcı bilgi panelindeki belirli bir sağlayıcının bağlantısını sık tıklarsa o sağlayıcının sıralamanın daha üst noktalarında yer alma ihtimali artar. Sıralamayı kontrol etmenin bir yolu yoktur.

Başlama

Kitap işlemlerini başarılı bir şekilde uygulamak için feed'inizi Kitap işlemleri yapılandırılmış veri türü tanımlarına göre oluşturmanız gerekir. Fakat önce aşağıdaki bölümleri inceleyin:

• Yönergeler
• Feed'inizi oluşturma
• Feed'inizi Veri Feed'i doğrulama aracıyla test etme
• Feed dosyanızı barındırma
• Feed dosyanızı incelemeye gönderme
• Gerektiğinde feed'inizi güncelleme

Yönergeler

Kitaplarınızın Arama'da güvenilir bir şekilde gösterilmesini sağlamak için bazı önemli ayrıntılara ve temel kavramlara aşina olmanız önemlidir. Ayrıca feed'inizin bazı standart biçim özelliklerine uygun olması gerekir.

Genel yapılandırılmış veri yönergelerine ve Arama'nın Temel Özellikleri'ne ek olarak burada açıklanan yönergeleri uygulamanız size bu konuda yardımcı olacaktır. Yönergeler aşağıdaki gibidir:

• Eserler ve baskılar
• Kitaplık sistemleri ve kitaplık üyeleri
• ISBN ve diğer desteklenen tanımlayıcılar
• Bağlantılar

Eserler ve baskılar

Bu belgede, bir kitaptan bahsederken iki farklı terim kullanırız:

• Eser: Soyut olarak kitap kavramını ifade eder. Özellikle başlık, yazar ve orijinal dil gibi meta veriler bir eserin özellikleridir.
• Baskı: Kitabın somut bir kopyasını ifade eder. Özellikle yayın yılı, baskının adı ve Uluslararası Standart Kitap Numarası (ISBN) gibi meta veriler baskının özellikleridir.

Örneğin, Charlotte'un Sevgi Ağı bir eserdir, ancak onun her versiyonu bir baskıdır. Bu durumda, Charlotte'un Sevgi Ağı'nın ilk baskısı, ikinci baskısı, kısaltılmış baskısı, Fransızca çeviri baskısı vb. olabilir.

Bu ayrım, özellikle feed'de hemen görülemeyebileceği durumlarda önemlidir. İki Book varlığı vardır:

• Book (Work) "üst düzey" Book varlığıdır:
  • workExample, Work varlığının bir özelliği olup Book (Edition) varlığının yalnızca tek bir örneğini belirtir.
  • Her Work için en az bir workExample olmalıdır.
• Book (Edition), "alt düzey" Book varlığıdır.

Bir eserin birden fazla basımının olabileceğini unutmayın. Bu baskıları mümkün olduğunca gruplandırmanızı öneririz. Bu, Google sistemlerinin bir kitapla ilgili tüm bilgilerden yararlanarak kitabı Arama'da göstermesine yardımcı olur. Gerekirse bunları birden fazla eser kaydına bölebilirsiniz, ancak her eser kaydının aşağıdakilere sahip olması gerekir:

• Başka bir @id.
• ISBN'ye veya başka bir desteklenen tanımlayıcıya sahip en az bir baskı.

Kitaplık sistemleri ve kitaplık üyeleri

Library entity, "üst düzey" Library varlık türüdür. Bu, bir LibrarySystem varlığından ve o kitaplık sisteminin her "alt düzey" Library (member) varlığından oluşan soyut bir yapıdır.

LibrarySystem varlığı bir soyutlama olup kitaplık üyelerinden oluşan ortak bir ağı temsil eder. Örneğin, Austin Halk Kütüphanesi bir LibrarySystem varlığı olarak belirtilebilir. Austin Halk Kütüphanesi web sitesi kendisini Austin, Teksas'ta hizmet veren bir halk kütüphanesi sistemi olarak tanımlamaktadır. Satış ortağı olan 20 kitaplıktan veya kitaplık üyelerinden oluşmaktadır.

Her LibrarySystem varlığı, kitaplık gerçek hayatta herhangi bir kitaplık sisteminin parçası olmasa bile en az bir Library (member) varlığı gerektirir. Bu senaryoda, Kitap işlemi uygulaması için kitaplık, kendi kitaplık sisteminin tek kitaplık üyesidir. Kitap işlemi uygulamasında, kitaplık sisteminin aksine, kitaplık üyesi bir soyutlama olmadığı için fiziksel bir adrese sahiptir.

Buna karşılık, her Library (member) varlığı en az bir LibrarySystem varlığına ait olmalıdır.

ISBN ve diğer desteklenen tanımlayıcılar

ISBN, feed verileriniz Google Arama tarafından Google'ın verileriyle eşleştirilirken ana mutabakat sinyalidir. Arama sonuçlarında görünmesini istediğiniz tüm kitaplar için bir ISBN veya desteklenen başka bir tanımlayıcı sağlamanız gerekir. Aksi halde, kitaplarınız eşleştirilemeyeceği için sunulmayabilir.

Google Arama, ISBN-13'ü tercih eder. Ancak alternatif olarak şunları da sağlayabilirsiniz:

• Çevrimiçi Bilgisayar Kütüphanesi Merkezi (OCLC) Numarası
• Kongre Kütüphanesi Kontrol Numarası (LCCN)
• JP e-kodu

Bağlantılar

Kullanıcıların kitaplarınızı bulurken en iyi deneyimi yaşadığından emin olmak için feed'inizdeki bağlantılar aşağıdaki yönergelere uygun olmalıdır:

• Aynı içerik için kopya sayfalarınız varsa bağlantı, kitap başlığını ve diğer kitap bilgilerini içeren standart URL olmalıdır.
• Kullanıcı, bir okuma veya ödünç alma işlem bağlantısını tıkladıktan sonra, kitabın satın alınmasını veya ödünç alınmasını doğrudan destekleyen bir sayfaya yönlendirilmelidir. Daha net bir şekilde ifade etmek gerekirse işlem bağlantılarını, içeriği satın almak veya ödünç almak için daha fazla bağlantının tıklanmasını gerektiren sayfalara yönlendirmeyin. Örneğin, kullanıcıları bir arama sonuçları sayfasına veya ürün özeti sayfasına yönlendirmeyin.

Feed'inizi oluşturma

Sitenizde kullanıcılara kitap satışı yapılıyorsa Book feed'inizi yüklemeniz gerekir. Google temsilcinizle iletişime geçerek feed'inizi nasıl ve nereye yükleyeceğinizi öğrenebilirsiniz.

Sitenizde kullanıcılara kitap ödünç veriliyorsa iki ayrı feed yüklemeniz gerekir: Book feed'iniz ve Library feed'iniz. Google temsilcinizle iletişime geçerek feed'inizi nasıl ve nereye yükleyeceğinizi öğrenebilirsiniz.

Feed dosya boyutu, miktar ve biçim gereksinimlerine uyma

İlgili şartlar aşağıda belirtilmiştir:

• Feed dosya boyutu gereksinimleri:
  • Sıkıştırılmamış bir feed dosyasının boyutu 1 GB'tan küçük olmalıdır.
  • Sıkıştırılacak feed dosyası 1 GB'tan küçük olmalıdır. Sıkıştırılmamış feed dosyanızın boyutu 1 GB'ı aşıyorsa onu birkaç dosyaya bölmeniz gerekir.
• Feed dosyalarını sıkıştırabilirsiniz. Bunlar zip, gz, tar, tar.gz, JAR, ar, arj, cpio veya dump arşiv dosyası biçiminde olmalıdır.
• Birden fazla feed dosyanız varsa bunları olduğu gibi yükleyebilir ya da bir site haritası dizin dosyasının parçası olarak ekleyebilirsiniz.
• Tek feed dosyaları .json dosya adı uzantısına sahip olmalıdır.

Feed içeriği gereksinimlerine uyma

Özellikle aşağıdaki feed içeriği gereksinimlerine uymanız gerekir:

• Feed eski varlıklar içermemelidir. Eski varlıklar, availabilityEnds öğesinin geçmişte bir tarihe ayarlandığı veya artık sitenizde bulunmayan varlıklardır.
• Feed'inize dahil ettiğiniz tüm derin bağlantılar (ör. urlTemplate) ve tüm URL'ler (ör. url) üretim URL'si olmalıdır. Üretim URL'si dışındaki URL türlerini (ör. QA, geliştirme vb.) kullanmayın.
• url gibi tüm URL'ler standart olmalıdır.
• Feed'inizdeki her varlık aşağıdaki özellikleri belirtmelidir:
  • Benzersiz bir kimlik: @id
  • Benzersiz bir URL: url
  • Benzersiz bir derin bağlantı: urlTemplate

Feed'inizi Veri Feed'i doğrulama aracıyla test etme

Veri Feed'i doğrulama aracında sık karşılaşılan hata ve uyarıları çözmek için aşağıdaki sorun giderme adımlarını uygulamanızı öneririz:

• Validate on alanında doğru seçeneği belirlediğinizden emin olun. Book varlığı için Kitap İşlemi'ni seçin.

• @type değerinin doğru yazıldığından emin olun.
• @context değerinin doğru şekilde ayarlandığından emin olun. Hem ReadAction hem de BorrowAction için "@context": "https://schema.org" değerini ayarlayın.

Feed dosyanızı barındırma

Hazır olduğunda feed dosyanızı güvenli bir yerde barındırın. Google, içeriğinizin güncel olmasını sağlamak için feed'i düzenli olarak getirir.

Barındırma yöntemleri

Aşağıdaki feed barındırma yöntemleri desteklenir:

Feed dosyanızı incelemeye gönderme

İçeriğinizin Google Arama'da kullanılabilmesi için bir Google destek ekibi, feed'inizdeki derin bağlantıların kalitesini inceler. Kullanıcıların kitap satın alabileceği veya ödünç alabileceği sayfayı açıp açmadığını onaylamak için derin bağlantılardan bazılarını manuel olarak test etmenizi önemle tavsiye ederiz.

Feed'inizi incelemeye gönderirken aşağıdakileri sağlayın:

• Ana makine konumu: Feed dosyanızın URL'si.
• Geçerliyse ana makine kimlik doğrulaması: Google'ın, feed dosyasını ana makine konumunuzdan almasını sağlayan kimlik doğrulama bilgileri.

Gerektiğinde feed'inizi güncelleme

Feed'inizi her gün güncellemenizi önersek de bu, kataloğunuzun ne sıklıkla değiştiğine bağlıdır. Aşağıdaki koşullara ve ipuçlarına dikkat edin:

• Google Arama, gerçek zamanlı güncellemeleri desteklemez.
• Google Arama, feed'inizi günde bir kez getirir ve içeriği genellikle iki gün içinde dizine ekler.
• Bir baskının kullanılabilirliğiyle ilgili öngörülebilir bir değişiklik varsa tam tarihleri ayarlamak için availabilityStarts ve availabilityEnds kullanın. Öğe artık kullanılamıyorsa tamamen kaldırın

Yapılandırılmış veri türü tanımları

İçeriğinizin yapılandırılmış arama sonuçlarında görüntülenmeye uygun olması için burada belirtilen zorunlu özellikleri eklemeniz gerekir. İçeriğiniz hakkında daha fazla bilgi ekleyerek daha iyi bir kullanıcı deneyimi sağlamak için, önerilen özellikleri de dahil edebilirsiniz.

DataFeed varlığı

Google'a gönderilen her schema.org veri feed'i dosyası, kök düzeyinde tek bir DataFeed varlığı içermelidir. Tüm Book ve Library varlıkları, DataFeed varlığının dataFeedElement alanında listelenmelidir.

Google tarafından desteklenen özellikler şunlardır:

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

Book varlığı

Book öğesinin tam tanımını schema.org/Book adresinde bulabilirsiniz. Bununla birlikte, yalnızca aşağıdaki özellikleri göz önünde bulundurmanız gerekir. Feed'inize dahil etmek istediğiniz her kitap için zorunlu özellikleri tanımlamanız gerekir. İçeriğiniz hakkında daha fazla bilgi ekleyerek daha iyi bir kullanıcı deneyimi sağlamak için, önerilen özellikleri de tanımlayabilirsiniz.

Book (Work)

Bu Book varlığı, üst düzey varlık türüdür. Bir eseri temsil eder.

Google tarafından desteklenen özellikler şunlardır:

Book (Edition)

workExample özelliği bu Book varlığını kullanır. Bir eserin baskısını temsil eder.

Google tarafından desteklenen özellikler şunlardır:

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

Birden fazla workExample özelliği içeren örnek Book (Edition):

"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 veya Organization (author)

Kitabın author özelliği, Person veya Organization varlığını kullanır.

Örnek author:

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

Birden fazla author özelliği içeren örnek:

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

PropertyValue (tanımlayıcı)

Edition öğesinin identifier özelliği PropertyValue varlığını kullanır.

Örnek identifier:

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

Birden fazla identifier özelliği içeren örnek:

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

Örnek ReadAction Book feed'i JSON dosyası

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

Örnek BorrowAction Book feed'i JSON dosyası

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

potentialAction özelliği ReadAction varlığını kullanır. ReadAction, kitaba erişmek için derin bağlantılarınızı, kitabı stokta bulunduran perakendeciyi ve kullanıcıların uyması gereken ölçütleri tanımlar. Ölçütler arasında üyelik durumu, giriş durumu, konum veya kitaba erişmek için gereken diğer öğeler yer alabilir.

Örnek 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"
    }
  }
}

Birden fazla EntryPoint özelliği içeren ReadAction örneği:

"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)

potentialAction özelliği BorrowAction varlığını kullanır. BorrowAction, kitaba erişmek için derin bağlantılarınızı, kitabı stokta bulunduran kitaplığı ve kullanıcıların uyması gereken ölçütleri tanımlar. Ölçütler arasında üyelik durumu, giriş durumu, konum veya kitaba erişmek için gereken diğer öğeler yer alabilir.

Örnek 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"
    ]
  }
}

Birden fazla EntryPoint özelliği içeren BorrowAction örneği:

"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 varlığı

Library öğesinin tam tanımını schema.org/Library adresinde bulabilirsiniz. Bununla birlikte, yalnızca aşağıdaki özellikleri göz önünde bulundurmanız gerekir. Feed'inize dahil etmek istediğiniz her kitaplık için zorunlu özellikleri tanımlamanız gerekir. İçeriğiniz hakkında daha fazla bilgi ekleyerek daha iyi bir kullanıcı deneyimi sağlamak için, önerilen özellikleri de tanımlayabilirsiniz.

Bu Library varlığı, üst düzey Library varlık türüdür. Bu, bir LibrarySystem varlığından ve o LibrarySystem varlığının her alt düzey Library (member) varlığından oluşan soyut bir yapıdır.

Library feed'i Book feed'inden ayrıdır. Bu nedenle, uygulayabileceğiniz tüm Library feed'leri Book feed'inizden tamamen ayrı olmalıdır. Daha fazla bilgiyi Feed'inizi oluşturma bölümünde bulabilirsiniz.

LibrarySystem

LibrarySystem varlığı, kitaplık üyelerinden oluşan ortak bir ağı temsil eder.

Library (member)

LibrarySystem varlığının member özelliği Library (member) varlığını kullanır. Library (member), belirli bir kitaplık sisteminin tek bir kitaplık üyesini temsil eder.

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

Örnek LibrarySystem feed'i JSON dosyası

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