Structured Data สำหรับหนังสือ (Book)

การดำเนินการเกี่ยวกับหนังสือทำให้ Google Search เป็นจุดเริ่มต้นในการค้นพบหนังสือและผู้แต่ง ซึ่งช่วยให้ผู้ใช้ Search ซื้อหรือยืมหนังสือที่พบจากผลการค้นหาของ Search ได้โดยตรงอย่างรวดเร็ว ตัวอย่างเช่น ผู้ใช้อาจค้นหาหนังสือเรื่อง Charlotte's Web และเห็นผลการค้นหาที่ให้ซื้อหรือยืมหนังสือได้ ในฐานะผู้ให้บริการหนังสือ คุณอาจจัดเตรียมฟีดข้อมูลให้ Google โดยใช้สคีมา Structured Data ซึ่งมีให้ในบทความนี้ ข้อกำหนดของเราระบุ ReadAction เพื่อให้ผู้ใช้ซื้อหนังสือ และ BorrowAction เพื่อให้ยืมหนังสือ

การดำเนินการเกี่ยวกับการอ่านและการยืมซึ่งรวมอยู่ในแผงจะแสดงตัวเลือกในการซื้อหรือยืมหนังสือ และจะส่งผู้ใช้จากการ์ดความรู้และแพลตฟอร์มอื่นๆ ของ Google ไปยังหน้าหนังสือที่อยู่ในเว็บไซต์หรือแอปของคุณโดยตรงผ่านลิงก์ที่คุณระบุไว้

ลําดับของผู้ให้บริการในการ์ดความรู้จะปรับเปลี่ยนไปตามความเหมาะสมกับผู้ใช้แต่ละราย ซึ่งหมายความว่าผู้ใช้แต่ละรายจะเห็นลำดับที่ต่างกันและผู้ใช้รายเดียวกันอาจเห็นลำดับที่ต่างกันในเวลาที่ต่างกัน มีปัจจัยหลายอย่างที่ส่งผลต่อการจัดลำดับ ตัวอย่างเช่น หากผู้ใช้คลิกลิงก์ของผู้ให้บริการหนึ่งๆ ในการ์ดความรู้เป็นประจํา ผู้ให้บริการดังกล่าวก็มีแนวโน้มที่จะอยู่ในลำดับที่สูงกว่า และไม่มีวิธีใดที่จะควบคุมการจัดลำดับได้

เริ่มต้น

คุณต้องสร้างฟีดตามคำจำกัดความของประเภท Structured Data สำหรับการดำเนินการเกี่ยวกับหนังสือเพื่อใช้การดำเนินการนี้ แต่ให้อ่านส่วนต่อไปนี้ก่อน

• หลักเกณฑ์
• สร้างฟีด
• ทดสอบฟีดด้วยเครื่องมือตรวจสอบฟีดข้อมูล
• โฮสต์ไฟล์ฟีด
• ส่งไฟล์ฟีดเพื่อรับการตรวจสอบ
• อัปเดตฟีดตามความจําเป็น

หลักเกณฑ์

โปรดทำความคุ้นเคยกับรายละเอียดสําคัญและแนวคิดหลักๆ เพื่อให้มั่นใจว่าหนังสือจะปรากฏใน Search อย่างถูกต้อง นอกจากนี้ฟีดต้องเป็นไปตามข้อกำหนดรูปแบบที่เป็นมาตรฐานด้วย

โปรดทำตามหลักเกณฑ์ที่อธิบายไว้ในส่วนนี้นอกเหนือจากหลักเกณฑ์ทั่วไปเกี่ยวกับ Structured Data และหลักเกณฑ์ใน Search Essentials เพื่อเป็นการปฏิบัติตามข้อกำหนดรูปแบบที่เป็นมาตรฐาน หลักเกณฑ์ดังกล่าวมีดังต่อไปนี้

• งานและฉบับ
• ระบบห้องสมุดและสมาชิกห้องสมุด
• ISBN และตัวระบุอื่นๆ ที่รองรับ
• ลิงก์

งานและฉบับ

ในเอกสารนี้ เราใช้คำ 2 คำที่แตกต่างกันเมื่อพูดถึงหนังสือ ได้แก่

• งาน (Work) หมายถึงแนวคิดที่เป็นนามธรรมของหนังสือ กล่าวคือ ข้อมูลเมตาอย่างเช่น ชื่อหนังสือ ผู้แต่ง และภาษาต้นฉบับเป็นแอตทริบิวต์ของงาน
• ฉบับ (Edition) หมายถึงตัวเล่มหนังสือ กล่าวคือ ข้อมูลเมตาอย่างเช่น ปีที่พิมพ์ ชื่อฉบับ และเลขมาตรฐานสากลประจำหนังสือ (ISBN) เป็นแอตทริบิวต์ของฉบับ

ตัวอย่างเช่น Charlotte's Web เป็นงานแต่เวอร์ชันต่างๆ ที่มีคือฉบับ ในกรณีนี้ งาน Charlotte's Web อาจมีฉบับแรก ฉบับที่ 2 ฉบับย่อ ฉบับแปลภาษาฝรั่งเศส และอื่นๆ

ความแตกต่างนี้สําคัญอย่างยิ่งในฟีดที่เห็นความแตกต่างไม่ชัดเจน มีเอนทิตี Book 2 รายการ ได้แก่

• Book (Work) เป็นเอนทิตี Book "ระดับบนสุด":
  • workExample เป็นพร็อพเพอร์ตี้ของ Work และระบุอินสแตนซ์ที่มี 1 รายการเท่านั้นของ Book (Edition)
  • ต้องมี workExample อย่างน้อย 1 รายการสําหรับ Work แต่ละรายการ
• Book (Edition) เป็นเอนทิตี Book "ระดับล่าง"

อย่าลืมว่างาน 1 งานมีได้หลายฉบับ เราขอแนะนําให้จัดกลุ่มฉบับต่างๆ เข้าไว้ด้วยกันให้มากที่สุด เพราะจะช่วยให้ระบบของ Google ใช้ประโยชน์จากข้อมูลที่เกี่ยวข้องทั้งหมดเกี่ยวกับหนังสือเพื่อแสดงใน Search หากจำเป็น คุณแบ่งฉบับออกเป็นหลายระเบียนงานได้ แต่สิ่งที่ระเบียนงานแต่ละรายการจะต้องมีคือ

• @id ที่แตกต่างกัน
• ฉบับอย่างน้อย 1 ฉบับที่มี ISBN หรือตัวระบุอื่นที่รองรับ

ระบบห้องสมุดและสมาชิกห้องสมุด

Library entity เป็นเอนทิตี Library ประเภท "ระดับบนสุด" หรือเป็นโครงสร้างนามธรรมซึ่งประกอบด้วยเอนทิตี LibrarySystem และเอนทิตี Library (member) "ระดับล่าง" แต่ละรายการของระบบห้องสมุดนั้น

เอนทิตี LibrarySystem เป็นนามธรรมและแสดงถึงเครือข่ายสมาชิกห้องสมุดที่ทํางานร่วมกัน เช่น คุณระบุห้องสมุดสาธารณะของเมืองออสตินเป็นเอนทิตี LibrarySystem ได้ เว็บไซต์ห้องสมุดสาธารณะของเมืองออสตินอธิบายว่าตนเป็นระบบห้องสมุดสาธารณะที่ให้บริการในเมืองออสติน รัฐเท็กซัส และประกอบด้วยห้องสมุดในเครือ (หรือสมาชิกห้องสมุด) 20 แห่ง

เอนทิตี LibrarySystem ทุกรายการต้องมีเอนทิตี Library (member) อย่างน้อย 1 รายการ แม้ว่าจริงๆ แล้วห้องสมุดแห่งนั้นไม่ได้เป็นส่วนหนึ่งของระบบห้องสมุดใดเลยก็ตาม ในสถานการณ์นี้ ห้องสมุดจะเป็นสมาชิกห้องสมุดเพียงแห่งเดียวในระบบห้องสมุดของตนเองเพื่อวัตถุประสงค์ในการใช้การดำเนินการเกี่ยวกับหนังสือ ส่วนสมาชิกห้องสมุดนั้นต่างจากระบบห้องสมุดตรงที่ไม่ได้เป็นนามธรรม ดังนั้นจึงมีที่อยู่จริง สำหรับวัตถุประสงค์เดียวกันดังกล่าว

ในทางกลับกัน เอนทิตี Library (member) ทุกรายการจะต้องเป็นของเอนทิตี LibrarySystem อย่างน้อย 1 รายการ

ISBN และตัวระบุอื่นๆ ที่รองรับ

ISBN คือสัญญาณหลักของความตรงกันของข้อมูลเมื่อ Google Search จับคู่ข้อมูลฟีดของคุณกับข้อมูลของ Google คุณต้องระบุ ISBN หรือตัวระบุอื่นที่รองรับสำหรับหนังสือทั้งหมดที่ต้องการให้ปรากฏในผลการค้นหาของ Search หากไม่มี หมายความว่าระบบจะจับคู่หนังสือไม่ได้และไม่แสดงหนังสือ

Google Search แนะนำให้ใช้ ISBN-13 แต่คุณให้ตัวระบุต่อไปนี้แทนได้

• หมายเลขในศูนย์หอสมุดคอมพิวเตอร์ออนไลน์ (OCLC)
• หมายเลขมาตรฐานสำหรับหนังสือของหอสมุดรัฐสภาอเมริกัน (LCCN)
• JP e-code

ลิงก์

ลิงก์ในฟีดต้องเป็นไปตามหลักเกณฑ์ต่อไปนี้เพื่อให้ผู้ใช้ได้รับประสบการณ์ที่ดีที่สุดในการค้นหาหนังสือ

• หากคุณมีหน้าซ้ำกันสำหรับเนื้อหาที่เหมือนกัน ลิงก์ต้องเป็น Canonical URL ที่มีชื่อหนังสือและข้อมูลอื่นๆ เกี่ยวกับหนังสือ
• หลังจากที่ผู้ใช้คลิกลิงก์การดำเนินการเกี่ยวกับการอ่านหรือยืม ระบบจะต้องส่งผู้ใช้ไปยังหน้าเว็บที่รองรับการซื้อหรือการยืมหนังสือโดยตรง กล่าวคือ อย่าชี้ลิงก์การดำเนินการไปยังหน้าเว็บที่มีลิงก์อื่นซึ่งผู้ใช้ต้องคลิกเพื่อซื้อหรือยืมเนื้อหา ตัวอย่างเช่น อย่าส่งผู้ใช้ไปยังหน้าผลการค้นหาหรือหน้าสรุปของผลิตภัณฑ์

สร้างฟีด

หากเว็บไซต์ขายหนังสือให้ผู้ใช้ซื้อ คุณต้องอัปโหลดฟีด Book โปรดติดต่อตัวแทนของ Google และยืนยันรายละเอียดเกี่ยวกับวิธีและตําแหน่งที่จะอัปโหลดฟีด

หากเว็บไซต์ให้บริการยืมหนังสือแก่ผู้ใช้ คุณต้องอัปโหลดฟีด 2 รายการ ได้แก่ ฟีด Book และฟีด Library โปรดติดต่อตัวแทนของ Google และยืนยันรายละเอียดเกี่ยวกับวิธีและตําแหน่งที่จะอัปโหลดฟีด

ปฏิบัติตามข้อกำหนดด้านขนาดไฟล์ จำนวน และรูปแบบ

ข้อกำหนดต่างๆ มีดังต่อไปนี้

• ข้อกำหนดด้านขนาดไฟล์ฟีด
  • ไฟล์ฟีดที่ไม่ได้บีบอัดต้องมีขนาดไม่เกิน 1 GB
  • ไฟล์ฟีดที่จะบีบอัดต้องมีขนาดไม่เกิน 1 GB หากไฟล์ฟีดที่ไม่ได้บีบอัดมีขนาดเกิน 1 GB คุณต้องแยกไฟล์ฟีดที่ไม่ได้บีบอัดออกเป็นหลายไฟล์
• คุณบีบอัดไฟล์ฟีดได้ โดยต้องอยู่ในรูปแบบไฟล์ zip, gz, tar, tar.gz, JAR, ar, arj, cpio หรือไฟล์แบบเก็บถาวร Dump
• หากมีไฟล์ฟีดหลายไฟล์ คุณจะอัปโหลดตามนั้นหรือรวมไว้ในไฟล์ดัชนีแผนผังเว็บไซต์ก็ได้
• ไฟล์ฟีดเดี่ยวต้องมีส่วนขยายชื่อไฟล์ .json

ปฏิบัติตามข้อกำหนดด้านเนื้อหาฟีด

โปรดคำนึงถึงข้อกำหนดด้านเนื้อหาฟีดต่อไปนี้เป็นพิเศษและต้องปฏิบัติตามด้วย

• ฟีดต้องไม่มีเอนทิตีที่ไม่มีอัปเดต เอนทิตีที่ไม่มีอัปเดตคือเอนทิตีที่ตั้งค่า availabilityEnds เป็นวันที่ที่ผ่านมาหรือไม่มีอยู่ในเว็บไซต์แล้ว
• Deep Link ทั้งหมด เช่น urlTemplate และ URL ทั้งหมด เช่น url ที่คุณใส่ไว้ในฟีดต้องเป็น URL เวอร์ชันที่ใช้งานจริง อย่าใช้ URL สำหรับ QA, การพัฒนา หรือ URL ประเภทอื่นที่ไม่ใช่เวอร์ชันที่ใช้งานจริง
• URL ทั้งหมด เช่น url ต้องเป็น Canonical
• เอนทิตีแต่ละรายการในฟีดต้องระบุพร็อพเพอร์ตี้ต่อไปนี้
  • รหัสที่ไม่ซ้ำกัน: @id
  • URL ที่ไม่ซ้ำกัน: url
  • Deep Link ที่ไม่ซ้ำกัน: urlTemplate

ทดสอบฟีดด้วยเครื่องมือตรวจสอบฟีดข้อมูล

เราขอแนะนําให้ทําตามขั้นตอนการแก้ปัญหาต่อไปนี้เพื่อแก้ไขข้อผิดพลาดที่พบบ่อยและคําเตือนในเครื่องมือตรวจสอบฟีดข้อมูล

• ตรวจสอบว่าได้เลือกตัวเลือกที่ถูกต้องในช่องตรวจสอบเมื่อ เลือกการดำเนินการเกี่ยวกับหนังสือให้กับเอนทิตี Book

• ยืนยันว่าสะกดค่า @type ถูกต้อง
• ตรวจสอบว่าตั้งค่า @context อย่างถูกต้อง ตั้งค่า "@context": "https://schema.org" สําหรับทั้ง ReadAction และ BorrowAction

โฮสต์ไฟล์ฟีด

เมื่อไฟล์ฟีดพร้อมใช้งาน ให้โฮสต์ไฟล์นั้นในตําแหน่งที่ปลอดภัย Google จะดึงข้อมูลฟีดเป็นประจำเพื่อให้เนื้อหาเป็นปัจจุบัน

วิธีการโฮสต์

ระบบรองรับวิธีการโฮสต์ฟีดต่อไปนี้

ส่งไฟล์ฟีดเพื่อรับการตรวจสอบ

ทีมสนับสนุนของ Google จะตรวจสอบคุณภาพของ Deep Link ในฟีดเพื่อให้เนื้อหาพร้อมใช้งานใน Google Search เราขอแนะนำอย่างยิ่งให้ทดสอบ Deep Link บางส่วนด้วยตนเองเพื่อยืนยันว่าเปิดหน้าเว็บที่ผู้ใช้จะซื้อหรือยืมหนังสือได้

ในการขอรับการตรวจสอบฟีด ให้ระบุข้อมูลต่อไปนี้

• ตำแหน่งโฮสต์: URL ของไฟล์ฟีด
• การตรวจสอบสิทธิ์ของโฮสต์ (หากมี): ข้อมูลเข้าสู่ระบบสำหรับการตรวจสอบสิทธิ์เพื่ออนุญาตให้ Google รับไฟล์ฟีดจากตำแหน่งโฮสต์

อัปเดตฟีดตามความจําเป็น

เราขอแนะนําให้อัปเดตฟีดทุกวัน ทั้งนี้ขึ้นอยู่กับความถี่ในการเปลี่ยนแปลงแคตตาล็อก โปรดคำนึงถึงเงื่อนไขและเคล็ดลับต่อไปนี้

• Google Search ไม่รองรับการอัปเดตแบบเรียลไทม์
• Google Search จะดึงข้อมูลฟีดวันละครั้งและมักจัดทําดัชนีเนื้อหาภายใน 2 วัน
• หากมีการเปลี่ยนแปลงที่ทราบในความพร้อมใช้งานของฉบับ ให้ใช้ availabilityStarts และ availabilityEnds เพื่อกําหนดวันที่ที่แน่นอน หากเอนทิตีใช้งานไม่ได้อีกต่อไป ให้นำเอนทิตีนั้นออกทั้งหมด

คำจำกัดความของประเภท Structured Data

คุณต้องใส่พร็อพเพอร์ตี้ที่จำเป็นซึ่งระบุไว้ในส่วนนี้ลงในเนื้อหาเพื่อให้มีสิทธิ์แสดงในผลการค้นหาแบบมีโครงสร้าง โดยอาจใส่พร็อพเพอร์ตี้ที่แนะนำด้วยเพื่อให้ข้อมูลเพิ่มเติมเกี่ยวกับเนื้อหา ซึ่งจะช่วยให้ผู้ใช้ได้รับประสบการณ์ที่ดียิ่งขึ้น

เอนทิตี 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"
    }]

ตัวอย่างไฟล์ JSON ของฟีด 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"
}

ตัวอย่างไฟล์ JSON ของฟีด 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)

พร็อพเพอร์ตี้ potentialAction ใช้เอนทิตี ReadAction ReadAction กําหนด Deep Link เพื่อเข้าถึงหนังสือ ผู้ค้าปลีกที่มีหนังสือในคลังสินค้า และเกณฑ์คุณสมบัติที่ผู้ใช้ต้องมี ซึ่งอาจเป็นสถานะการเป็นสมาชิก สถานะการเข้าสู่ระบบ ตําแหน่ง หรือสิ่งอื่นที่จําเป็นต่อการเข้าถึงหนังสือ

ตัวอย่าง 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 กําหนด Deep Link เพื่อเข้าถึงหนังสือ ห้องสมุดที่มีหนังสือเรื่องดังกล่าว และเกณฑ์คุณสมบัติที่ผู้ใช้ต้องมี ซึ่งอาจเป็นสถานะการเป็นสมาชิก สถานะการเข้าสู่ระบบ ตําแหน่ง หรือสิ่งอื่นที่จําเป็นต่อการเข้าถึงหนังสือ

ตัวอย่าง 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

เอนทิตี 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"
  }
}

ตัวอย่างไฟล์ JSON ของฟีด 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"
         }
      }
   ]
}