สร้างฟีด

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

ข้อกําหนดรูปแบบไฟล์ฟีด

ข้อกําหนดของไฟล์ฟีดมีดังนี้

• ไฟล์ฟีดต้องมีนามสกุลไฟล์ .json
• อย่าเข้ารหัสไฟล์ฟีด

• เข้ารหัสไฟล์ฟีดเป็น UTF-8 (ตรวจสอบการตั้งค่าตัวแก้ไขไฟล์)

  

• แยกไฟล์เป็นหลายไฟล์หากไฟล์ฟีดมีขนาดใหญ่กว่า 1 GB (ไม่บีบอัด)

• เราขอแนะนําให้คุณสร้างไฟล์ต่อประเภทเอนทิตี (เช่น tvseries.json, tvseasons.json, tvepisodes.json, movies.json ฯลฯ)

  • หากไฟล์เหล่านี้มีขนาดเกิน 1 GB ให้แยกเอนทิตีออกเป็นหลายๆ ไฟล์ (เช่น tvepisodes_01.json, tvepisodes_02.json เป็นต้น)
  • แต่จะระบุจํานวนเอนทิตีในไฟล์เดียวได้ไม่จํากัดจํานวน

• ตรวจสอบว่าไฟล์ได้รับการเข้ารหัสโดยไม่มี BOM ตามข้อกําหนด JSON หากต้องการตรวจสอบในระบบปฏิบัติการ Linux hexdump file.json | head -n 1 ต้องไม่ขึ้นต้นด้วย BBEF ที่ที่อยู่ 0x00

ประเภทของฟีด

ฟีดเวอร์ชันที่ใช้งานจริง

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

ฟีดการทดลองใช้

• มีกรณีการใช้งานบางอย่างที่จําเป็นต้องขยายฟีดที่ใช้งานจริง ตัวอย่างสถานการณ์ดังกล่าว ได้แก่
  • การขยายฟีดเพื่อรวมเอนทิตีประเภทใหม่ ยังไม่เคยเปิดตัว
  • การขยายฟีดเพื่อรวมเอนทิตี/ข้อมูลเมตาใหม่จํานวนมากที่จะเปิดตัวในภาษาใหม่
  • การขยายฟีดไปยังแพลตฟอร์มประเภทใหม่ เช่น เมื่อเปิดฟีดที่ใช้งานจริงใน Google Search เท่านั้นและต้องการขยายการเปิดตัวไปยัง Google TV ในตอนนี้
• ในกรณีดังกล่าว จะต้องมีฟีดทดลองใช้ ฟีดนี้เป็นสําเนาของฟีดเวอร์ชันที่ใช้งานจริง ยกเว้นว่าจะมีข้อมูลเมตาเพิ่มเติม เช่น Deep Link สําหรับแพลตฟอร์มใหม่ ข้อมูลเมตาสําหรับภาษาใหม่ และอื่นๆ
• เช่นเดียวกับฟีดที่ใช้งานจริง จะมีการวิเคราะห์อย่างต่อเนื่องและทําซ้ํา 2-3 ครั้งเพื่อให้ได้แถบคุณภาพที่สูงขึ้นพร้อมกับจํานวนข้อมูลที่บันทึกและความถูกต้อง เมื่อแถบคุณภาพเสร็จสมบูรณ์แล้ว ฟีดนี้จะแทนที่ฟีดที่ใช้งานจริงปัจจุบันเพื่อให้เป็นฟีดที่ใช้งานจริงใหม่
• ฟีดนี้ช่วยให้เราแยกการเปิดตัวครั้งแรกออกจากการเปิดตัวเพิ่มเติมได้ ทําการทดสอบที่จําเป็นทั้งหมดโดยไม่ส่งผลต่อฟีดที่ใช้งานจริง เพื่อให้มั่นใจว่าประสบการณ์การใช้งานจะไม่หยุดชะงัก

ปรึกษาตัวแทนของ Google เพื่อสอบถามข้อสงสัยข้างต้น

สร้างไฟล์ฟีด

ทําตามแนวทางปฏิบัติแนะนําต่อไปนี้เมื่อสร้างฟีด

1. สร้างฟีดตัวอย่างโดยใช้เอนทิตีชุดเล็กๆ

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

2. ตรวจสอบฟีดตัวอย่าง

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

3. สร้างฟีดที่ใช้งานจริง

   หลังจากยืนยันแล้วว่าโครงสร้างที่ดีสําหรับเอนทิตีกลุ่มเล็กๆ ให้พัฒนาฟีดสําหรับแคตตาล็อกทั้งหมด

สร้างฟีดตัวอย่าง

1. เลือก 1 เอนทิตีตัวแทนจากแคตตาล็อก เลือกเอนทิตีที่มีโครงสร้างที่ซับซ้อนพอสมควร แต่ยังคงเป็นเอนทิตีทั่วไปของแคตตาล็อก
2. ใช้เครื่องมือตรวจสอบฟีดข้อมูลเพื่อตรวจสอบข้อผิดพลาดทางไวยากรณ์และพร็อพเพอร์ตี้ที่จําเป็นขาดหายไป (โปรดดูรายละเอียดในส่วนถัดไป)

   ตัวอย่างฟีดที่มีเอนทิตี Movie เดียว

   {
     "@context": "http://schema.org",
     "@type": "DataFeed",
     "dateModified": "2018-07-20T00:44:51Z",
     "dataFeedElement": [
       {
         "@context": ["http://schema.org", {"@language": "en"}],
         "@type": "Movie",
         "@id": "http://www.example.com/my_favorite_movie",
         "url": "http://www.example.com/my_favorite_movie",
         "name": "My Favorite Movie",
         "potentialAction": {
           "@type": "WatchAction",
           "target": {
             "@type": "EntryPoint",
             "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
             "inLanguage": "en",
             "actionPlatform": [
               "http://schema.org/DesktopWebPlatform",
               "http://schema.org/MobileWebPlatform",
               "http://schema.org/AndroidPlatform",
               "http://schema.org/AndroidTVPlatform",
               "http://schema.org/IOSPlatform",
               "http://schema.googleapis.com/GoogleVideoCast"
             ]
           },
           "actionAccessibilityRequirement": {
             "@type": "ActionAccessSpecification",
             "category": "subscription",
             "requiresSubscription": {
               "@type": "MediaSubscription",
               "name": "Example Package",
               "commonTier": true,
               "@id": "[partner determined string]"
             },
             "availabilityStarts": "2018-07-21T10:35:29Z",
             "availabilityEnds": "2019-10-21T10:35:29Z",
             "eligibleRegion": [
               {
                 "@type": "Country",
                 "name": "US"
               },
               {
                 "@type": "Country",
                 "name": "CA"
               }
             ]
           }
         },
         "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
         "releasedEvent": {
           "@type": "PublicationEvent",
           "startDate": "2008-01-20",
           "location": {
             "@type": "Country",
             "name": "US"
           }
         },
         "description": "This is my favorite movie.",
         "actor": [
           {
             "@type": "Person",
             "name": "John Doe",
             "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
           },
           {
             "@type": "Person",
             "name": "Jane Doe",
             "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
           }
         ],
         "identifier": [
           {
             "@type": "PropertyValue",
             "propertyID": "IMDB_ID",
             "value":  "tt0123456"
           }
         ]
       }
     ]
   }
   

ตรวจสอบฟีดตัวอย่าง

เครื่องมือต่อไปนี้มีไว้ช่วยคุณตรวจสอบฟีดตัวอย่างด้วยข้อมูลจําเพาะที่มีโครงสร้างของ Google สําหรับฟีดสื่อ

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

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

• เครื่องมือตรวจสอบสคีมา JSON

  เครื่องมือตรวจสอบสคีมา JSON ตรวจสอบไฟล์ทั้งหมดในฟีดได้ ใช้เครื่องมือนี้ระหว่างการพัฒนาฟีดเพื่อหลีกเลี่ยงข้อผิดพลาดทางโครงสร้างที่พบบ่อย ดูรายละเอียดเพิ่มเติมเกี่ยวกับเครื่องมือได้ที่นี่

สร้างฟีดที่ใช้งานจริง

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