วิดีโอและคำบรรยาย · โปรแกรมดาวน์โหลดภาพขนาดย่อของ YouTube และโปรแกรมดูข้อมูลเมตา
มาตรฐาน oEmbed: ข้อมูลจำเพาะ 2008 ทำให้การฝังลิงก์ทำงานได้ทุกที่ได้อย่างไร
· พื้นหลัง
youtube ฝังไว้ มาตรฐานเว็บ
oEmbed เป็นมาตรฐานเงียบๆ ที่อยู่เบื้องหลังการวางลิงก์และรับผู้เล่น โพสต์นี้ครอบคลุมถึงที่มา สัญญาคำขอและตอบกลับ วิธีที่ไซต์ค้นพบจุดสิ้นสุด และเหตุใดจึงยังคงเป็นแหล่งข้อมูลเมตาของวิดีโอสาธารณะที่ง่ายที่สุด
วางลิงก์ รับผู้เล่น — ความมหัศจรรย์ในชีวิตประจำวันที่ oEmbed เกิดขึ้นได้
วางลิงก์ YouTube ที่รองรับ และ ToolAcre ส่งคืนบันทึกสาธารณะแบบย่อโดยไม่ต้องแยกวิเคราะห์หน้าสำหรับดู เบราว์เซอร์แยกและตรวจสอบรหัสวิดีโอ จากนั้นสร้างคำขอ oEmbed ที่ชัดเจนหนึ่งคำขอ นักพัฒนาสามารถสร้างปลายทางนั้นขึ้นมาใหม่และเปรียบเทียบอัปสตรีม JSON กับฟิลด์ที่แสดง ไม่มีตัวเลือกหน้าที่เปราะบางอยู่ระหว่างทรัพยากรและข้อมูลเมตา
ผลลัพธ์ที่ได้คือสแนปชอตปัจจุบันที่ออกจากระบบ ไม่ใช่การบันทึกวิดีโอที่สมบูรณ์ โดยจะระบุชื่อสาธารณะ ผู้แต่ง และการอ้างอิงภาพขนาดย่อที่เปิดเผยผ่าน oEmbed ขอบเขตนี้ชี้แจงข้อผิดพลาด: อินพุตที่มีรูปแบบไม่ถูกต้องล้มเหลวในเครื่อง การขนส่งหรือ HTTP อาจล้มเหลวจากระยะไกล และฟิลด์มาตรฐานที่ถูกละเว้นก็ไม่ใช่เช่นกัน แต่ละเงื่อนไขมีวิธีการรักษาที่แตกต่างกัน
พื้นที่เก็บข้อมูลพิสูจน์สัญญาคำขอปัจจุบัน ไม่ใช่เรื่องราวต้นกำเนิด 2008 ที่ไม่ได้รับการสนับสนุน
จุดสิ้นสุดคือ `https://www.youtube.com/oembed` ToolAcre เพิ่มพารามิเตอร์ `url` ที่มี `https://www.youtube.com/watch?v=VIDEO_ID` และ `format=json` ทั้งสองถูกเข้ารหัสเป็นข้อมูลแบบสอบถาม เวลาเริ่มต้น บริบทของเพลย์ลิสต์ และพารามิเตอร์การติดตามที่คัดลอกไว้จะไม่อยู่ในคำขอข้อมูลเมตา ดังนั้นเฉพาะทรัพยากรวิดีโอที่ได้รับการตรวจสอบแล้วเท่านั้นที่จะกำหนดการค้นหา
ลิงก์แชร์ `youtu.be` ลิงก์สำหรับดูมาตรฐาน และลิงก์ฝังที่รองรับสามารถให้ ID เดียวกัน ดังนั้นจึงเป็นคำขอ oEmbed เดียวกัน การทำให้เป็นมาตรฐานนี้จะป้องกันไม่ให้รูปแบบอินพุตเปลี่ยนผลลัพธ์โดยไม่ตั้งใจ นอกจากนี้ยังสร้างการยืนยันการทดสอบที่เสถียร: หนึ่ง ID จะต้องสร้างจุดสิ้นสุดที่รู้จัก รูปแบบ canonical watch URL และ JSON เสมอ
สัญญา — URL เข้า พิมพ์ตอบกลับ พร้อมช่องสำหรับชื่อเรื่อง ผู้แต่ง ฝัง HTML และภาพขนาดย่อ
หลังจากการตอบกลับสำเร็จ ToolAcre แยกวิเคราะห์ JSON ลงในบันทึกของตนเอง: `videoId` ชื่อเรื่อง ชื่อผู้แต่งเป็น `channel` ช่อง URL ภาพขนาดย่อ URL และขนาด ขนาดของผู้เล่น รายละเอียดผู้ให้บริการ และการละเว้นอย่างชัดแจ้ง การเปลี่ยนชื่อคีย์ผู้สร้างอัปสตรีมจะทำให้ JSON, Markdown, CSV และข้อความส่งออกคำศัพท์ที่เน้นไปที่ YouTube สอดคล้องกัน แทนที่จะเปิดเผยรูปแบบการโยงโดยไม่ตั้งใจ
รายการฟิลด์ที่ขาดหายไประบุว่าไม่ได้รับระยะเวลา การดู การถูกใจ คำอธิบาย แท็ก วันที่อัปโหลด และคำอธิบายภาพ ไม่ได้อ้างว่าค่าเหล่านั้นว่างเปล่าบน YouTube ความแตกต่างดังกล่าวมีความสำคัญใน CSV และข้อความ โดยที่ความสามารถที่ขาดไปนั้นมีลักษณะคล้ายกับคุณสมบัติที่ว่างเปล่าอย่างแท้จริง มิติตัวเลขและสตริงทางเลือกจะถูกเก็บไว้เป็นค่าที่ทำให้เป็นมาตรฐานที่ใช้งานได้เท่านั้น
การค้นพบและการลงทะเบียนปลายทางอยู่นอกการดำเนินการนี้
ToolAcre ไม่พบปลายทางจากเพจ `<link>` หรือปรึกษากับรีจิสทรีของผู้ให้บริการ ปลายทางของ YouTube เป็นค่าคงที่ของแหล่งที่มา ตัวแยกวิเคราะห์หนึ่งตัว รูปร่างตัวระบุหนึ่งตัว และตัวสร้างคำขอหนึ่งตัวครอบคลุมขอบเขตที่ระบุโดยไม่ต้องดึงเพจที่กำหนดเองหรือติดตามข้อมูลปลายทางที่โฆษณาโดย HTML ที่ไม่น่าเชื่อถือ
การค้นพบจะต้องมีการแยกวิเคราะห์มาร์กอัประยะไกล ตรวจสอบความถูกต้องของ URL ที่โฆษณา และตัดสินใจว่าโฮสต์ใดที่อาจได้รับคำขอติดตามผล ตำแหน่งข้อมูลคงที่จะหลีกเลี่ยงพื้นที่พิเศษดังกล่าว และทำให้การตรวจสอบเครือข่ายตรงไปตรงมา หาก YouTube เปลี่ยนแปลงบริการ การผสานรวมจะต้องมีการเปลี่ยนแปลงโค้ดอย่างชัดเจน แทนที่จะติดตามปลายทางที่ไม่ได้รับการตรวจสอบแบบเดิมอย่างเงียบๆ
การกล่าวอ้างการรับเลี้ยงบุตรบุญธรรมข้ามแพลตฟอร์มอยู่นอกเหนือหลักฐานที่ตรวจสอบแล้ว
บันทึกที่เป็นมาตรฐานสนับสนุนการตรวจสอบและการนำกลับมาใช้ใหม่ JSON รักษาโครงสร้างคีย์-ค่า Markdown สร้างบันทึกที่อ่านได้ CSV เหมาะกับพื้นที่โฆษณา และข้อความธรรมดาเหมาะกับตั๋วหรือบันทึกการวิจัย การส่งออกโมเดลในเครื่องแทนการใช้ oEmbed แบบดิบจะรักษาชื่อและการละเว้นให้สอดคล้องกับรูปแบบต่างๆ ดังนั้นผู้ใช้ดาวน์สตรีมจึงไม่ได้รับการตีความที่แตกต่างกันอย่างละเอียดถึง 4 แบบ
oEmbed อาจส่งคืนแฟรกเมนต์ iframe HTML แต่ ToolAcre จะไม่ฉีดหรือส่งออก แอปสร้างโปรแกรมเล่นที่ตอบสนองของตัวเองจาก ID ที่ได้รับการตรวจสอบโดยใช้โฮสต์ที่ปรับปรุงความเป็นส่วนตัวของ YouTube การแยกข้อมูลเมตาออกจากการแสดงผลจะหลีกเลี่ยงมาร์กอัปของผู้ให้บริการที่เชื่อถือได้ และทำให้ปลายทางของผู้เล่นเป็นตัวเลือกผลิตภัณฑ์ที่ตรวจสอบได้ แทนที่จะเป็นสตริงอัปสตรีมที่ทึบแสง
สมมติว่า oEmbed มีชื่อ `author_name`, `author_url`, 480-by-360 ภาพขนาดย่อ ขนาดผู้เล่น และรายละเอียดผู้ให้บริการ ToolAcre เพิ่ม ID ที่ตรวจสอบแล้ว แมปช่องผู้เขียนกับช่องช่อง รักษาขนาดที่ใช้งานได้ และบันทึกคุณสมบัติที่ไม่รองรับ การฉายภาพที่กำหนดนี้สามารถคงความเสถียรได้แม้ว่าอัปสตรีมจะเพิ่มคีย์ที่อินเทอร์เฟซไม่ได้ใช้ก็ตาม
DNS ความล้มเหลว ตัวบล็อกหรือโหมดออฟไลน์เป็นปัญหาการขนส่ง สถานะไม่สำเร็จคือปัญหา HTTP สถานะสำเร็จโดยมีรูปแบบไม่ถูกต้อง JSON เป็นปัญหาในการแยกวิเคราะห์ ไม่ควรสร้างบันทึกที่ประดิษฐ์ขึ้นบางส่วน การสอบสวนภาพขนาดย่อยังคงเป็นอิสระ ดังนั้นข้อมูลเมตาอาจประสบความสำเร็จในขณะที่ภาพหนึ่งล้มเหลว หรือ JPEG อาจถอดรหัสในขณะที่ oEmbed ไม่พร้อมใช้งาน
สิ่งนี้ไม่ครอบคลุม — Open Graph และ schema.org ซึ่งเป็นชั้นข้อมูลเมตาอื่นๆ ที่ลิงก์แสดงตัวอย่างอ่านแล้ว
oEmbed ไม่ได้แทนที่ Open Graph, schema.org JSON-LD, ข้อมูล YouTube API หรือแคชแสดงตัวอย่าง กลไกเหล่านั้นมีฟิลด์ การรับรองความถูกต้อง และความใหม่ที่แตกต่างกัน ToolAcre ไม่เคยดึงเอกสารการดูเพื่อเปรียบเทียบ ระยะเวลา เวลาที่เผยแพร่ สถิติหรือคำอธิบายภาพจำเป็นต้องมีแหล่งข้อมูลที่ได้รับอนุญาต ไม่ใช่การคาดเดาที่มาจากชื่อภาพขนาดย่อหรือขนาดของผู้เล่น
รหัสที่ถูกต้องยังคงสามารถระบุทรัพยากรส่วนตัว ถูกลบ ถูกจำกัด หรือไม่มีอยู่ได้ oEmbed ที่ออกจากระบบไม่สามารถเปิดเผยต่อสาธารณะได้ ชื่อ ชื่อช่อง และการอ้างอิงภาพขนาดย่อสามารถเปลี่ยนแปลงได้ภายใต้รหัสเดียวกัน ดังนั้นแหล่งที่มาจึงต้องมีวันที่เข้าถึง การส่งออกจะบันทึกการค้นหาหนึ่งครั้ง มันไม่รับประกันความถาวรหรือไม่อนุญาตให้เผยแพร่ซ้ำเนื้อหาที่ส่งคืน
Takeaway: คำขอที่ดำเนินการและสัญญาการตอบสนองที่เป็นมาตรฐาน
การแยกวิเคราะห์และการตรวจสอบความถูกต้องจะอยู่ในเครื่องจนกว่าจะมีการดึงข้อมูล จากนั้นเบราว์เซอร์จะติดต่อ `www.youtube.com` สำหรับ oEmbed และ `i.ytimg.com` สำหรับรูปภาพ โดยละเว้นข้อมูลรับรองและผู้อ้างอิง โดยขอ `no-store` และติดตามการเปลี่ยนเส้นทาง Google ยังคงเห็นคำขอแต่ละรายการและส่วนหัว Origin ไม่มีพร็อกซี ToolAcre ซ่อนปลายทางหรือข้ามขีดจำกัดการเข้าถึงเมื่อออกจากระบบ
สัญญามีความแม่นยำ: ปรับอินพุตที่รองรับให้เป็นมาตรฐานให้เป็นหนึ่ง ID, สร้างแบบสอบถามตามรูปแบบบัญญัติ, ต้องการ JSON ที่สำเร็จ, คงชุดย่อยของฟิลด์ที่บันทึกไว้ และทำเครื่องหมายการละเว้น เก็บรักษาว่าเกิดความล้มเหลวระหว่างอินพุต การขนส่ง HTTP การแยกวิเคราะห์ หรือการเข้าถึงหรือไม่ หลักฐานดังกล่าวทำให้การส่งออกมีประโยชน์โดยไม่ต้องแสร้งทำเป็นว่าการตอบสนองแบบ oEmbed แบบกระชับนั้นเป็น YouTube API ที่สมบูรณ์