اقدامات رزرو (Book) داده های ساخت یافته

اقدامات کتاب، جستجوی Google را به نقطه ورودی برای کشف کتاب‌ها و نویسندگان تبدیل می‌کند. این را قادر می سازد کاربران را جستجو کنید تا کتاب‌هایی را که مستقیماً از نتایج جستجو پیدا می‌کنند، سریع بخرند یا قرض بگیرند. به عنوان مثال، کاربر می تواند وب شارلوت را جستجو کند و نتایجی به او ارائه شود که به آنها اجازه دهید کتاب را بخرند یا امانت بگیرند. به‌عنوان ارائه‌دهنده کتاب، می‌توانید فید داده‌ها را در اختیار Google قرار دهید با طرح داده های ساخت یافته ارائه شده در اینجا. مشخصات ما فراهم می کند ReadAction به کاربران اجازه خرید کتاب و BorrowAction برای قرض گرفتن یک کتاب.

خواندن اقدامات و قرض گرفتن اقدامات، که در پانل گنجانیده شده است، نمایش گزینه های به کتاب را بخرید یا امانت بگیرید از طریق پیوندهایی که ارائه می دهید، اقدامات خواندن و اقدامات قرض گرفته شده را به کاربران ارسال می کنند مستقیماً از پانل دانش و سایر سطوح Google به صفحه کتاب در وب سایت شما یا برنامه

ترتیب ارائه دهندگان در پانل دانش برای هر کاربر شخصی و پویا است. این به این معنی که کاربران مختلف سفارش های متفاوتی را می بینند و یک کاربر ممکن است سفارش های متفاوتی را ببیند در زمان های مختلف عوامل مختلفی وجود دارد که بر یک سفارش خاص تأثیر می گذارد. مثلا، اگر کاربر اغلب روی پیوند ارائه‌دهنده در پانل دانش کلیک کند، آن ارائه‌دهنده بیشتر است احتمالاً در یک سفارش بالاتر قرار می گیرد. هیچ راهی برای کنترل سفارش وجود ندارد.

شروع کنید

برای اجرای موفقیت آمیز اقدامات Book، باید فید خود را مطابق با Book بسازید اقدامات تعریف نوع داده ساختاریافته، اما ابتدا بخش های زیر را مرور کنید:

• رهنمودها
• فید خود را ایجاد کنید
• فید خود را با داده تست کنید ابزار اعتبارسنجی فید
• فایل فید خود را میزبانی کنید
• فایل فید خود را برای بررسی ارسال کنید
• در صورت نیاز فید خود را به روز کنید

رهنمودها

برای اطمینان از اینکه کتاب‌های شما می‌توانند به طور قابل اعتماد در جستجو ظاهر شوند، مهم است که شما آشنایی با جزئیات مهم و مفاهیم کلیدی علاوه بر این، فید شما باید برخی از آنها را برآورده کند مشخصات فرمت استاندارد

برای کمک به شما در انجام این کار، دستورالعمل‌های شرح داده شده در اینجا، علاوه بر موارد زیر را دنبال کنید دستورالعمل های کلی داده های ساختاریافته و موارد ضروری جستجو. دستورالعمل ها به شرح زیر است:

• آثار و نسخه ها
• سیستم های کتابخانه و اعضای کتابخانه
• ISBN و سایر شناسه های پشتیبانی شده
• پیوندها

آثار و نسخه ها

در سراسر این مستندات، وقتی در مورد یک کتاب صحبت می کنیم از دو اصطلاح متمایز استفاده می کنیم:

• کار: مفهوم انتزاعی یک کتاب. به طور خاص، ابرداده مانند عنوان، نویسنده، و زبان اصلی ویژگی های یک اثر هستند.
• نسخه: نسخه ای ملموس از کتاب. به طور خاص، ابرداده مانند سال انتشار، نام نسخه و شماره استاندارد بین المللی کتاب (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 در دسترس باشد، یک تیم پشتیبانی Google آن را بررسی می‌کند کیفیت پیوندهای عمیق در فید شما ما قویاً توصیه می کنیم که برخی از آنها را به صورت دستی آزمایش کنید پیوندهای عمیق برای تأیید اینکه آیا آنها صفحه ای را باز می کنند که در آن کاربران می توانند خرید یا قرض بگیرند کتاب ها

برای درخواست بازبینی فید خود، موارد زیر را ارائه دهید:

• مکان میزبان: آدرس فایل فید شما.
• احراز هویت میزبان، در صورت وجود: اعتبارنامه احراز هویت مجاز است Google برای دریافت فایل فید از مکان میزبان شما.

در صورت نیاز فید خود را به روز کنید

توصیه می‌کنیم روزانه فید خود را به‌روزرسانی کنید، اما این در نهایت به تعداد دفعات شما بستگی دارد تغییرات کاتالوگ از شرایط و نکات زیر آگاه باشید:

• جستجوی Google از به‌روزرسانی‌های هم‌زمان پشتیبانی نمی‌کند.
• جستجوی Google یک بار در روز فید شما را دریافت می کند و معمولاً محتوا را ظرف دو روز فهرست می کند.
• اگر تغییر قابل پیش بینی در در دسترس بودن نسخه وجود دارد، استفاده کنید availabilityStarts و availabilityEnds برای تعیین تاریخ های دقیق اگر نهاد دیگر در دسترس نیست، آن را به طور کامل حذف کنید

تعاریف نوع داده های ساخت یافته

برای اینکه محتوای شما واجد شرایط باشد، باید ویژگی های مورد نیاز فهرست شده در اینجا را وارد کنید نمایش در نتایج جستجوی ساختاریافته همچنین می‌توانید ویژگی‌های پیشنهادی را برای اضافه کردن اضافه کنید اطلاعات بیشتر در مورد محتوای شما، که می تواند تجربه کاربری بهتری را ارائه دهد.

موجودیت DataFeed

هر فایل فید داده schema.org که به Google تحویل داده می شود باید دارای یک موجودیت واحد باشد DataFeed در سطح ریشه. همه Book و Library نهادها باید در زیر فهرست شوند فیلد dataFeedElement موجودیت DataFeed.

ویژگی های پشتیبانی شده توسط Google به شرح زیر است:

{
  "@context": "https://schema.org",
  "@type": "DataFeed",
  "dataFeedElement": [
    {
      "@context": "https://schema.org",
      "@type": "Book",
      "@id": "https://example.com/work/the_catcher_in_the_rye",
      "url": "https://example.com/work/the_catcher_in_the_rye",
      "name": "The Catcher in the Rye",
      "author": {
        "@type": "Person",
        "name": "J.D. Salinger"
      },
      "sameAs": "https://en.wikipedia.org/wiki/The_Catcher_in_the_Rye",
      "workExample": [
        {
          "@type": "Book",
          "@id": "https://example.com/edition/the_catcher_in_the_rye_paperback",
          "isbn": "9787543321724",
          "bookEdition": "Mass Market Paperback",
          "bookFormat": "https://schema.org/Paperback",
          "inLanguage": "en",
          ...
        },
        ...
      ]
   }
  ],
  "dateModified": "2018-09-10T13:58:26.892Z"
}

{
  "@context": "https://schema.org",
  "@type": "DataFeed",
  "dataFeedElement": [
    {
      "@context": "https://schema.org",
      "@type": "LibrarySystem",
      "@id": "https://example.com/library-systems/100",
      "name": "Santa Clara County Library District",
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "librarytype",
          "value": "public"
        }
      ],
      ...
    },
    ...
  ],
  "dateModified": "2018-09-10T13:58:26.892Z"
}

Bookوجود، موجودیت

در حالی که تعریف کامل Book در دسترس است schema.org/Book، شما فقط باید ویژگی های زیر را در نظر بگیرید. شما باید ویژگی های مورد نیاز را برای هر کتابی که انتخاب می کنید در فید خود بگنجانید. شما همچنین می توانید ویژگی های توصیه شده را تعریف کنید اطلاعات بیشتری در مورد محتوای خود اضافه کنید، که می تواند تجربه کاربری بهتری را ارائه دهد.

Book (Work)

این Book نوع موجودیت سطح بالا است. این یک کار را نشان می دهد.

ویژگی های پشتیبانی شده توسط Google به شرح زیر است:

Book (Edition)

ویژگی workExample از این موجودیت Book استفاده می کند. نشان دهنده یک نسخه یک کار.

ویژگی های پشتیبانی شده توسط Google به شرح زیر است:

مثال 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 موجودیت.

مثال 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 استفاده می کند موجودیت.

مثال 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 پیوندهای عمیق شما را برای دسترسی به کتاب، خرده‌فروشی که سهام دارد، تعریف می‌کند کتاب و معیارهایی که کاربران باید رعایت کنند. معیارها ممکن است شامل وضعیت عضویت باشد، وضعیت ورود به سیستم، مکان یا هر چیز دیگری که برای دسترسی به کتاب لازم است.

مثال 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 پیوندهای عمیق شما را برای دسترسی به کتاب، کتابخانه ای که موجود است، تعریف می کند کتاب و معیارهایی که کاربران باید رعایت کنند. معیارها ممکن است شامل وضعیت عضویت باشد، وضعیت ورود به سیستم، مکان یا هر چیز دیگری که برای دسترسی به کتاب لازم است.

مثال 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 نشان دهنده یک شبکه مشترک است از کتابخانه اعضا.

Library (member)

ویژگی member موجودیت LibrarySystem از موجودیت Library (member) استفاده می کند. Library (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/1003",
  "name": "Tokyo Metropolitan Central Library",
  "location": {
    "@type": "PostalAddress",
    "streetAddress": "７-13-5 Minamiazabu, Minato City",
    "addressLocality": "Tokyo",
    "postalCode": "106-0047",
    "addressCountry": "JP"
  }
}

مثال 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"
         }
      }
   ]
}