Data terstruktur tindakan buku (Book
)
Tindakan Buku menjadikan Google Penelusuran sebagai titik masuk untuk menemukan buku dan pengarang. Fitur ini memungkinkan
pengguna Penelusuran membeli atau meminjam buku yang mereka temukan langsung dari hasil Penelusuran dengan cepat.
Misalnya, pengguna dapat menelusuri Charlotte's Web dan hasilnya akan ditampilkan
sehingga pengguna tersebut dapat membeli atau meminjamnya. Sebagai penyedia buku, Anda dapat memberikan feed data ke Google
beserta skema data terstruktur yang disediakan di sini. Spesifikasi kami menyediakan
ReadAction
yang mengizinkan pengguna untuk membeli buku dan BorrowAction
untuk meminjam
buku.
![Tindakan buku dalam hasil Penelusuran](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/books01.png?authuser=0000&hl=id)
Tindakan membaca dan tindakan meminjam yang dimasukkan ke dalam panel menampilkan opsi untuk membeli atau meminjam buku. Melalui link yang Anda berikan, tindakan membaca dan tindakan meminjam akan langsung mengarahkan pengguna dari panel info dan platform Google lainnya ke halaman buku di situs atau aplikasi Anda.
Urutan penyedia di panel info dipersonalisasi dan bersifat dinamis untuk setiap pengguna. Artinya bahwa pengguna yang berbeda akan melihat urutan yang berbeda, dan pengguna yang sama mungkin melihat urutan yang berbeda pada waktu yang berbeda. Ada berbagai faktor yang memengaruhi urutan tertentu. Misalnya, jika pengguna sering mengklik link penyedia tertentu di panel info, posisi penyedia tersebut dalam sebuah urutan akan cenderung lebih tinggi. Tidak ada cara untuk mengontrol urutan.
Memulai
Agar berhasil menerapkan tindakan Buku, Anda harus membuat feed sesuai dengan definisi jenis data terstruktur tindakan Buku, tetapi sebaiknya tinjau bagian berikut terlebih dahulu:
- Panduan
- Membuat feed
- Menguji feed dengan alat validasi Feed Data
- Menghosting file feed
- Mengirim file feed untuk ditinjau
- Memperbarui feed jika perlu
Panduan
Untuk memastikan buku Anda dapat ditampilkan dengan baik di Penelusuran, Anda harus memahami beberapa detail penting dan konsep utama. Selanjutnya, feed Anda harus memenuhi beberapa spesifikasi format standar.
Untuk membantu Anda, ikuti pedoman yang dijelaskan di sini, selain pedoman data terstruktur umum dan Dasar-Dasar Penelusuran. Pedoman tersebut adalah sebagai berikut:
Karya dan edisi
Dalam dokumentasi ini, kami menggunakan dua istilah yang berbeda saat membahas sebuah buku:
- Karya: Konsep abstrak buku. Secara khusus, metadata seperti judul, pengarang, dan bahasa asli adalah atribut sebuah karya.
- Edisi: Salinan konkret buku. Secara khusus, metadata seperti tahun penerbitan, nama edisi, dan Nomor Buku Standar Internasional (ISBN) adalah atribut edisi.
Misalnya, Charlotte's Web adalah karya, tetapi setiap variasi yang disertakan merupakan edisi. Dalam hal ini, karya Charlotte's Web dapat memiliki edisi pertama, edisi kedua, edisi ringkas, edisi terjemahan Prancis, dan sebagainya.
Perbedaan ini sangat penting dalam feed, tempat perbedaan tersebut mungkin tidak langsung terlihat. Ada dua entitas Book
:
Book
(Work
) adalah entitasBook
"level atas":workExample
adalah properti dariWork
dan menentukan satu-satunya instance dariBook
(Edition
).- Setidaknya harus ada satu
workExample
untuk setiapWork
.
Book
(Edition
) adalah entitasBook
"level bawah".
Perlu diingat bahwa bisa terdapat beberapa edisi untuk sebuah karya. Sebaiknya Anda mengelompokkan edisi sebisa mungkin. Hal ini membantu sistem Google memanfaatkan semua informasi yang relevan tentang buku dan menampilkannya di Penelusuran. Jika diperlukan, Anda dapat memecahnya menjadi beberapa catatan karya, tetapi setiap catatan karya harus memiliki hal berikut:
@id
yang berbeda.- Setidaknya satu edisi dengan ISBN atau ID lainnya yang didukung.
Sistem perpustakaan dan anggota perpustakaan
Library entity
adalah
jenis entitas Library
“level atas”. Jenis ini adalah konstruksi abstrak yang terdiri
dari entitas LibrarySystem
dan setiap entitas
Library (member)
“level bawah” sistem perpustakaan tersebut.
Entitas LibrarySystem
adalah sebuah abstraksi yang mewakili
jaringan kolaboratif anggota perpustakaan. Misalnya, Perpustakaan Umum Austin dapat ditetapkan sebagai
entitas LibrarySystem
. Situs Perpustakaan
Umum Austin mendeskripsikan dirinya sebagai sistem perpustakaan umum yang melayani wilayah Austin,
Texas. Situs perpustakaan umum tersebut terdiri dari 20 perpustakaan yang berafiliasi atau anggota perpustakaan.
Setiap entitas LibrarySystem
memerlukan setidaknya satu entitas Library (member)
,
meskipun kenyataannya perpustakaan tersebut bukan bagian dari sistem perpustakaan mana pun. Dalam skenario ini,
untuk tujuan penerapan tindakan Buku, perpustakaan tersebut adalah satu-satunya
anggota perpustakaan dari sistem perpustakaan itu sendiri. Untuk tujuan penerapan tindakan Buku,
tidak seperti sistem perpustakaan, anggota perpustakaan bukanlah sebuah abstraksi
sehingga tidak memiliki alamat fisik.
Sebaliknya, setiap entitas Library (member)
harus dimiliki oleh setidaknya satu
entitas LibrarySystem
.
ISBN dan ID lainnya yang didukung
ISBN adalah sinyal rekonsiliasi utama saat Google Penelusuran mencocokkan data feed Anda dengan data Google. Anda harus memberikan ISBN atau ID lainnya yang didukung untuk semua buku yang ingin ditampilkan di hasil Penelusuran. Tanpa ISBN atau ID, kemungkinan buku Anda tidak dapat dicocokkan sehingga tidak akan ditampilkan.
Google Penelusuran lebih memilih ISBN-13, tetapi Anda dapat memberikan hal berikut:
- Nomor Pusat Perpustakaan Komputer Online (OSLC)
- Nomor Kontrol Perpustakaan Kongres (LCCN)
- E-code JP
Link
Untuk memastikan pengguna mendapatkan pengalaman terbaik selama mencari buku Anda, link di feed Anda harus mematuhi pedoman berikut:
- Jika Anda memiliki halaman duplikat untuk konten yang sama, link harus berupa URL kanonis yang memuat judul buku dan informasi buku lainnya.
- Setelah mengklik link tindakan membaca atau tindakan meminjam, pengguna harus diarahkan ke halaman yang langsung mendukung pembelian atau peminjaman buku. Khususnya, jangan arahkan link tindakan ke halaman yang memiliki banyak link yang harus diklik agar dapat membeli atau meminjam konten. Misalnya, jangan arahkan pengguna ke halaman hasil penelusuran atau halaman ringkasan produk.
Membuat feed
Jika situs Anda menjual buku untuk dibeli oleh pengguna, Anda harus mengupload feed
Book
. Hubungi perwakilan Google Anda
dan verifikasi detail tentang cara dan tempat untuk mengupload feed.
Jika situs Anda meminjamkan buku, Anda harus mengupload dua feed terpisah: feed
Book
dan feed
Library
. Hubungi perwakilan Google
Anda dan verifikasi detail tentang cara dan tempat untuk mengupload feed.
Mematuhi persyaratan ukuran, kuantitas, dan format file feed
Persyaratannya adalah sebagai berikut:
- Persyaratan ukuran file feed:
- Ukuran file feed yang tidak dikompresi harus lebih kecil dari 1 GB.
- File feed yang akan dikompresi harus lebih kecil dari 1 GB. Jika ukuran file feed yang tidak dikompresi lebih dari 1 GB, Anda harus membagi file feed yang tidak dikompresi tersebut menjadi beberapa file.
- Anda dapat mengompresi file feed. File tersebut harus diformat menjadi file arsip zip, gz, tar, tar.gz, JAR, ar, arj, cpio, atau dump.
- Jika memiliki beberapa file feed, Anda dapat menguploadnya sebagaimana adanya, atau jika ingin, Anda dapat menyertakannya sebagai bagian dari file indeks peta situs.
- File feed tunggal harus memiliki ekstensi nama file
.json
.
Mematuhi persyaratan konten feed
Perhatikan secara khusus persyaratan konten feed berikut yang harus Anda patuhi:
- Feed dilarang berisi entitas yang telah usang. Entitas usang adalah entitas dengan
availabilityEnds
yang diatur ke tanggal yang telah berlalu atau entitas yang tidak lagi tersedia di situs Anda. - Semua deep link, seperti
urlTemplate
, dan semua URL, sepertiurl
yang Anda sertakan dalam feed harus berupa URL produksi. Jangan gunakan UM (Uji Mutu), pengembangan, atau jenis URL non-produksi lainnya. - Semua URL, seperti
url
, harus bersifat kanonis. - Setiap entitas dalam feed Anda harus menentukan properti berikut:
- ID unik:
@id
- URL unik:
url
- Deep link unik:
urlTemplate
- ID unik:
Menguji feed dengan alat validasi Feed Data
Kami menyarankan langkah pemecahan masalah berikut untuk mengatasi error dan peringatan umum pada alat validasi Feed Data:
-
Pastikan Anda memilih opsi yang benar di kolom Validasi pada. Pilih Tindakan Buku untuk entitas
Book
. - Verifikasi bahwa nilai
@type
sudah dieja dengan benar. - Pastikan nilai
@context
disetel dengan benar. Setel"@context": "https://schema.org"
untukReadAction
danBorrowAction
.
Menghosting file feed
Jika file feed sudah siap, hosting file tersebut di lokasi yang aman. Google mengambil feed secara rutin untuk memastikan bahwa konten Anda adalah konten terbaru.
Metode hosting
Berikut adalah metode hosting feed yang didukung:
Hosting | Dukungan Autentikasi | |
---|---|---|
Google Cloud Storage | Izin Storage Object Viewer | |
HTTPS | Nama Pengguna+Sandi atau sertifikat klien HTTP | |
SFTP | Sandi, Kunci+Frasa, atau keduanya | |
AWS S3 | ID Kunci+Kunci Akses |
Mengirim file feed untuk ditinjau
Agar konten tersedia di Google Penelusuran, tim dukungan Google akan meninjau kualitas deep link di feed Anda. Sebaiknya Anda menguji beberapa deep link secara manual untuk memastikan link tersebut membuka halaman tempat pengguna dapat membeli atau meminjam buku.
Untuk meminta peninjauan feed, berikan hal berikut:
- Lokasi host: URL file feed Anda.
- Autentikasi host, jika berlaku: Kredensial autentikasi agar Google bisa mendapatkan file feed dari lokasi host Anda.
Memperbarui feed jika perlu
Sebaiknya Anda memperbarui feed setiap hari, tetapi pada akhirnya bergantung pada frekuensi perubahan katalog Anda. Perhatikan kondisi dan tips berikut:
- Google Penelusuran tidak mendukung pembaruan real-time.
- Google Penelusuran mengambil feed Anda satu kali per hari dan biasanya mengindeks konten dalam dua hari.
- Jika ada rencana perubahan dalam ketersediaan edisi, gunakan
availabilityStarts
danavailabilityEnds
untuk menetapkan tanggal yang tepat. Jika entitas tidak lagi tersedia, hapus sepenuhnya entitas tersebut
Definisi jenis data terstruktur
Anda harus menyertakan properti wajib yang tercantum di sini agar konten Anda memenuhi syarat untuk ditampilkan di hasil penelusuran terstruktur. Anda juga dapat menyertakan properti yang direkomendasikan untuk menambahkan lebih banyak informasi tentang konten Anda sehingga dapat memperbaiki pengalaman pengguna.
Entitas DataFeed
Setiap file feed data schema.org yang dikirimkan ke Google harus berisi satu entitas
DataFeed
di tingkat akar. Semua entitas
Book
dan
Library
harus dicantumkan dalam kolom
dataFeedElement
pada entitas DataFeed
.
Properti yang didukung Google adalah sebagai berikut:
Properti wajib | |
---|---|
@context |
Tetapkan ke |
@type |
Tetapkan ke |
dataFeedElement |
Tetapkan ke entitas
Contoh penggunaan dalam feed { "@context": "https://schema.org", "@type": "DataFeed", "dataFeedElement": [ { "@context": "https://schema.org", "@type": "Book", "@id": "https://example.com/work/the_catcher_in_the_rye", "url": "https://example.com/work/the_catcher_in_the_rye", "name": "The Catcher in the Rye", "author": { "@type": "Person", "name": "J.D. Salinger" }, "sameAs": "https://en.wikipedia.org/wiki/The_Catcher_in_the_Rye", "workExample": [ { "@type": "Book", "@id": "https://example.com/edition/the_catcher_in_the_rye_paperback", "isbn": "9787543321724", "bookEdition": "Mass Market Paperback", "bookFormat": "https://schema.org/Paperback", "inLanguage": "en", ... }, ... ] } ], "dateModified": "2018-09-10T13:58:26.892Z" } Contoh penggunaan dalam feed { "@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 |
Tanggal dan waktu pembaruan feed terakhir dalam format ISO 8601. |
Entitas Book
Meskipun definisi lengkap Book
tersedia di
schema.org/Book,
Anda hanya wajib mempertimbangkan properti berikut. Anda harus menentukan properti yang diperlukan untuk
setiap buku yang Anda pilih agar disertakan dalam feed. Anda juga dapat menentukan properti yang disarankan untuk
menambahkan lebih banyak informasi tentang konten Anda sehingga dapat memperbaiki pengalaman pengguna.
Book
(Work
)
Entitas Book
ini adalah jenis entitas level atas. Entitas ini mewakili karya.
Properti yang didukung Google adalah sebagai berikut:
Properti wajib | |
---|---|
@context |
Tetapkan ke |
@id |
ID unik global buku dalam format URL. ID ini harus unik menurut
organisasi Anda. ID harus stabil dan tidak berubah dari waktu ke waktu. Format URL disarankan
meskipun tidak wajib. Format URL ini tidak harus berupa link yang berfungsi. Domain yang digunakan untuk nilai
|
@type |
Tetapkan ke |
author |
Penulis buku. |
name |
Judul buku. |
url |
URL di situs tempat buku tersebut diperkenalkan atau dijelaskan. Link ini membantu
merekonsiliasi konten di feed Anda dengan konten di
database Google secara akurat. Link ini bisa sama dengan Untuk halaman landing yang sebenarnya, Google Penelusuran menggunakan URL yang disediakan di
|
workExample |
Edisi karya. |
Properti yang direkomendasikan | |
---|---|
sameAs |
URL halaman referensi yang mengidentifikasi karya. Misalnya, halaman tentang buku tersebut di Wikipedia, Wikidata, VIAF, atau Perpustakaan Kongres. |
Book
(Edition
)
Properti workExample
menggunakan entitas Book
ini. Properti ini mewakili
edisi dari suatu karya.
Properti yang didukung Google adalah sebagai berikut:
Properti wajib | |
---|---|
@id |
ID unik global buku dalam format URL. ID ini harus unik menurut
organisasi Anda. ID harus stabil dan tidak berubah dari waktu ke waktu. Format URL disarankan
meskipun tidak wajib. Format URL ini tidak harus berupa link yang berfungsi. Domain yang digunakan untuk nilai
|
@type |
Tetapkan ke |
bookFormat |
Format edisi. Nilai ini harus berupa salah satu di antara yang berikut ini:
|
inLanguage |
Bahasa utama konten edisi tersebut. Gunakan salah satu kode dua huruf dari daftar kode ISO 639-1 alpha-2. |
isbn |
ISBN-13 edisi tersebut. Jika Anda memiliki ISBN-10, ubah menjadi ISBN-13. |
potentialAction |
Tindakan yang akan dipicu agar pengguna membeli atau mendownload buku. Untuk detail
selengkapnya, lihat |
Properti yang direkomendasikan | |
---|---|
author |
Pengarang edisi. |
bookEdition |
Informasi edisi buku. Contoh, |
datePublished |
Tanggal publikasi edisi dalam format YYYY-MM-DD atau YYYY. Ini dapat berupa tanggal tertentu atau hanya tahun tertentu. |
identifier |
ID eksternal atau ID lain yang secara jelas menunjukkan edisi ini. Beberapa
ID diizinkan. Untuk detail selengkapnya, lihat
Properti ini dapat diulang. |
name |
Judul edisi. Hanya gunakan ini jika judul edisi berbeda dengan judul karya. |
sameAs |
URL halaman web referensi yang secara jelas menunjukkan edisi ini. Misalnya,
halaman tentang edisi khusus ini di Wikipedia. Jangan gunakan kembali
|
url |
URL di situs tempat edisi tersebut diperkenalkan atau dijelaskan. URL ini dapat
sama dengan |
Contoh 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": {...} }
Contoh Book
(Edition
) dengan beberapa properti 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
atau Organization
(author
)
Properti author
buku menggunakan entitas
Person
atau Organization
.
Properti wajib | |
---|---|
@type |
Tetapkan ke |
name |
Nama orang atau organisasi. |
Properti yang direkomendasikan | |
---|---|
sameAs |
URL halaman web referensi yang secara jelas menunjukkan identitas orang atau organisasi. Misalnya, halaman tentang pengarang atau organisasi di Wikipedia. |
Contoh author
:
"author": { "@type": "Person", "name": "William Shakespeare" }
Contoh dengan beberapa properti author
:
"author": [ { "@type": "Person", "name": "William Shakespeare" }, { "@type": "Person", "name": "Victor Hugo", "sameAs": "https://en.wikipedia.org/wiki/Victor_Hugo" } ]
PropertyValue (ID)
Properti identifier
dari Edition
menggunakan
entitas PropertyValue
.
Properti wajib | |
---|---|
@type |
Tetapkan ke |
propertyID |
Jenis ID. Seperti yang dijelaskan dalam ISBN dan ID lainnya yang didukung, ID harus salah satu di antara yang berikut ini:
|
value |
Nilai ID. ID eksternal yang secara jelas menunjukkan edisi ini. Hapus semua awalan non-numerik pada ID eksternal. |
Contoh identifier
:
"identifier": { "@type": "PropertyValue", "propertyID": "OCLC_NUMBER", "value": "110123456" }
Contoh dengan beberapa properti identifier
:
"identifier": [ { "@type": "PropertyValue", "propertyID": "OCLC_NUMBER", "value": "110123456" }, { "@type": "PropertyValue", "propertyID": "LCCN", "value": "220123456" },{ "@type": "PropertyValue", "propertyID": "JP_E-CODE", "value": "12345678901234567890" }]
Contoh file JSON feed ReadAction
Book
{ "@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" }
Contoh file JSON feed BorrowAction
Book
{ "@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
)
Properti potentialAction
menggunakan entitas ReadAction
.
ReadAction
menentukan deep link Anda untuk mengakses buku, retailer yang mendistribusikan
buku, dan kriteria yang harus dipenuhi pengguna. Kriteria dapat mencakup status keanggotaan,
status login, lokasi, atau hal lain yang diperlukan untuk mengakses buku.
Properti wajib | |
---|---|
@type |
Tetapkan ke |
expectsAcceptanceOf |
Definisi persyaratan pengguna untuk mengakses entitas ini. Jika terdapat beberapa properti
Properti ini dapat diulang. |
expectsAcceptanceOf.@type |
Tetapkan ke |
expectsAcceptanceOf.category |
Jenis
|
expectsAcceptanceOf.eligibleRegion |
Negara yang memenuhi syarat untuk Properti ini dapat diulang. |
expectsAcceptanceOf.eligibleRegion.@type |
Tetapkan ke |
expectsAcceptanceOf.eligibleRegion.name |
Kode negara ISO 3166-1 alpha-2. |
target |
Spesifikasi deep link Anda yang mencakup informasi platform yang
didukung. Terdapat beberapa properti Properti ini dapat diulang. |
target.@type |
Tetapkan ke |
target.actionPlatform |
Platform tempat deep link ini valid. Gunakan salah satu nilai berikut:
Properti ini dapat diulang. |
target.urlTemplate |
Link ini langsung mengarahkan pengguna ke konten halaman landing buku Anda. |
Properti yang direkomendasikan | |
---|---|
expectsAcceptanceOf.availabilityEnds |
Waktu berakhir untuk jendela ketersediaan. Ini dapat digunakan untuk mengontrol waktu yang tepat kapan buku ini tidak lagi ditampilkan kepada pengguna. |
expectsAcceptanceOf.availabilityStarts |
Waktu mulai untuk jendela ketersediaan. Ini dapat digunakan untuk mengontrol waktu yang tepat kapan buku ini dapat ditampilkan kepada pengguna. |
expectsAcceptanceOf.price |
Harga pembelian buku. Ini diperlukan saat properti |
expectsAcceptanceOf.priceCurrency |
Mata uang harga dalam format ISO 4217 tiga huruf. |
Contoh 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" } } }
Contoh ReadAction
dengan beberapa properti 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
)
Properti potentialAction
menggunakan entitas BorrowAction
.
BorrowAction
menentukan deep link untuk mengakses buku, perpustakaan yang menyediakan
buku, dan kriteria yang harus dipenuhi pengguna. Kriteria dapat mencakup status keanggotaan,
status login, lokasi, atau hal lain yang diperlukan untuk mengakses buku.
Properti wajib | |
---|---|
@type |
Tetapkan ke |
lender |
Sistem perpustakaan yang menyediakan akses ke edisi ini. |
lender.@id |
Referensi ID |
lender.@type |
Tetapkan ke |
target |
Spesifikasi deep link Anda yang mencakup informasi platform yang
didukung. Guna menentukan deep link untuk kumpulan platform yang berbeda, tentukan
array Properti ini dapat diulang. |
target.@type |
Tetapkan ke |
target.actionPlatform |
Platform tempat deep link ini valid. Gunakan salah satu nilai berikut:
Properti ini dapat diulang. |
target.urlTemplate |
Link ini langsung mengarahkan pengguna ke konten halaman landing buku Anda. |
Contoh 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" ] } }
Contoh BorrowAction
dengan beberapa properti 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" ] } ] }
Entitas Library
Meskipun definisi lengkap Library
tersedia di
schema.org/Library,
Anda hanya wajib mempertimbangkan properti berikut. Anda harus menentukan properti yang
diperlukan untuk setiap perpustakaan yang dipilih untuk disertakan dalam feed.
Anda juga dapat menentukan properti yang disarankan untuk menambahkan lebih banyak informasi tentang
konten Anda sehingga dapat memperbaiki pengalaman pengguna.
Entitas Library
ini adalah jenis entitas Library
level atas. Ini adalah konstruksi abstrak, yang terdiri dari entitas
LibrarySystem
dan setiap entitas
Library (member)
level bawah dari
LibrarySystem
tersebut.
Feed Library
berbeda dengan feed Book
. Oleh karena itu, setiap feed Library
yang mungkin Anda terapkan harus sepenuhnya terpisah dari feed Book
.
Untuk informasi selengkapnya, lihat
Membuat feed.
LibrarySystem
Entitas LibrarySystem
mewakili jaringan
kolaboratif anggota perpustakaan.
Properti wajib | |
---|---|
@context
|
Text
Tetapkan ke |
@id
|
URL
ID unik global untuk sistem perpustakaan dalam format
URL. ID harus stabil dan tidak berubah dari waktu ke waktu. ID ini diperlakukan
sebagai string buram dan tidak harus berupa link yang berfungsi. Domain
yang digunakan untuk nilai |
@type
|
Text
Tetapkan ke |
additionalProperty
|
PropertyValue
Properti tambahan yang digunakan untuk menunjukkan jenis perpustakaan. |
additionalProperty.@type
|
Text
Tetapkan ke |
additionalProperty.name
|
Text
Tetapkan ke |
additionalProperty.value
|
Text
Jenis perpustakaan. Gunakan salah satu nilai berikut:
|
member
|
Library
Anggota sistem perpustakaan. |
name
|
Text
Nama sistem perpustakaan. Contoh,
|
url
|
URL
URL tempat sistem perpustakaan diperkenalkan atau
dijelaskan. Google Penelusuran menggunakan link ini untuk merekonsiliasi konten di
feed Anda dengan konten di database Google. Untuk halaman landing yang
sebenarnya, Google Penelusuran menggunakan URL yang disediakan di
|
Library
(member
)
Properti member
dari entitas LibrarySystem
menggunakan entitas Library (member)
.
Library (member)
mewakili anggota perpustakaan tunggal dari sistem
perpustakaan tertentu.
Properti wajib | |
---|---|
@id
|
URL
ID unik global untuk cabang perpustakaan dalam format
URL. ID harus stabil dan tidak berubah dari waktu ke waktu. ID ini diperlakukan
sebagai string buram dan tidak harus berupa link yang berfungsi. Domain
yang digunakan untuk nilai |
@type
|
Text
Tetapkan ke |
location
|
PostalAddress
Alamat cabang perpustakaan. Tidak semua properti berlaku untuk setiap negara. Anda harus menyertakan informasi sebanyak mungkin yang relevan untuk alamat perpustakaan Anda. Contoh Amerika Serikat { "@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" } } Contoh Jepang { "@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
Tetapkan ke |
location.addressCountry
|
Text
Kode negara dalam format
ISO 3166-1. Contoh, |
location.addressLocality
|
Text
Lokalitas. Contoh,
|
location.addressRegion
|
Text
Wilayah. Contoh, |
location.postalCode
|
Text
Kode pos. Contoh,
|
location.streetAddress
|
Text
Alamat. Contoh,
|
name
|
Text
Nama cabang perpustakaan. |
Contoh file JSON feed LibrarySystem
{ "@context": "https://schema.org", "@type":"LibrarySystem", "@id":"https://example.com/library-systems/100", "name":"Santa Clara County Library District", "additionalProperty":[ { "@type":"PropertyValue", "name":"librarytype", "value":"public" } ], "member":[ { "@type":"Library", "@id":"https://example.com/library-branches/1001", "name":"Campbell Library", "location":{ "@type":"PostalAddress", "streetAddress":"77 Harrison Ave", "addressLocality":"Campbell", "addressRegion":"CA", "postalCode":"95008", "addressCountry":"US" } }, { "@type":"Library", "@id":"https://example.com/library-branches/1002", "name":"Gilroy Library", "location":{ "@type":"PostalAddress", "streetAddress":"350 W 6th St", "addressLocality":"Gilroy", "addressRegion":"CA", "postalCode":"95020", "addressCountry":"US" } } ] }