Video và phụ đề · Trình tải xuống hình thu nhỏ & Trình xem siêu dữ liệu của YouTube
Cách oEmbed trả về tiêu đề, kênh và mã nhúng công khai của video
· Cách thức hoạt động
youtube nhúng siêu dữ liệu
Có một cách tiêu chuẩn, không cần chìa khóa để yêu cầu trang web video cung cấp tiêu đề công khai, tác giả và nội dung nhúng HTML của liên kết. Bài đăng này giải thích oEmbed, yêu cầu và phản hồi trông như thế nào cũng như cách một công cụ có thể hiển thị siêu dữ liệu mà không cần quét trang.
Tiêu đề và kênh mà không cần tải trang — câu hỏi mà oEmbed được thiết kế để trả lời
Blogger có thể tìm hiểu tiêu đề và kênh hiện tại của video công khai mà không cần tải trang xem. ToolAcre chỉ yêu cầu điểm cuối oEmbed của YouTube về bản ghi JSON có cấu trúc sau khi khách truy cập nhấn Tìm nạp một cách rõ ràng. Trình tự đó cũng ngăn việc tra cứu siêu dữ liệu không thành công khỏi bị nhầm lẫn với URL không đúng định dạng, vì hai giai đoạn có bằng chứng khác nhau.
Liên kết được phân tích cú pháp đầu tiên trong trình duyệt. Ánh sáng trước đó xác thực và trích xuất ID mà không cần truy cập mạng, ngăn chặn đầu vào không đúng định dạng khỏi cả máy chủ hình thu nhỏ và điểm cuối siêu dữ liệu. Điểm cuối cung cấp một đại diện công khai hẹp, không phải nguồn cấp dữ liệu cho mục đích chung hoặc cơ chế ủy quyền.
oEmbed là gì — một tiêu chuẩn nhỏ trong đó trang web xuất bản điểm cuối trả lời 'mô tả điều này URL' bằng JSON
oEmbed là quy ước yêu cầu và phản hồi để mô tả URL công khai. Tại đây, YouTube cung cấp điểm cuối chấp nhận video URL và trả về các trường JSON dùng để nhúng và phân bổ. Truy vấn chính xác rất hữu ích trong theo dõi Mạng vì nó hiển thị tài nguyên chuẩn nào được yêu cầu mà không làm lộ thông tin xác thực tài khoản.
ToolAcre coi điểm cuối đó như một trần nhà chứ không phải là một cánh cửa để cạo. Nó không kiểm tra trang xem HTML, dịch vụ youtubei nội bộ, chữ ký hoặc bất kỳ thứ gì mà yêu cầu công khai đã đăng xuất không thể tiếp cận được. Một trường có thể xuất hiện ở dạng JSON thô và vẫn bị cố ý bỏ qua khỏi hợp đồng ứng dụng, vì vậy việc chuẩn hóa là một quyết định về sản phẩm. Điều đó giúp các ghi chú xuôi dòng không bị phụ thuộc vào những bổ sung ngẫu nhiên ngược dòng.
Yêu cầu — video URL và thông số định dạng, không có gì hơn, được gửi tới youtube.com
Yêu cầu được chuyển đến https://www.youtube.com/oembed với url được đặt thành giá trị https://www.youtube.com/watch?v=ID chuẩn và định dạng được đặt thành json. Không có khóa API, cookie đăng nhập hoặc mã thông báo tài khoản nào được thêm vào. Do đó, kết quả trống là quan sát ranh giới chứ không phải bằng chứng cho thấy mã định danh không hợp lệ hoặc dữ liệu được bảo vệ cần được thử lại.
Trình duyệt gửi GET ẩn danh với thông tin xác thực bị bỏ qua, không có liên kết giới thiệu, bộ nhớ đệm không lưu trữ và các chuyển hướng được theo dõi. Google nhận trực tiếp nó và tiêu đề Origin của nó; ToolAcre không vận hành máy chủ hoặc proxy nào trong đường dẫn đó. Điều này giúp quá trình xuất ổn định khi tải trọng ngược dòng chứa các trường bổ sung mà công cụ không hứa hẹn sẽ lưu giữ.
Phản hồi được chuẩn hóa hiển thị các trường siêu dữ liệu chứ không phải oEmbed HTML
Đường viền được hứa hẹn hiển thị nhúng HTML, nhưng normalizeOembed cố tình loại bỏ trường đó. Đối tượng được chuẩn hóa chứa tiêu đề, kênh, kênh URL, hình thu nhỏ URL và kích thước, chiều rộng và chiều cao của trình phát, nhà cung cấp và ID video. Việc phân loại lỗi riêng biệt giúp người dùng quyết định có nên thử lại, kiểm tra phản hồi hay chọn một nguồn được phép khác.
Mọi giá trị đều được bảo vệ: văn bản bị thiếu sẽ được dự phòng đơn giản, kích thước phải dương và liên kết phải là HTTPS. Điều này làm cho JSON được xuất có thể dự đoán được mà không ngụ ý rằng mọi thuộc tính oEmbed thô đều được hiển thị. Yêu cầu có thể được kiểm tra trong DevTools, nhưng bản ghi trình duyệt không ngụ ý việc lưu trữ bằng ToolAcre hoặc chỉ xử lý cục bộ.
Tại sao không cần chìa khóa hoặc thông tin đăng nhập — dữ liệu đã được công khai trên trang; oEmbed chỉ làm cho nó có cấu trúc
Không cần khóa vì đây là siêu dữ liệu công khai đã đăng xuất nhưng công khai không có nghĩa là phổ biến. Các video riêng tư, đã xóa và bị giới hạn độ tuổi không cung cấp bản ghi, trong khi chủ sở hữu tắt tính năng nhúng có thể gây ra phản hồi ủy quyền. Do đó, nhà xuất bản xem xét yêu cầu không thành công nên kiểm tra tính khả dụng của nội dung nhúng và khả năng hiển thị video thay vì cho rằng ID 11 ký tự được phân tích cú pháp không chính xác.
Ranh giới vắng mặt rất rõ ràng: không có lượt xem, lượt thích, mô tả, thẻ, thời lượng, ngày xuất bản hoặc chú thích nào được tổng hợp. Điểm cuối không có khóa không cấp quyền truy cập ngoài những gì YouTube chọn xuất bản. Nếu bảng tính biên tập cần những trường bị bỏ qua, tác giả của nó phải sử dụng một nguồn được phép khác và gắn nhãn nguồn đó thay vì hiển thị khoảng trống dưới dạng dữ liệu oEmbed.
Ví dụ đã hoạt động: ánh xạ oEmbed JSON vào bản ghi chuẩn hóa của ToolAcre
Đối với một lần tải thành công, tiêu đề sẽ ánh xạ tới tiêu đề, tên tác giả tới kênh, url tác giả tới URL kênh, trường hình thu nhỏ tới mô tả hình ảnh lồng nhau cũng như chiều rộng và chiều cao tới kích thước trình phát. nhà cung cấp_name trở thành nhà cung cấp. Ánh xạ này giúp xuất tên ứng dụng ổn định mặc dù quy ước ngược dòng sử dụng thuật ngữ tác giả cho kênh YouTube.
HTML thô có thể xuất hiện ở thượng nguồn nhưng kết quả ToolAcre và các bản xuất không hiển thị nó. Ứng dụng này xây dựng riêng biệt iframe tăng cường quyền riêng tư đáp ứng của riêng mình từ ID đã xác thực, tránh sự tin cậy vô tình vào đánh dấu điểm cuối. Người tiêu dùng nhận được thông tin mà họ có thể trích dẫn hoặc tuần tự hóa, trong khi đánh dấu nhúng có thể thực thi vẫn nằm ngoài hợp đồng siêu dữ liệu được chuẩn hóa.
Điều này không bao gồm những gì - số lượt xem, mô tả, nhận xét, chú thích và bất cứ điều gì đằng sau một lần đăng nhập
Nỗ lực siêu dữ liệu có thể không thành công trước khi phản hồi do chế độ ngoại tuyến, trình chặn hoặc proxy; nó có thể bị lỗi ở trạng thái HTTP; hoặc nó có thể trả về trạng thái thành công với JSON không hợp lệ. Mỗi tuyến nhận được một tin nhắn khác nhau. Lỗi truyền tải đề xuất kiểm tra môi trường trình duyệt, trong khi JSON không hợp lệ xác định phản hồi đã đến nhưng không thể đáp ứng định dạng đã hứa của điểm cuối.
Việc thăm dò hình thu nhỏ là độc lập và có thể thấy 404, một lỗi khác, phần giữ chỗ 200 hoặc dữ liệu không thể giải mã được. Cả chi nhánh đều không tải xuống video cũng như không bỏ qua các hạn chế đối với nội dung riêng tư, bị xóa hoặc bị giới hạn độ tuổi. Việc giữ các nhánh độc lập cho phép người biên tập giữ lại người đăng đã được xác minh ngay cả khi việc ghi công tiêu đề tạm thời không khả dụng mà không phát minh ra siêu dữ liệu bị thiếu.
Siêu dữ liệu công khai có cấu trúc mà không hiển thị nội dung nhúng của điểm cuối HTML
Kết quả là siêu dữ liệu công khai có cấu trúc chứ không phải bản sao oEmbed HTML tùy ý. ToolAcre có thể xuất các dữ kiện được chuẩn hóa dưới dạng JSON, Markdown, CSV hoặc văn bản và có thể tạo các liên kết đã biết từ mã định danh đã xác thực. Lựa chọn xuất thay đổi cách trình bày chứ không phải phạm vi: mọi định dạng đều phản ánh cùng tiêu đề, kênh, hình ảnh, trình phát, nhà cung cấp và bản ghi ID.
Sau khi Tìm nạp, lưu lượng truy cập bao gồm các yêu cầu hình ảnh i.ytimg.com trực tiếp và một yêu cầu oEmbed chuẩn. Các yêu cầu bỏ qua thông tin xác thực và liên kết giới thiệu, sử dụng chuyển hướng không lưu trữ và chuyển hướng được theo dõi, đồng thời vẫn hiển thị để xác minh trong bảng điều khiển Mạng của trình duyệt. Dấu vết đó chứng tỏ trình duyệt đã liên hệ trực tiếp với Google; nó không hiển thị ToolAcre lưu trữ tra cứu và cũng không thực hiện thao tác cục bộ.