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.
![Arama sonuçlarında kitap işlemi](https://developers.google.cn/static/search/docs/images/books01.png?authuser=8&hl=tr)
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 olupBook
(Edition
) varlığının yalnızca tek bir örneğini belirtir.- Her
Work
için en az birworkExample
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
- Benzersiz bir kimlik:
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. HemReadAction
hem deBorrowAction
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:
Barındırma | Kimlik Doğrulama Desteği | |
---|---|---|
Google Cloud Storage | Storage Object Viewer izni | |
HTTPS | Kullanıcı Adı+Şifre veya HTTP istemci sertifikaları | |
SFTP | Şifre, Anahtar+Kelime Öbeği veya her ikisi de | |
AWS S3 | Anahtar Kimliği+Erişim Anahtarı |
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
veavailabilityEnds
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:
Zorunlu özellikler | |
---|---|
@context |
|
@type |
|
dataFeedElement |
Tek bir
{ "@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" } |
dateModified |
Feed'in son güncellemesinin ISO 8601 biçimindeki tarihi ve saati. |
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:
Zorunlu özellikler | |
---|---|
@context |
|
@id |
Kitabın URL biçimindeki genel olarak benzersiz kimliği. Kuruluşunuza özgü olmalıdır. Kimlik sabit olup zaman içinde değişmemelidir. URL biçimi önerilir, ancak zorunlu değildir. Çalışan bir bağlantı olması gerekmez. |
@type |
|
author |
Kitabın yazarları. |
name |
Kitabın başlığı. |
url |
Web sitenizde kitabın tanıtıldığı veya anlatıldığı URL. Bu bağlantı, feed'inizdeki içeriğin Google'ın veritabanlarındaki içerikle doğru bir şekilde eşleştirilmesine yardımcı olur. Google Arama, gerçek açılış sayfası için |
workExample |
Eserin baskıları. |
Önerilen özellikler | |
---|---|
sameAs |
Eseri tanımlayan bir referans sayfasının URL'si. Örneğin, kitaba ait bir Vikipedi, Vikiveri, VIAF veya Kongre Kütüphanesi sayfası. |
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:
Zorunlu özellikler | |
---|---|
@id |
Kitabın URL biçimindeki genel olarak benzersiz kimliği. Kuruluşunuza özgü olmalıdır. Kimlik sabit olup zaman içinde değişmemelidir. URL biçimi önerilir, ancak zorunlu değildir. Çalışan bir bağlantı olması gerekmez. |
@type |
|
bookFormat |
Baskının biçimi. Bunun değeri aşağıdakilerden biri olmalıdır:
|
inLanguage |
Baskı içeriğinin ana dili. ISO 639-1 alfa-2 kodları listesindeki iki harfli kodlardan birini kullanın. |
isbn |
Baskının ISBN-13'ü. ISBN-10’unuz varsa ISBN-13'e dönüştürün. |
potentialAction |
Kullanıcıların kitabı satın alması veya indirmesi için tetiklenecek işlem. Daha fazla bilgiyi |
Önerilen özellikler | |
---|---|
author |
Baskının yazarları. |
bookEdition |
Kitabın baskı bilgileri. Örneğin, |
datePublished |
Baskının YYYY-MM-DD veya YYYY biçimindeki yayın tarihi. Bu, belirli bir tarih veya yalnızca belirli bir yıl olabilir. |
identifier |
Bu baskıyı açık bir şekilde tanımlayan harici veya diğer kimlik. Birden fazla tanımlayıcıya izin verilir. Daha fazla bilgi için
Bu özellik tekrarlanabilir. |
name |
Baskının başlığı. Bunu yalnızca baskının başlığı, eserin başlığından farklıysa kullanın. |
sameAs |
Baskıyı açık bir şekilde tanımlayan bir referans web sayfasının URL'si. Örneğin, bu baskıyla ilgili bir Vikipedi sayfası. |
url |
Web sitenizde baskının tanıtıldığı veya anlatıldığı URL. |
Ö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.
Zorunlu özellikler | |
---|---|
@type |
|
name |
Kişinin veya kuruluşun adı. |
Önerilen özellikler | |
---|---|
sameAs |
Kişinin veya kuruluşun kimliğini açık bir şekilde tanımlayan bir referans web sayfasının URL'si. Örneğin, kişi veya kuruluşla ilgili bir Wikipedia sayfası. |
Ö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.
Zorunlu özellikler | |
---|---|
@type |
|
propertyID |
Kimlik türü. ISBN ve diğer desteklenen tanımlayıcılar bölümünde açıklandığı gibi aşağıdakilerden biri olmalıdır:
|
value |
Kimlik değeri. Bu baskıyı açık bir şekilde tanımlayan harici kimlik. Harici kimliğin sayısal olmayan tüm ön eklerini kaldırın. |
Ö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.
Zorunlu özellikler | |
---|---|
@type |
|
expectsAcceptanceOf |
Kullanıcıların bu varlığa erişmek için yerine getirmesi gereken şartların tanımı. Birden fazla Bu özellik tekrarlanabilir. |
expectsAcceptanceOf.@type |
|
expectsAcceptanceOf.category |
|
expectsAcceptanceOf.eligibleRegion |
Bu Bu özellik tekrarlanabilir. |
expectsAcceptanceOf.eligibleRegion.@type |
|
expectsAcceptanceOf.eligibleRegion.name |
ISO 3166-1 alpha-2 ülke kodu. |
target |
Desteklenen platform bilgilerini içeren derin bağlantınızın özellikleri. Farklı platform grupları için farklı derin bağlantıları tanımlamak üzere birden fazla Bu özellik tekrarlanabilir. |
target.@type |
|
target.actionPlatform |
Bu derin bağlantının geçerli olduğu platformlar. Aşağıdaki değerlerden birini kullanın:
Bu özellik tekrarlanabilir. |
target.urlTemplate |
Kullanıcıları doğrudan kitabınızın açılış sayfasının içeriğine yönlendiren bağlantı. |
Önerilen özellikler | |
---|---|
expectsAcceptanceOf.availabilityEnds |
Kullanım döneminin bitiş zamanı. Bu, kitabın kullanıcılara tam olarak ne zamandan itibaren sunulmaması gerektiğini kontrol etmek için kullanılabilir. |
expectsAcceptanceOf.availabilityStarts |
Kullanım döneminin başlangıç zamanı. Bu, kitabın kullanıcılara tam olarak ne zaman sunulabileceğini kontrol etmek için kullanılabilir. |
expectsAcceptanceOf.price |
Kitabın satın alma fiyatı. Bu, |
expectsAcceptanceOf.priceCurrency |
Fiyatın üç harfli ISO 4217 biçimindeki para birimi. |
Ö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.
Zorunlu özellikler | |
---|---|
@type |
|
lender |
Bu basıma erişim olanağı sunan kitaplık sistemi. |
lender.@id |
Kitaplık feed'inde ayrıca tam olarak açıklanması gereken |
lender.@type |
|
target |
Desteklenen platform bilgilerini içeren derin bağlantınızın özellikleri. Farklı platform grupları için derin bağlantıları tanımlamak üzere bir Bu özellik tekrarlanabilir. |
target.@type |
|
target.actionPlatform |
Bu derin bağlantının geçerli olduğu platformlar. Aşağıdaki değerlerden birini kullanın:
Bu özellik tekrarlanabilir. |
target.urlTemplate |
Kullanıcıları doğrudan kitabınızın açılış sayfasının içeriğine yönlendiren bağlantı. |
Ö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.
Zorunlu özellikler | |
---|---|
@context
|
Text
|
@id
|
URL
Kitaplık sisteminin URL biçimindeki genel olarak benzersiz kimliği. Kimlik sabit olup zaman içinde değişmemelidir. Bu, bir opak dize olarak işlenir ve çalışan bir bağlantı olması gerekmez. |
@type
|
Text
|
additionalProperty
|
PropertyValue
Kitaplığın türünü belirtmek için kullanılan ek özellik. |
additionalProperty.@type
|
Text
|
additionalProperty.name
|
Text
|
additionalProperty.value
|
Text
Kitaplığın türü. Aşağıdaki değerlerden birini kullanın:
|
member
|
Library
Kitaplık sisteminin üyeleri. |
name
|
Text
Kitaplık sisteminin adı. Örneğin,
|
url
|
URL
Kitaplık sisteminin tanıtıldığı veya anlatıldığı URL. Google Arama, feed'inizdeki içeriği Google'ın veritabanlarındaki içerikle eşleştirmek için bu bağlantıyı kullanır. Google Arama, gerçek açılış sayfası için |
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.
Zorunlu özellikler | |
---|---|
@id
|
URL
Kitaplık şubesinin URL biçimindeki genel olarak benzersiz kimliği. Kimlik sabit olup zaman içinde değişmemelidir. Bu, bir opak dize olarak işlenir ve çalışan bir bağlantı olması gerekmez. |
@type
|
Text
|
location
|
PostalAddress
Kitaplık şubesinin açık adresi. Her özellik her ülke için geçerli değildir. Kitaplıklarınızın adreslerine mümkün olduğunca fazla özellik eklemeniz gerekir. Amerika Birleşik Devletleri { "@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" } } Japonya { "@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
|
location.addressCountry
|
Text
ISO 3166-1 biçimindeki ülke kodu. Örneğin, |
location.addressLocality
|
Text
Şehir. Örneğin,
|
location.addressRegion
|
Text
Bölge. Örneğin, |
location.postalCode
|
Text
Posta kodu. Örneğin,
|
location.streetAddress
|
Text
Açık adres. Örneğin,
|
name
|
Text
Kitaplık şubesinin adı. |
Ö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" } } ] }