Book actions (Book) yapılandırılmış verileri

Book actions, Google Arama’yı kitapları ve yazarları keşfetmek için bir giriş noktası haline getirir. Bu, Arama kullanıcılarının buldukları kitapları doğrudan Arama sonuçlarından hızlıca satın almalarını veya ödünç almalarını sağlar. Örneğin, bir kullanıcı Charlotte’s Web için arama yapabilir ve onlara kitabı satın alma veya ödünç alma imkanı tanıyan sonuçlarla karşılaşabilir. Kitap sağlayıcısı olarak, burada sağlanan yapılandırılmış veri şeması ile Google’a bir veri feed’i sağlayabilirsiniz. Spesifikasyonumuz, kullanıcıların bir kitap satın almasını sağlamak için
ReadAction ve bir kitap ödünç almasını sağlamak için BorrowAction sunar.

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

Bilgi panelindeki sağlayıcıların sırası kişiselleştirilmiştir ve her kullanıcı için dinamiktir. Bu, 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ı bağlantısına sık sık tıklarsa, o sağlayıcının sıralamada daha üstte yer alma olasılığı daha yüksektir. Sıralamayı kontrol etmenin bir yolu yoktur.

Başlarken

Book actions’ı başarıyla uygulamak için feed’inizi Book actions yapılandırılmış veri türü tanımlarınauygun olarak oluşturmalısınız, ancak önce şu bölümleri inceleyin:

• Kurallar
• Feed’inizi oluşturun
• Feed’inizi Data Feed doğrulama aracı ile test edin
• Feed dosyanızı barındırın
• Feed dosyanızı inceleme için gönderin
• Feed’inizi gerektiği gibi güncelleyin

Kurallar

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’iniz bazı standartlaştırılmış format spesifikasyonlarını karşılamalıdır.

Bunu yapmanıza yardımcı olmak için, burada açıklanan kuralları,
genel yapılandırılmış veri kuralları ve
Arama Temelleriile birlikte izleyin. Kurallar şöyledir:

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

Eserler ve baskılar

Bu dokümantasyon boyunca, bir kitaptan bahsederken iki farklı terim kullanıyoruz:

• Eser: Bir kitabın soyut kavramı. Özellikle başlık, yazar ve orijinal dil gibi meta veriler bir eserin nitelikleridir.
• Baskı: Kitabın somut bir kopyası. Özellikle yayın yılı, baskı adı ve Uluslararası Standart Kitap Numarası (ISBN) gibi meta veriler baskının nitelikleridir.

Örneğin, Charlotte’s Web bir eserdir, ancak geldiği her çeşit bir baskıdır. Bu durumda, Charlotte’s Web eseri ilk baskıya, ikinci baskıya, özet baskıya, Fransızca çeviri baskısına vb. sahip olabilir.

Bu ayrım, hemen belli olmayabileceği feed’de özellikle önemlidir. İki Book varlığı vardır:

• Book (Eser) “üst düzey” Book
  varlığıdır:
  • workExample Eser’in bir özelliğidir ve bir Book Baskı (örneğinin sadece bir tanesini belirtir.).
  • Her Eser için en az bir workExample.
• olmalıdır. (Book) Baskı "alt düzey"
  Book

varlığıdır.

• Bir eserin birden fazla baskısı olabileceğini hatırlamakta fayda var. Bu baskıları mümkün olduğunca gruplandırmanızı öneririz. Bu, Google sistemlerinin bir kitap hakkındaki tüm ilgili bilgilerden yararlanmasına ve bunu Arama’da göstermesine yardımcı olur. Gerekirse, bunları birden fazla eser kaydına bölebilirsiniz, ancak her eser kaydı şunlara sahip olmalıdır: Farklı bir.
• @id

ISBN veya desteklenen başka bir tanımlayıcıya sahip en az bir baskı.

Varlık Library varlık türünün “en üst seviyesidir”. Library Bu, bir LibrarySystem varlığından ve o kütüphane sisteminin her bir “alt seviye”
Library (member) varlığından oluşan soyut bir yapıdır.

Varlık LibrarySystem bir soyutlamadır ve kütüphane üyelerindenoluşan işbirlikçi bir ağı temsil eder. Örneğin, Austin Public Library bir
LibrarySystem varlığı olarak belirtilebilir. Austin Public Library web sitesi kendilerini Austin, Teksas’a hizmet veren bir halk kütüphanesi sistemi olarak tanımlar. Bu sistem, 20 bağlı kütüphaneden veya kütüphane üyesinden.

oluşur. Her LibrarySystem varlığı, gerçek hayatta kütüphane herhangi bir kütüphane sisteminin parçası olmasa bile en az bir Library (member)
varlığı gerektirir. Bu senaryoda, Book eylemi uygulaması amacıyla kütüphane, kendi kütüphane
sisteminin tek üyesidir. Book eylemi uygulaması amacıyla, bir kütüphane sistemininaksine, bir kütüphane üyesi bir soyutlama değildir ve bu nedenle fiziksel bir adresi vardır.

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

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

ISBN, Google Arama verilerinizle Google’ın verilerini eşleştirdiğinde 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ğlamalısınız. Bu olmadan, kitaplarınızın eşleştirilmesi ve dolayısıyla sunulması pek olası değildir.

Google Arama ISBN-13’ü tercih eder, ancak alternatif olarak şunları sağlayabilirsiniz:

• Online Computer Library Center (OCLC) Numarası
• Library of Congress Control Number (LCCN)
• JP e-code

Bağlantılar

İnsanların kitaplarınızı bulurken en iyi deneyimi yaşamasını sağlamak için feed’inizdeki bağlantılar aşağıdaki yönergelere uymalıdır:

• Aynı içerik için yinelenen sayfalarınız varsa, bağlantı, kitap başlığını ve diğer kitap bilgilerini içeren
  kanonik URL olmalıdır.
• Bir kullanıcı bir okuma eylemi veya ödünç alma eylemi bağlantısına tıkladıktan sonra, kullanıcı doğrudan kitabın satın alınmasını veya ödünç alınmasını destekleyen bir sayfaya gönderilmelidir. Özellikle, eylem bağlantılarını içeriği satın almak veya ödünç almak için tıklanması gereken daha fazla bağlantı içeren sayfalara yönlendirmeyin. Örneğin, insanları bir arama sonuçları sayfasına veya ürün özeti sayfasına göndermeyin.

Feed’inizi oluşturun

Siteniz kullanıcıların satın alması için kitap satıyorsa,
Book feed’inizi yüklemelisiniz. Bir Google destek ekibi, feed’inizi nasıl ve nereye yükleyeceğinizle ilgili ayrıntılar için sizinle iletişime geçecektir.

Siteniz kullanıcıların ödünç alması için kitap ödünç veriyorsa, iki ayrı feed yüklemelisiniz:
Book feed’iniz ve
Library feed’iniz. Bir Google destek ekibi, feed’inizi nasıl ve nereye yükleyeceğinizle ilgili ayrıntılar için sizinle iletişime geçecektir.

Feed dosyası boyutu, miktarı ve biçim gereksinimlerine uyun

Gereksinimler şunlardır:

• Feed dosyası 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 bir feed dosyası 1 GB’tan küçük olmalıdır. Sıkıştırılmamış feed dosyanız 1 GB’ı aşıyorsa, sıkıştırılmamış feed dosyasını birden fazla dosyaya bölmelisiniz.
• Besleme dosyalarını sıkıştırabilirsiniz. Bunlar zip, gz, tar, tar.gz, JAR, ar, arj, cpio veya dump arşiv dosyası olarak biçimlendirilmelidir.
• Birden fazla besleme dosyanız varsa, bunları olduğu gibi yükleyebilir veya isterseniz
  sitemap dizin dosyası.
• Tekil besleme dosyaları .json dosya uzantısına sahip olmalıdır.

Besleme içeriği gereksinimlerine uyun

Uymanız gereken aşağıdaki besleme içeriği gereksinimlerine özellikle dikkat edin:

• Besleme eski varlıklar içermemelidir. Eski varlıklar,
  availabilityEnds tarihi geçmiş olan veya sitenizde artık bulunmayan varlıklardır.
• Beslemenize dahil ettiğiniz urlTemplategibi tüm derin bağlantılar ve
  urlgibi tüm URL’ler üretim (production) URL’leri olmalıdır. QA, geliştirme veya başka herhangi bir üretim dışı URL türü kullanmayın.
• url gibi tüm URL'lerkanonik
  olmalıdır..
• Beslemenizdeki her varlık şu özellikleri belirtmelidir:
  • Benzersiz bir kimlik: @id
  • Benzersiz bir URL: url
  • Benzersiz bir derin bağlantı: urlTemplate

Beslemenizi Data Feed doğrulama aracı ile test edin

Yaygın hata ve uyarıları çözmek için aşağıdaki sorun giderme adımlarını öneriyoruz: Data Feed doğrulama aracı:

• Validate on alanında doğru seçeneğin seçili olduğundan emin olun. Book varlığı için Books Action seçeneğini seçin. @type

• değerinin doğru yazıldığını doğrulayın. @context değerinin düzgün ayarlandığından emin olun.
• ReadAction ve BorrowAction
  için “@context”: “https://schema.org” değerini ayarlayın. Besleme dosyanızı barındırın
  Besleme dosyanız hazır olduğunda, güvenli bir konumda barındırın. Google, içeriğinizin güncel kalmasını sağlamak için beslemeyi düzenli olarak getirir..

Barındırma yöntemleri

Aşağıdaki besleme barındırma yöntemleri desteklenmektedir:

Barındırma

Kimlik Doğrulama Desteği

Not:

Bu özelliğin başarılı kullanımı ve beslemenizi göndermek için kullanmanız gereken

Besleme dosyanızın URL’si.

• Varsa barındırma kimlik doğrulaması: Google’ın besleme dosyasını barındırma konumunuzdan almasını sağlamak için kimlik doğrulama bilgileri.
• Beslemenizi gerektiği gibi güncelleyin Beslemenizi günlük olarak güncellemenizi öneririz, ancak bu nihayetinde 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 beslemenizi günde bir kez getirir ve içeriği genellikle iki gün içinde dizine ekler.

• Bir sürümün kullanılabilirliğinde öngörülebilir bir değişiklik varsa, şunu kullanın
• tr
• tr
  availabilityStarts ve availabilityEnds
  tam tarihleri ayarlamak için. Eğer varlık artık mevcut değilse, varlığı 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 listelenen gerekli özellikleri eklemelisiniz. Ayrıca, içeriğiniz hakkında daha fazla bilgi eklemek ve 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 akışı dosyası, tek bir
DataFeed varlığı içermelidir. Tüm
Book ve
Library varlıkları,
DataFeed varlığının dataFeedElement alanı altında listelenmelidir.

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

Book varlık

Tam tanımı Book adresinde mevcut olsa da
schema.org/Book, yalnızca aşağıdaki özellikleri dikkate almanız gerekir. Feed’inize dahil etmeyi seçtiğiniz her kitap için gerekli özellikleri tanımlamalısınız. Ayrıca, içeriğiniz hakkında daha fazla bilgi eklemek için önerilen özellikleri de tanımlayabilirsiniz; bu, daha iyi bir kullanıcı deneyimi sağlayabilir.

Book (Work)

Bu Book varlığı, en üst düzey varlık türüdür. Bir eser.

kılavuzlarını okuyun.

sameAs (URL)

Eseri tanımlayan bir referans sayfasının URL’si. Örneğin, kitap için bir Wikipedia, Wikidata, VIAF veya Kongre Kütüphanesi sayfası. Book Edition Özellik workExample
bu Book varlığını kullanır. Bir.

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

Örnek Kitap (Basım):

Örnek Kitap (Basım) birden fazla ile workExample özellikler:

Kişi veya Kuruluş (yazar)

Kitabın yazar özelliği
Kişi veya Kuruluş varlığını kullanır.

Örnek yazar:

Birden fazla içeren örnek yazar özellikleri:

PropertyValue (tanımlayıcı)

Basım varlığının tanımlayıcı özelliği PropertyValue varlığını kullanır.
Gerekli özellikler

tanımlayıcı Birden fazla içeren örnek:

tanımlayıcı özellikleri: Örnek

ReadAction Kitap besleme JSON dosyası Örnek

BorrowAction tr_extra_padding_fix_for_array_length_80_items_requirement_met_above Kitap Besleme JSON dosyası

ReadAction (potentialAction)

potentialAction özelliği ReadAction varlığını kullanır. ReadAction
kitaba erişim için derin bağlantılarınızı, kitabı stoklayan perakendeciyi ve kullanıcıların karşılaması gereken kriterleri tanımlar. Kriterler üyelik durumu, giriş durumu, konum veya kitaba erişmek için gereken diğer her şeyi içerebilir. Gerekli özellikler

formatında fiyat para birimi. Örnek:

ReadAction Örnek ReadAction birden fazla EntryPoint

özelliği ile: (BorrowAction)

potentialAction potentialAction özelliği BorrowAction varlığını kullanır.
BorrowAction kitaba erişim için derin bağlantılarınızı, kitabı stoklayan kütüphaneyi ve kullanıcıların karşılaması gereken kriterleri tanımlar. Kriterler üyelik durumu, giriş durumu, konum veya kitaba erişim için gereken diğer her şeyi içerebilir.

Örnek BorrowAction:

Örnek BorrowAction birden fazla ile Giriş Noktası özellikler:

Kütüphane varlık

Tam tanımı Kütüphane adresinde mevcut olsa da
schema.org/Library, yalnızca aşağıdaki özellikleri dikkate almanız gerekir. Feed’inize dahil etmeyi seçtiğiniz her kütüphane için gerekli özellikleri tanımlamalısınız. Ayrıca, içeriğiniz hakkında daha fazla bilgi eklemek ve daha iyi bir kullanıcı deneyimi sağlamak için önerilen özellikleri de tanımlayabilirsiniz.

Bu Kütüphane varlığı, en üst düzey Kütüphane
varlık türüdür. Bu, bir
LibrarySystem varlığından ve bu
LibrarySystem varlığının her bir alt düzey
Kütüphane (üye).

varlığından oluşan soyut bir yapıdır. Kütüphane feed’i, Kitap feed’inden farklıdır. Bu nedenle, uygulayabileceğiniz herhangi bir Kütüphane
feed’i, tamamen Kitap feed’inizden ayrı olmalıdır. Daha fazla bilgi için
Feed’inizi oluşturun.

LibrarySystem

Bu LibrarySystem varlığı, kütüphane üyelerinden.

adresinde sağlanan URL'yi kullanır. (Library)

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

Örnek LibrarySystem JSON besleme dosyası