اقدامات رزرو (Book
) داده های ساخت یافته
اقدامات کتاب، جستجوی Google را به نقطه ورودی برای کشف کتابها و نویسندگان تبدیل میکند. این را قادر می سازد
کاربران را جستجو کنید تا کتابهایی را که مستقیماً از نتایج جستجو پیدا میکنند، سریع بخرند یا قرض بگیرند.
به عنوان مثال، کاربر می تواند وب شارلوت را جستجو کند و نتایجی به او ارائه شود که
به آنها اجازه دهید کتاب را بخرند یا امانت بگیرند. بهعنوان ارائهدهنده کتاب، میتوانید فید دادهها را در اختیار Google قرار دهید
با طرح داده های ساخت یافته ارائه شده در اینجا. مشخصات ما فراهم می کند
ReadAction
به کاربران اجازه خرید کتاب و BorrowAction
برای قرض گرفتن
یک کتاب.
![یک اقدام کتاب در نتایج جستجو](/static/search/docs/images/books01.png)
خواندن اقدامات و قرض گرفتن اقدامات، که در پانل گنجانیده شده است، نمایش گزینه های به کتاب را بخرید یا امانت بگیرید از طریق پیوندهایی که ارائه می دهید، اقدامات خواندن و اقدامات قرض گرفته شده را به کاربران ارسال می کنند مستقیماً از پانل دانش و سایر سطوح Google به صفحه کتاب در وب سایت شما یا برنامه
ترتیب ارائه دهندگان در پانل دانش برای هر کاربر شخصی و پویا است. این به این معنی که کاربران مختلف سفارش های متفاوتی را می بینند و یک کاربر ممکن است سفارش های متفاوتی را ببیند در زمان های مختلف عوامل مختلفی وجود دارد که بر یک سفارش خاص تأثیر می گذارد. مثلا، اگر کاربر اغلب روی پیوند ارائهدهنده در پانل دانش کلیک کند، آن ارائهدهنده بیشتر است احتمالاً در یک سفارش بالاتر قرار می گیرد. هیچ راهی برای کنترل سفارش وجود ندارد.
شروع کنید
برای اجرای موفقیت آمیز اقدامات Book، باید فید خود را مطابق با Book بسازید اقدامات تعریف نوع داده ساختاریافته، اما ابتدا بخش های زیر را مرور کنید:
- رهنمودها
- فید خود را ایجاد کنید
- فید خود را با داده تست کنید ابزار اعتبارسنجی فید
- فایل فید خود را میزبانی کنید
- فایل فید خود را برای بررسی ارسال کنید
- در صورت نیاز فید خود را به روز کنید
رهنمودها
برای اطمینان از اینکه کتابهای شما میتوانند به طور قابل اعتماد در جستجو ظاهر شوند، مهم است که شما آشنایی با جزئیات مهم و مفاهیم کلیدی علاوه بر این، فید شما باید برخی از آنها را برآورده کند مشخصات فرمت استاندارد
برای کمک به شما در انجام این کار، دستورالعملهای شرح داده شده در اینجا، علاوه بر موارد زیر را دنبال کنید دستورالعمل های کلی داده های ساختاریافته و موارد ضروری جستجو. دستورالعمل ها به شرح زیر است:
آثار و نسخه ها
در سراسر این مستندات، وقتی در مورد یک کتاب صحبت می کنیم از دو اصطلاح متمایز استفاده می کنیم:
- کار: مفهوم انتزاعی یک کتاب. به طور خاص، ابرداده مانند عنوان، نویسنده، و زبان اصلی ویژگی های یک اثر هستند.
- نسخه: نسخه ای ملموس از کتاب. به طور خاص، ابرداده مانند سال انتشار، نام نسخه و شماره استاندارد بین المللی کتاب (ISBN) می باشد ویژگی های نسخه.
به عنوان مثال، وب شارلوت یک کاروب شارلوت ممکن است دارای چاپ اول و دوم باشد. نسخه، نسخه خلاصه شده، نسخه ترجمه فرانسوی، و غیره.
این تمایز به ویژه در فید که ممکن است فوراً نباشد، مهم است
واضح. دو Book
موجودیت وجود دارد:
Book
(Work
) "سطح بالا"Book
وجود، موجودیت:workExample
یک ویژگی ازWork
است و یک و تنها را مشخص می کند یک نمونه ازBook
(Edition
).- برای هر باید حداقل یک
workExample
وجود داشته باشد.Work
Book
(Edition
) "سطح پایینتر"Book
موجودیت.
به یاد داشته باشید که ممکن است چندین نسخه از یک اثر وجود داشته باشد. ما به شما توصیه می کنیم تا حد امکان این نسخه ها را با هم گروه بندی کنید. این به سیستمهای Google کمک میکند تا از همه آنها استفاده کنند اطلاعات مربوط به یک کتاب و ارائه آن در جستجو. اگر مجبور باشید، می توانید بشکنید آنها را به چندین سوابق کاری تبدیل می کنند، اما هر سابقه کاری باید دارای موارد زیر باشد:
- یک
@id
متفاوت. - حداقل یک نسخه با ISBN یا شناسه پشتیبانی شده دیگر.
سیستم های کتابخانه و اعضای کتابخانه
Library entity
است
«سطح بالا» Library
نوع موجودیت. این یک ساختار انتزاعی است که شامل
موجودیت LibrarySystem
و هر یک از "سطح پایین تر"
Library (member)
موجودیت آن سیستم کتابخانه.
موجودیت LibrarySystem
یک انتزاع است و نشان دهنده یک مشارکت است
شبکه کتابخانه اعضا. به عنوان مثال، کتابخانه عمومی آستین را می توان به عنوان یک مشخص کرد
LibrarySystem
موجودیت. Austin Public
وب سایت کتابخانه خود را به عنوان یک کتابخانه عمومی سیستم معرفی می کند که به آستین خدمت می کند،
تگزاس. این شامل 20 کتابخانه وابسته به آنها یا عضو کتابخانه است.
هر موجودیت LibrarySystem
حداقل به یک Library (member)
نیاز دارد
موجودیت، حتی اگر در زندگی واقعی کتابخانه بخشی از هیچ سیستم کتابخانه ای نباشد. در این سناریو،
برای هدف اجرای Book Action، کتابخانه تنها کتابخانه است
عضو کتابخانه سیستم خود. به منظور اقدام کتاب
پیاده سازی، برخلاف یک کتابخانه سیستم، یک کتابخانه عضو' یک انتزاع
و بنابراین دارای یک آدرس فیزیکی است.
برعکس، هر موجود Library (member)
باید حداقل به یکی تعلق داشته باشد
LibrarySystem
موجودیت.
ISBN و سایر شناسه های پشتیبانی شده
ISBN سیگنال اصلی آشتی هنگام Google است جستجو دادههای فید شما را با دادههای Google مطابقت میدهد. شما باید یک ISBN یا سایر موارد پشتیبانی شده ارائه دهید شناسه همه کتابهایی که میخواهید در نتایج جستجو ظاهر شوند. بدون آن، این است احتمالاً کتابهای شما با هم مطابقت ندارند و در نتیجه ارائه نمیشوند.
جستجوی Google ISBN-13 را ترجیح می دهد، اما می توانید موارد زیر را ارائه دهید:
- شماره مرکز کتابخانه کامپیوتر آنلاین (OCLC).
- شماره کنترل کتابخانه کنگره (LCCN)
- کد الکترونیکی JP
پیوندها
برای اطمینان از اینکه مردم بهترین تجربه را در یافتن کتابهای شما دارند، پیوندهای موجود در فید شما باید دستورالعمل های زیر را رعایت کنید:
- اگر صفحات تکراری برای همان محتوا دارید، پیوند باید همان باشد نشانی اینترنتی متعارف که حاوی عنوان کتاب و کتاب دیگر است اطلاعات.
- پس از اینکه کاربر روی یک اقدام خواندن یا پیوند اقدام قرض گرفته کلیک کرد، کاربر باید به صفحه ای فرستاده شود که مستقیماً از خرید یا امانت گرفتن کتاب پشتیبانی می کند. به طور خاص، اشاره نکنید پیوندهای عملی به صفحات با پیوندهای بیشتر که برای خرید یا قرض گرفتن باید روی آنها کلیک کنید محتوای. برای مثال، افراد را به صفحه نتایج جستجو یا خلاصه محصول نفرستید صفحه
فید خود را ایجاد کنید
اگر سایت شما کتاب هایی را برای خرید کاربران می فروشد، باید کتاب خود را آپلود کنید
فید
Book
. با نماینده Google خود تماس بگیرید
و جزئیات مربوط به نحوه و مکان آپلود فید خود را تأیید کنید.
اگر سایت شما کتاب هایی را به کاربران قرض می دهد، باید دو فید جداگانه آپلود کنید:
Book
فید و شما
فید
Library
. با گوگل خود تماس بگیرید
نماینده و جزئیات مربوط به نحوه و مکان آپلود فید خود را تأیید کنید.
به اندازه فایل فید پایبند باشید،
مقدار، و قالب مورد نیاز
الزامات به شرح زیر است:
- اندازه فایل فید مورد نیاز:
- اندازه فایل فید فشرده نشده باید کمتر از 1 گیگابایت باشد.
- فایل فید که باید فشرده شود باید کمتر از 1 گیگابایت باشد. اگر شما فایل فید فشرده نشده بیش از 1 گیگابایت است، باید فایل فید فشرده نشده را تقسیم کنید در چندین فایل
- می توانید فایل های فید را فشرده کنید. آنها باید به صورت zip، gz، tar، tar.gz، JAR، فرمت شوند. ar، arj، cpio، یا فایل بایگانی را تخلیه کنید.
- اگر چندین فایل فید دارید، می توانید آنها را همانطور که هست آپلود کنید، یا اگر ترجیح می دهید، می توانید آنها را به عنوان بخشی از a فایل فهرست نقشه سایت.
- فایلهای فید منفرد باید دارای پسوند
.json
نام فایل باشند.
به الزامات محتوای فید پایبند باشید
به خصوص از الزامات محتوای فید زیر که باید رعایت کنید آگاه باشید:
- فید نباید دارای موجودات قدیمی باشد. موجودات قدیمی موجوداتی هستند با
availabilityEnds
را روی تاریخی تنظیم کنید که گذشته است یا نهادهایی که دیگر نیستند در سایت شما موجود است. - همه پیوندهای عمیق، مانند
urlTemplate
، و همه URL ها، مانندurl
، که در فید خود قرار می دهید باید نشانی وب تولید باشد. از QA استفاده نکنید، توسعه یا هر نوع URL غیر تولیدی دیگری. - همه URL ها، مانند
url
، باید باشند متعارف. - هر موجودی در فید شما باید ویژگی های زیر را مشخص کند:
- شناسه منحصر به فرد:
@id
- یک URL منحصر به فرد:
url
- یک پیوند عمیق منحصر به فرد:
urlTemplate
- شناسه منحصر به فرد:
فید خود را با Data Feed تست کنید ابزار اعتبارسنجی
ما مراحل عیبیابی زیر را برای رفع خطاها و هشدارهای رایج توصیه میکنیم در ابزار اعتبارسنجی فید داده:
-
مطمئن شوید که گزینه صحیح را در قسمت تأیید در انتخاب کرده اید. اقدام کتاب را برای موجودیت
Book
انتخاب کنید. - بررسی کنید که مقدار
@type
به درستی نوشته شده باشد. - مطمئن شوید که مقدار
@context
به درستی تنظیم شده باشد. تنظیم"@context": "https://schema.org"
برای هر دوReadAction
وBorrowAction
.
فایل فید خود را میزبانی کنید
وقتی فایل فید شما آماده شد، آن را در مکانی امن میزبانی کنید. گوگل فید را واکشی می کند به طور منظم برای اطمینان از به روز بودن محتوای شما.
روش های میزبان
روش های میزبانی فید زیر پشتیبانی می شوند:
میزبانی | پشتیبانی از احراز هویت | |
---|---|---|
Google Cloud Storage | مجوز Storage Object Viewer | |
HTTPS | نام کاربری + رمز عبور یا گواهی نامه های سرویس گیرنده HTTP | |
SFTP | رمز عبور، کلید + عبارت یا هر دو | |
AWS S3 | شناسه کلید + کلید دسترسی |
فایل فید خود را برای بررسی ارسال کنید
برای اینکه محتوای شما در جستجوی Google در دسترس باشد، یک تیم پشتیبانی Google آن را بررسی میکند کیفیت پیوندهای عمیق در فید شما ما قویاً توصیه می کنیم که برخی از آنها را به صورت دستی آزمایش کنید پیوندهای عمیق برای تأیید اینکه آیا آنها صفحه ای را باز می کنند که در آن کاربران می توانند خرید یا قرض بگیرند کتاب ها
برای درخواست بازبینی فید خود، موارد زیر را ارائه دهید:
- مکان میزبان: آدرس فایل فید شما.
- احراز هویت میزبان، در صورت وجود: اعتبارنامه احراز هویت مجاز است Google برای دریافت فایل فید از مکان میزبان شما.
در صورت نیاز فید خود را به روز کنید
توصیه میکنیم روزانه فید خود را بهروزرسانی کنید، اما این در نهایت به تعداد دفعات شما بستگی دارد تغییرات کاتالوگ از شرایط و نکات زیر آگاه باشید:
- جستجوی Google از بهروزرسانیهای همزمان پشتیبانی نمیکند.
- جستجوی Google یک بار در روز فید شما را دریافت می کند و معمولاً محتوا را ظرف دو روز فهرست می کند.
- اگر تغییر قابل پیش بینی در در دسترس بودن نسخه وجود دارد، استفاده کنید
availabilityStarts
وavailabilityEnds
برای تعیین تاریخ های دقیق اگر نهاد دیگر در دسترس نیست، آن را به طور کامل حذف کنید
تعاریف نوع داده های ساخت یافته
برای اینکه محتوای شما واجد شرایط باشد، باید ویژگی های مورد نیاز فهرست شده در اینجا را وارد کنید نمایش در نتایج جستجوی ساختاریافته همچنین میتوانید ویژگیهای پیشنهادی را برای اضافه کردن اضافه کنید اطلاعات بیشتر در مورد محتوای شما، که می تواند تجربه کاربری بهتری را ارائه دهد.
موجودیت DataFeed
هر فایل فید داده schema.org که به Google تحویل داده می شود باید دارای یک موجودیت واحد باشد
DataFeed
در سطح ریشه. همه
Book
و
Library
نهادها باید در زیر فهرست شوند
فیلد
dataFeedElement
موجودیت DataFeed
.
ویژگی های پشتیبانی شده توسط Google به شرح زیر است:
خواص مورد نیاز | |
---|---|
@context |
تنظیم به |
@type |
تنظیم به |
dataFeedElement |
تنها را روی یکی تنظیم کنید
مثال استفاده در فید { مثال استفاده در فید { |
dateModified |
تاریخ و زمان آخرین به روز رسانی فید در قالب ISO 8601. |
Book
وجود، موجودیت
در حالی که تعریف کامل Book
در دسترس است
schema.org/Book، شما
فقط باید ویژگی های زیر را در نظر بگیرید. شما باید ویژگی های مورد نیاز را برای
هر کتابی که انتخاب می کنید در فید خود بگنجانید. شما همچنین می توانید ویژگی های توصیه شده را تعریف کنید
اطلاعات بیشتری در مورد محتوای خود اضافه کنید، که می تواند تجربه کاربری بهتری را ارائه دهد.
Book
(Work
)
این Book
نوع موجودیت سطح بالا است. این یک کار را نشان می دهد.
ویژگی های پشتیبانی شده توسط Google به شرح زیر است:
خواص مورد نیاز | |
---|---|
@context |
تنظیم به |
@id |
شناسه منحصر به فرد جهانی کتاب در قالب URL. باید منحصر به فرد شما باشد
سازمان. شناسه باید ثابت باشد و در طول زمان تغییر نکند. فرمت URL پیشنهاد شده است
هر چند لازم نیست این نباید یک پیوند کاری باشد. دامنه مورد استفاده برای
ارزش
|
@type |
تنظیم به |
author |
نویسنده (نویسندگان) کتاب. |
name |
عنوان کتاب. |
url |
URL موجود در وب سایت شما که کتاب در آن معرفی یا توصیف شده است. این لینک کمک می کند
محتوای موجود در فید خود را با محتوای Google's به طور دقیق تطبیق دهید
پایگاه های داده می تواند مانند برای صفحه فرود واقعی، جستجوی Google از URL ارائه شده در آن استفاده می کند
|
workExample |
ویرایش(های) اثر. |
خواص توصیه شده | |
---|---|
sameAs |
URL صفحه مرجعی که کار را مشخص می کند. به عنوان مثال، ویکی پدیا، صفحه ویکی داده، VIAF یا کتابخانه کنگره برای کتاب. |
Book
(Edition
)
ویژگی workExample
از این موجودیت Book
استفاده می کند. نشان دهنده یک
نسخه یک کار.
ویژگی های پشتیبانی شده توسط Google به شرح زیر است:
خواص مورد نیاز | |
---|---|
@id |
شناسه منحصر به فرد جهانی کتاب در قالب URL. باید منحصر به فرد شما باشد
سازمان. شناسه باید ثابت باشد و در طول زمان تغییر نکند. فرمت URL پیشنهاد شده است
هر چند لازم نیست این نباید یک پیوند کاری باشد. دامنه مورد استفاده برای
ارزش
|
@type |
تنظیم به |
bookFormat |
قالب نسخه. ارزش این باید یکی از ذیل:
|
inLanguage |
زبان اصلی محتوا در نسخه. از یکی از کدهای دو حرفی استفاده کنید از لیست کدهای ISO 639-1 آلفا-2. |
isbn |
ISBN-13 نسخه. اگر ISBN-10 دارید، آن را به ISBN-13 تبدیل کنید. |
potentialAction |
اقدامی که برای خرید یا دانلود کتاب توسط کاربران انجام می شود. برای بیشتر
جزئیات، به |
خواص توصیه شده | |
---|---|
author |
نویسنده (نویسندگان) نسخه. |
bookEdition |
اطلاعات ویرایش کتاب. برای مثال، |
datePublished |
تاریخ انتشار نسخه درYYYY-MM-DDیاYYYY قالب این می تواند یک تاریخ خاص یا فقط یک سال خاص باشد. |
identifier |
شناسه خارجی یا شناسه دیگری که به طور واضح این نسخه را شناسایی می کند. چندگانه
شناسه مجاز است برای جزئیات بیشتر مراجعه کنید
این خاصیت قابل تکرار است. |
name |
عنوان نسخه. فقط زمانی از این استفاده کنید که عنوان نسخه متفاوت باشد از عنوان اثر |
sameAs |
URL یک صفحه وب مرجع که به طور واضح نسخه را نشان می دهد. برای
به عنوان مثال، یک صفحه ویکی پدیا برای این نسخه خاص. از آن استفاده مجدد نکنید
|
url |
URL موجود در وب سایت شما که نسخه معرفی یا توصیف شده است. می تواند باشد
مانند |
مثال 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": {...}
}
مثال Book
(Edition
) با چندین ویژگی 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
یا Organization
(author
)
ویژگی author
کتاب از
Person
یا Organization
موجودیت.
خواص توصیه شده | |
---|---|
sameAs |
نشانی اینترنتی یک صفحه وب مرجع که به طور واضح شخص یا هویت سازمان به عنوان مثال، یک صفحه ویکی پدیا برای شخص یا سازمان. |
مثال author
:
"author": {
"@type": "Person",
"name": "William Shakespeare"
}
مثالی با چندین ویژگی author
:
"author": [
{
"@type": "Person",
"name": "William Shakespeare"
},
{
"@type": "Person",
"name": "Victor Hugo",
"sameAs": "https://en.wikipedia.org/wiki/Victor_Hugo"
}
]
PropertyValue (شناسه)
ویژگی identifier
Edition
از PropertyValue
استفاده می کند
موجودیت.
خواص مورد نیاز | |
---|---|
@type |
تنظیم به |
propertyID |
نوع شناسه. همانطور که در ISBN و سایر موارد پشتیبانی شده است شناسه، باید یکی از موارد زیر باشد:
|
value |
مقدار شناسه شناسه خارجی که بدون ابهام این نسخه را شناسایی می کند. همه را حذف کنید پیشوندهای غیر عددی شناسه خارجی. |
مثال identifier
:
"identifier": {
"@type": "PropertyValue",
"propertyID": "OCLC_NUMBER",
"value": "110123456"
}
مثالی با چندین ویژگی identifier
:
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "OCLC_NUMBER",
"value": "110123456"
},
{
"@type": "PropertyValue",
"propertyID": "LCCN",
"value": "220123456"
},{
"@type": "PropertyValue",
"propertyID": "JP_E-CODE",
"value": "12345678901234567890"
}]
مثال ReadAction
Book
فید فایل JSON
{
"@context": "https://schema.org",
"@type": "DataFeed",
"dataFeedElement": [
{
"@context": "https://schema.org",
"@type": "Book",
"@id": "https://example.com/work/the_catcher_in_the_rye",
"url": "https://example.com/work/the_catcher_in_the_rye",
"name": "The Catcher in the Rye",
"author": {
"@type": "Person",
"name": "J.D. Salinger"
},
"sameAs": "https://en.wikipedia.org/wiki/The_Catcher_in_the_Rye",
"workExample": [
{
"@type": "Book",
"@id": "https://example.com/edition/the_catcher_in_the_rye_paperback",
"isbn": "9787543321724",
"bookEdition": "Mass Market Paperback",
"bookFormat": "https://schema.org/Paperback",
"inLanguage": "en",
"url": "https://example.com/edition/the_catcher_in_the_rye_paperback",
"datePublished": "1991-05-01",
"identifier": {
"@type": "PropertyValue",
"propertyID": "OCLC_NUMBER",
"value": "1057320822"
},
"potentialAction": {
"@type": "ReadAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://example.com/store/9787543321724",
"actionPlatform": [
"https://schema.org/DesktopWebPlatform",
"https://schema.org/AndroidPlatform",
"https://schema.org/IOSPlatform"
]
},
"expectsAcceptanceOf": {
"@type": "Offer",
"category": "purchase",
"price": 6.99,
"priceCurrency": "USD",
"availabilityStarts": "2020-01-01T11:0:00-04:00",
"availabilityEnds": "2050-06-30T23:59:00-04:00",
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
}
}
},
{
"@type": "Book",
"@id": "https://example.com/edition/the_catcher_in_the_rye_hardcover",
"isbn": "9780316769532",
"bookEdition": "Hardcover",
"bookFormat": "https://schema.org/Hardcover",
"inLanguage": "en",
"url": "https://example.com/edition/the_catcher_in_the_rye_hardcover",
"datePublished": "1951-07-16",
"potentialAction": {
"@type": "ReadAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://example.com/store/9780316769532",
"actionPlatform": [
"https://schema.org/DesktopWebPlatform",
"https://schema.org/AndroidPlatform",
"https://schema.org/IOSPlatform"
]
},
"expectsAcceptanceOf": [
{
"@type": "Offer",
"category": "nologinrequired",
"availabilityStarts": "2020-01-01T11:0:00-04:00",
"availabilityEnds": "2050-06-30T23:59:00-04:00",
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "GB"
}
]
},
{
"@type": "Offer",
"category": "Subscription",
"availabilityStarts": "2020-01-01T11:0:00-04:00",
"availabilityEnds": "2050-06-30T23:59:00-04:00",
"eligibleRegion": {
"@type": "Country",
"name": "IN"
}
}
]
}
}
]
}
],
"dateModified": "2018-09-10T13:58:26.892Z"
}
مثال BorrowAction
Book
فید فایل JSON
{
"@context": "https://schema.org",
"@type": "DataFeed",
"dataFeedElement": [
{
"@context": "https://schema.org",
"@type": "Book",
"@id": "https://example.com/work/the_catcher_in_the_rye",
"url": "https://example.com/work/the_catcher_in_the_rye",
"name": "The Catcher in the Rye",
"author": {
"@type": "Person",
"name": "J.D. Salinger"
},
"sameAs": "https://en.wikipedia.org/wiki/The_Catcher_in_the_Rye",
"workExample": [
{
"@type": "Book",
"@id": "https://example.com/edition/the_catcher_in_the_rye_paperback",
"isbn": "9787543321724",
"bookEdition": "Mass Market Paperback",
"bookFormat": "https://schema.org/Paperback",
"inLanguage": "en",
"url": "https://example.com/edition/the_catcher_in_the_rye_paperback",
"datePublished": "1991-05-01",
"identifier": {
"@type": "PropertyValue",
"propertyID": "OCLC_NUMBER",
"value": "1057320822"
},
"potentialAction": {
"@type": "BorrowAction",
"lender": {
"@type": "LibrarySystem",
"@id": "https://example.com/librarySystem/100"
},
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://example.com/borrowpurchase?bookId=170",
"actionPlatform": [
"https://schema.org/DesktopWebPlatform",
"https://schema.org/AndroidPlatform",
"https://schema.org/IOSPlatform"
]
}
}
},
{
"@type": "Book",
"@id": "https://example.com/edition/the_catcher_in_the_rye_hardcover",
"isbn": "9780316769532",
"bookEdition": "Hardcover",
"bookFormat": "https://schema.org/Hardcover",
"inLanguage": "en",
"url": "https://example.com/edition/the_catcher_in_the_rye_hardcover",
"datePublished": "1951-07-16",
"potentialAction": {
"@type": "BorrowAction",
"lender": {
"@type": "LibrarySystem",
"@id": "https://example.com/librarySystem/100"
},
"target": [
{
"@type": "EntryPoint",
"urlTemplate": "https://example.com/borrowpurchase?bookId=170",
"actionPlatform": [
"https://schema.org/DesktopWebPlatform"
]
},
{
"@type": "EntryPoint",
"urlTemplate": "https://example.com/mobile/borrowpurchase?bookId=170",
"actionPlatform": [
"https://schema.org/AndroidPlatform",
"https://schema.org/IOSPlatform"
]
}
]
}
}
]
}
],
"dateModified": "2018-09-10T13:58:26.892Z"
}
ReadAction
(potentialAction
)
ویژگی potentialAction
از موجودیت ReadAction
استفاده می کند.
ReadAction
پیوندهای عمیق شما را برای دسترسی به کتاب، خردهفروشی که سهام دارد، تعریف میکند
کتاب و معیارهایی که کاربران باید رعایت کنند. معیارها ممکن است شامل وضعیت عضویت باشد،
وضعیت ورود به سیستم، مکان یا هر چیز دیگری که برای دسترسی به کتاب لازم است.
خواص مورد نیاز | |
---|---|
@type |
تنظیم به |
expectsAcceptanceOf |
تعریف الزامات کاربر برای دسترسی به این موجودیت. اگر چندتایی باشد
این خاصیت قابل تکرار است. |
expectsAcceptanceOf. |
تنظیم به |
expectsAcceptanceOf. |
نوع
|
expectsAcceptanceOf. |
کشوری که واجد شرایط این کار است این خاصیت قابل تکرار است. |
expectsAcceptanceOf. |
تنظیم به |
expectsAcceptanceOf. |
کد کشور ISO 3166-1 alpha-2. |
target |
مشخصات پیوند عمیق شما که شامل پلتفرم پشتیبانی شده است
اطلاعات چندین ویژگی این خاصیت قابل تکرار است. |
target. |
تنظیم به |
target. |
پلتفرم(هایی) که این پیوند عمیق برای آنها معتبر است. از یکی از موارد زیر استفاده کنید ارزش های:
این خاصیت قابل تکرار است. |
target. |
پیوندی که کاربران را مستقیماً به محتوای صفحه فرود کتاب شما می برد. |
خواص توصیه شده | |
---|---|
expectsAcceptanceOf. |
زمان پایان پنجره در دسترس بودن. این می تواند برای کنترل زمان دقیق استفاده شود زمانی که این کتاب دیگر نباید در معرض دید کاربران قرار گیرد. |
expectsAcceptanceOf. |
زمان شروع پنجره در دسترس بودن. این می تواند برای کنترل دقیق استفاده شود زمانی که این کتاب می تواند در معرض دید کاربران قرار گیرد. |
expectsAcceptanceOf. |
قیمت خرید کتاب. زمانی که |
expectsAcceptanceOf. |
واحد پول قیمت در سه حرف ISO قالب 4217. |
مثال 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"
}
}
}
مثال ReadAction
با چندین ویژگی 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
)
ویژگی potentialAction
از موجودیت BorrowAction
استفاده می کند.
BorrowAction
پیوندهای عمیق شما را برای دسترسی به کتاب، کتابخانه ای که موجود است، تعریف می کند
کتاب و معیارهایی که کاربران باید رعایت کنند. معیارها ممکن است شامل وضعیت عضویت باشد،
وضعیت ورود به سیستم، مکان یا هر چیز دیگری که برای دسترسی به کتاب لازم است.
خواص مورد نیاز | |
---|---|
@type |
تنظیم به |
lender |
سیستم کتابخانه ای که دسترسی به این نسخه را فراهم می کند. |
lender.@id |
ارجاع شناسه |
lender.@type |
تنظیم به |
target |
مشخصات پیوند عمیق شما که شامل پلتفرم پشتیبانی شده است
اطلاعات برای تعریف لینک های عمیق برای مجموعه های مختلف پلت فرم، یک را مشخص کنید
این خاصیت قابل تکرار است. |
target. |
تنظیم به |
target. |
پلتفرم(هایی) که این پیوند عمیق برای آنها معتبر است. از یکی از موارد زیر استفاده کنید ارزش های:
این خاصیت قابل تکرار است. |
target. |
پیوندی که کاربران را مستقیماً به محتوای صفحه فرود کتاب شما می برد. |
مثال 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"
]
}
}
مثال BorrowAction
با چندین ویژگی 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"
]
}
]
}
Library
وجود، موجودیت
در حالی که تعریف کامل Library
در دسترس است
schema.org/Library،
فقط باید ویژگی های زیر را در نظر بگیرید. شما باید تعریف کنید
ویژگی های مورد نیاز برای هر کتابخانه ای که انتخاب می کنید در فید خود اضافه کنید.
همچنین می توانید ویژگی های توصیه شده را برای افزودن اطلاعات بیشتر در مورد آن تعریف کنید
محتوای شما، که می تواند تجربه کاربری بهتری را ارائه دهد.
این موجود Library
در سطح بالایی است Library
نوع موجودیت این یک ساختار انتزاعی است که از یک تشکیل شده است
LibrarySystem
موجودیت و هر سطح پایین تر
Library (member)
موجودیت آن
LibrarySystem
.
فید Library
از فید Book
متمایز است. بنابراین، هر Library
فید شما باید کاملاً از فید Book
شما جدا باشد.
برای اطلاعات بیشتر مراجعه کنید
فید خود را ایجاد کنید.
سیستم کتابخانه
موجودیت LibrarySystem
نشان دهنده یک شبکه مشترک است
از کتابخانه اعضا.
خواص مورد نیاز | |
---|---|
@context
|
Text
تنظیم به |
@id
|
URL
شناسه منحصر به فرد جهانی برای سیستم کتابخانه در URL
قالب شناسه باید ثابت باشد و در طول زمان تغییر نکند. درمان می شود
به عنوان یک رشته مات و نیازی به پیوند کاری نیست. را
دامنه استفاده شده برای مقدار |
@type
|
Text
تنظیم به |
additionalProperty
|
PropertyValue
ویژگی اضافی مورد استفاده برای نشان دادن نوع کتابخانه. |
additionalProperty.
|
Text
تنظیم به |
additionalProperty.
|
Text
تنظیم به |
additionalProperty.
|
Text
نوع کتابخانه از یکی از موارد زیر استفاده کنید ارزش های:
|
member
|
Library
اعضاء سیستم کتابخانه |
name
|
Text
نام سیستم کتابخانه. مثلا،
|
url
|
URL
URL که در آن سیستم کتابخانه معرفی شده است یا
شرح داده شده. جستجوی گوگل از این پیوند برای تطبیق محتوای موجود در آن استفاده می کند
فید شما با محتوای موجود در پایگاههای داده Google. برای واقعی
صفحه فرود، جستجوی Google از URL ارائه شده در آن استفاده می کند
|
Library
(member
)
ویژگی member
موجودیت LibrarySystem
از موجودیت Library (member)
استفاده می کند.
Library (member)
یک کتابخانه واحد را نشان می دهد عضو
از یک کتابخانه معین سیستم.
خواص مورد نیاز | |
---|---|
@id
|
URL
یک شناسه منحصر به فرد جهانی برای شاخه کتابخانه در URL
قالب شناسه باید ثابت باشد و در طول زمان تغییر نکند. درمان می شود
به عنوان یک رشته مات و نیازی به پیوند کاری نیست. را
دامنه استفاده شده برای مقدار |
@type
|
Text
تنظیم به |
location
|
PostalAddress
آدرس خیابان شعبه کتابخانه. نه همه خواص برای هر کشور اعمال می شود. باید به تعداد درخواستی اضافه کنید به آدرس کتابخانه های شما مثال ایالات متحده { مثال ژاپن { |
location.
|
Text
تنظیم به |
location.
|
Text
کد کشور در
ISO 3166-1
قالب به عنوان مثال، |
location.
|
Text
محل. مثلا،
|
location.
|
Text
منطقه. برای مثال، |
location.
|
Text
کد پستی. مثلا،
|
location.
|
Text
آدرس خیابان. مثلا،
|
name
|
Text
نام شعبه کتابخانه |
مثال LibrarySystem
فید فایل JSON
{
"@context": "https://schema.org",
"@type":"LibrarySystem",
"@id":"https://example.com/library-systems/100",
"name":"Santa Clara County Library District",
"additionalProperty":[
{
"@type":"PropertyValue",
"name":"librarytype",
"value":"public"
}
],
"member":[
{
"@type":"Library",
"@id":"https://example.com/library-branches/1001",
"name":"Campbell Library",
"location":{
"@type":"PostalAddress",
"streetAddress":"77 Harrison Ave",
"addressLocality":"Campbell",
"addressRegion":"CA",
"postalCode":"95008",
"addressCountry":"US"
}
},
{
"@type":"Library",
"@id":"https://example.com/library-branches/1002",
"name":"Gilroy Library",
"location":{
"@type":"PostalAddress",
"streetAddress":"350 W 6th St",
"addressLocality":"Gilroy",
"addressRegion":"CA",
"postalCode":"95020",
"addressCountry":"US"
}
}
]
}