Tiêu chuẩn oEmbed: cách thông số 2008 khiến việc nhúng liên kết hoạt động ở mọi nơi

Dán một liên kết, có được một người chơi — điều kỳ diệu hàng ngày mà oEmbed đã tạo ra

Dán liên kết YouTube được hỗ trợ và ToolAcre trả về bản ghi công khai nhỏ gọn mà không cần phân tích cú pháp trang xem. Trình duyệt trích xuất và xác thực ID video, sau đó tạo một yêu cầu oEmbed rõ ràng. Nhà phát triển có thể tái tạo đích đến đó và so sánh JSON ngược dòng với các trường được hiển thị; không có bộ chọn trang dễ hỏng nào nằm giữa tài nguyên và siêu dữ liệu của nó.

Kết quả là ảnh chụp nhanh hiện tại, đã đăng xuất chứ không phải bản ghi video hoàn chỉnh. Nó xác định tiêu đề công khai, tác giả và tham chiếu hình thu nhỏ được hiển thị thông qua oEmbed. Ranh giới này làm rõ các lỗi: đầu vào không đúng định dạng không thành công cục bộ, việc vận chuyển hoặc HTTP có thể bị lỗi từ xa và trường chuẩn hóa bị bỏ qua cũng không thành công. Mỗi tình trạng đều có cách chữa trị khác nhau.

Kho lưu trữ chứng minh hợp đồng yêu cầu hiện tại chứ không phải câu chuyện gốc 2008 không được hỗ trợ

Điểm cuối là `https://www.youtube.com/oembed`. ToolAcre thêm thông số `url` chứa `https://www.youtube.com/watch?v=VIDEO_ID` và `format=json`. Cả hai đều được mã hóa dưới dạng dữ liệu truy vấn. Thời gian bắt đầu, bối cảnh danh sách phát và các thông số theo dõi được sao chép không nằm trong yêu cầu siêu dữ liệu, do đó, chỉ tài nguyên video được xác thực mới xác định việc tra cứu.

Liên kết chia sẻ `youtu.be`, liên kết xem tiêu chuẩn và liên kết nhúng được hỗ trợ có thể mang lại cùng một ID và do đó có cùng yêu cầu oEmbed. Việc chuẩn hóa này ngăn không cho định dạng đầu vào vô tình thay đổi kết quả. Nó cũng tạo ra một xác nhận kiểm tra ổn định: một ID phải luôn tạo ra điểm cuối đã biết, định dạng theo dõi chuẩn URL và JSON.

Hợp đồng — một URL vào, một phản hồi được đánh máy ra, với các trường cho tiêu đề, tác giả, phần nhúng HTML và hình thu nhỏ

Sau khi phản hồi thành công, ToolAcre phân tích JSON thành bản ghi riêng của nó: `videoId`, tiêu đề, tên tác giả là `channel`, kênh URL, hình thu nhỏ URL và các thứ nguyên, thứ nguyên trình phát, chi tiết nhà cung cấp và các thiếu sót rõ ràng. Việc đổi tên khóa tác giả ngược dòng mang lại JSON, Markdown, CSV và văn bản xuất từ ​​vựng nhất quán theo định hướng YouTube thay vì hiển thị định dạng dây ngẫu nhiên.

Danh sách các trường bị thiếu cho biết không lấy được thời lượng, lượt xem, lượt thích, mô tả, thẻ, ngày tải lên và chú thích. Nó không khẳng định những giá trị đó trống trên YouTube. Sự khác biệt đó quan trọng trong CSV và văn bản, trong đó khả năng vắng mặt trông giống như một thuộc tính thực sự trống. Thứ nguyên số và chuỗi tùy chọn chỉ được giữ lại dưới dạng giá trị chuẩn hóa có thể sử dụng được.

Khám phá và đăng ký điểm cuối nằm ngoài việc triển khai này

ToolAcre không phát hiện điểm cuối từ trang `<link>` hoặc tham khảo ý kiến ​​đăng ký của nhà cung cấp. Đích YouTube là một hằng số nguồn. Một trình phân tích cú pháp, một hình dạng định danh và một trình tạo yêu cầu bao trùm phạm vi đã nêu mà không tìm nạp các trang tùy ý hoặc theo dõi thông tin điểm cuối được quảng cáo bởi HTML không đáng tin cậy.

Discovery sẽ yêu cầu phân tích cú pháp đánh dấu từ xa, xác thực các URL được quảng cáo và quyết định máy chủ nào có thể nhận được yêu cầu theo dõi. Điểm cuối cố định tránh được bề mặt bổ sung đó và giúp việc đánh giá mạng trở nên đơn giản. Nếu YouTube thay đổi dịch vụ thì quá trình tích hợp sẽ yêu cầu thay đổi mã rõ ràng thay vì âm thầm đi theo một điểm đến chưa nhận được đánh giá tương tự.

Tuyên bố áp dụng đa nền tảng nằm ngoài bằng chứng được xác minh

Bản ghi được chuẩn hóa ủng hộ việc kiểm tra và tái sử dụng. JSON giữ nguyên cấu trúc khóa-giá trị, Markdown tạo ghi chú có thể đọc được, CSV phù hợp với khoảng không quảng cáo và văn bản thuần túy phù hợp với vé hoặc nhật ký nghiên cứu. Việc xuất mô hình cục bộ thay vì oEmbed thô sẽ giữ cho tên và phần thiếu sót được căn chỉnh giữa các định dạng, do đó, người dùng tiếp theo không nhận được bốn cách hiểu khác nhau một cách tinh tế.

oEmbed có thể trả về một đoạn HTML iframe nhưng ToolAcre không chèn hay xuất nó. Ứng dụng xây dựng trình phát phản hồi của riêng mình từ ID đã xác thực bằng cách sử dụng máy chủ nâng cao quyền riêng tư của YouTube. Việc tách siêu dữ liệu khỏi kết xuất sẽ tránh việc đánh dấu nhà cung cấp đáng tin cậy và khiến đích đến của người chơi trở thành lựa chọn sản phẩm có thể kiểm tra được thay vì một chuỗi ngược dòng mờ đục.

Giả sử oEmbed cung cấp tiêu đề, `author_name`, `author_url`, hình thu nhỏ 480-by-360, kích thước trình phát và chi tiết nhà cung cấp. ToolAcre thêm ID đã xác thực, ánh xạ các trường tác giả với các trường kênh, giữ nguyên các thứ nguyên có thể sử dụng và ghi lại các thuộc tính không được hỗ trợ. Phép chiếu xác định này có thể duy trì ổn định ngay cả khi ngược dòng thêm khóa mà giao diện không tiêu thụ.

DNS lỗi, trình chặn hoặc chế độ ngoại tuyến là các sự cố truyền tải. Trạng thái không thành công là sự cố HTTP; trạng thái thành công với JSON không đúng định dạng là một vấn đề về phân tích cú pháp. Không nên tạo một bản ghi được phát minh một phần. Các đầu dò hình thu nhỏ vẫn độc lập nên siêu dữ liệu có thể thành công trong khi một hình ảnh bị lỗi hoặc JPEG có thể giải mã khi oEmbed không khả dụng.

Điều này không bao gồm những gì — Open Graph và schema.org, các lớp siêu dữ liệu khác liên kết các bản xem trước được đọc

oEmbed không thay thế Open Graph, schema.org JSON-LD, Dữ liệu YouTube API hoặc bộ nhớ đệm xem trước. Những cơ chế đó có các trường, tính xác thực và độ mới khác nhau. ToolAcre không bao giờ tìm nạp tài liệu đồng hồ để so sánh chúng. Thời lượng, thời gian xuất bản, số liệu thống kê hoặc chú thích yêu cầu nguồn được ủy quyền, không phải phỏng đoán bắt nguồn từ tên hình thu nhỏ hoặc kích thước trình phát.

ID hợp lệ vẫn có thể xác định tài nguyên riêng tư, bị xóa, bị hạn chế hoặc không tồn tại. oEmbed đã đăng xuất không thể công khai. Tiêu đề, tên kênh và tham chiếu hình thu nhỏ cũng có thể thay đổi trong cùng một ID, vì vậy nguồn gốc cần có ngày truy cập. Một bản ghi xuất được tra cứu; nó không đảm bảo tính lâu dài cũng như không cấp phép xuất bản lại tài liệu được trả lại.

Takeaway: yêu cầu được thực hiện và hợp đồng phản hồi bình thường hóa

Phân tích cú pháp và xác thực là cục bộ cho đến khi Tìm nạp. Sau đó, trình duyệt sẽ liên hệ với `www.youtube.com` để có oEmbed và `i.ytimg.com` để biết hình ảnh, bỏ qua thông tin xác thực và người giới thiệu, yêu cầu `no-store` và đi theo các chuyển hướng. Google vẫn thấy từng yêu cầu và tiêu đề Origin của nó. Không có proxy ToolAcre nào ẩn đích hoặc bỏ qua giới hạn truy cập khi đăng xuất.

Hợp đồng rất chính xác: chuẩn hóa thông tin đầu vào được hỗ trợ thành một ID, xây dựng truy vấn chuẩn, yêu cầu JSON thành công, giữ lại tập hợp con trường được ghi lại và đánh dấu các thiếu sót. Giữ nguyên liệu có xảy ra lỗi trong quá trình nhập, truyền tải, HTTP, phân tích cú pháp hoặc truy cập hay không. Bằng chứng đó làm cho việc xuất dữ liệu trở nên hữu ích mà không cần giả vờ phản hồi oEmbed nhỏ gọn là API hoàn chỉnh trên YouTube.