Đọc báo cáo trạng thái
30/11/2019
Định dạng XML của YouTube sẽ được thay bằng DDEX (chỉ âm nhạc) và mẫu CSV (tất cả các ngành). YouTube không khuyến khích bất kỳ hoạt động triển khai mới nào về định dạng XML của YouTube. Bạn chỉ nên sử dụng trang này làm tài liệu tham chiếu cho các hoạt động triển khai hiện có. Hãy truy cập vào phần Sử dụng nguồn cấp dữ liệu DDEX của YouTube để biết thêm thông tin về định dạng mới.
Chỉ những đối tác sử dụng Trình quản lý nội dung của YouTube để quản lý nội dung có bản quyền mới có thể dùng các tính năng mô tả trong bài viết này.
Sau khi xử lý nguồn cấp dữ liệu, YouTube đăng báo cáo trạng thái XML xác định các tác vụ mà YouTube đã thực hiện khi xử lý nguồn cấp dữ liệu và cho biết liệu mỗi tác vụ đã được xử lý thành công hay chưa.
Thẻ <Feed> là phần tử gốc trong báo cáo trạng thái. Thẻ phụ của nó xác định người tải lên nguồn cấp dữ liệu, thời gian YouTube đăng báo cáo trạng thái, nguồn cấp dữ liệu XML gốc được liên kết với báo cáo và ID duy nhất mà YouTube sử dụng để xác định nỗ lực xử lý nguồn cấp dữ liệu đó. Phần tử này cũng chứa một thẻ <action> cho mỗi tác vụ được thực hiện trong nguồn cấp dữ liệu.
Bảng dưới đây xác định các tác vụ khác nhau đã xác định trong báo cáo trạng thái và cũng liệt kê thông tin mà báo cáo trạng thái trả về cho mỗi tác vụ. Bạn có thể xem báo cáo trạng thái mẫu. Giá trị cột Action name tương ứng với giá trị của thuộc tính name của thẻ <action>. Lưu ý rằng một số phần tử con có thể vắng mặt nếu tác vụ không thành công trong khi <status_detail> chỉ có thể có mặt nếu tác vụ không thành công.
| Tên hành động | Tác vụ con | Mô tả | Phần tử con |
|---|---|---|---|
| Parse | Tác vụ này cho biết liệu nguồn cấp dữ liệu có được phân tích cú pháp đúng hay không. Nếu không thể phân tích cú pháp nguồn cấp dữ liệu thì không có tác vụ nào đã yêu cầu trong nguồn cấp dữ liệu sẽ được hoàn tất. Nếu nguồn cấp dữ liệu có thể phân tích được nhưng chứa lỗi không nghiêm trọng, chẳng hạn như đưa vào thẻ XML bị bỏ qua cho một nội dung cụ thể thì tác vụ này sẽ được báo cáo bằng trạng thái Success và lỗi không nghiêm trọng sẽ được báo cáo bằng tác vụ Report error. Lưu ý rằng nếu nguồn cấp dữ liệu XML của bạn đặt thuộc tính strict của thẻ <feed> thành True thì mọi lỗi phân tích cú pháp sẽ được xử lý dưới dạng lỗi nghiêm trọng. | <status> <status_detail>? <timestamp> |
|
| Process asset | Set metadata Set ownership Set rights policy |
Nội dung đã được chèn hoặc cập nhật. Tác vụ con của nó xác định thay đổi cụ thể đối với nội dung. | <command> <id> <in_file> <status> <status_detail>? <timestamp> <action>* |
| Set metadata | YouTube đã đặt siêu dữ liệu nội dung để khớp với các giá trị trong nguồn cấp dữ liệu. | <status> <status_detail>? <timestamp> |
|
| Set ownership | YouTube đã đặt dữ liệu quyền sở hữu của nội dung để khớp với các giá trị trong nguồn cấp dữ liệu. Đối với tác vụ này, giá trị thẻ <in_file> chứa XPath xác định quy tắc quyền sở hữu được liên kết với nội dung. | <in_file> <status> <status_detail>? <timestamp> |
|
| Set rights owner | YouTube đã đặt chủ sở hữu của nội dung sáng tác thành nhà xuất bản được chỉ định trong nguồn cấp dữ liệu. Báo cáo trạng thái sẽ chứa một tác vụ Set rights owner cho mỗi chủ sở hữu của loại publisher được liệt kê trong nguồn cấp dữ liệu. Ví dụ: nếu ba nhà xuất bản cùng sở hữu một sáng tác thì báo cáo trạng thái sẽ chứa ba tác vụ Set rights owner. | <status> <status_detail>? <timestamp> |
|
| Set rights policy | YouTube đã đặt chính sách đối sánh cho nội dung. YouTube sẽ áp dụng chính sách đối sánh cho video do người dùng tải lên khớp với nội dung đó. Đối với tác vụ này, giá trị thẻ in_file> chứa XPath xác định chính sách. Lưu ý rằng tác vụ Set rights policy cũng được báo cáo khi YouTube xử lý xác nhận quyền sở hữu và trong suốt luồng xử lý đó, chính sách được đặt là chính sách sử dụng. | <policy> <status> <status_detail>? <timestamp> |
|
| Process file | Submit reference Submit video Submit AudioSwap track Submit image Submit Timed Text |
Một tệp đã được tải lên YouTube. Tác vụ con giải thích cách sử dụng tệp. Ví dụ: có thể sử dụng tệp để tạo tham chiếu (đối với tệp âm thanh hoặc video), để đặt hình thu nhỏ tùy chỉnh cho video (đối với tệp hình ảnh) hoặc để cung cấp phụ đề (văn bản có thời gian) cho video. Tệp âm thanh cũng có thể được đưa vào Hoán đổi âm thanh. | <filename> <in_file> <status> <status_detail>? <timestamp> <action>* |
| Submit reference | Tệp đã được liên kết với nội dung để tạo tham chiếu. Thẻ <id> đã báo cáo cho tác vụ này sẽ chỉ định ID tham chiếu của tham chiếu mới cũng như ID nội dung của nội dung được liên kết. Nếu tham chiếu cũng đang được liên kết với video thì tác vụ này cũng sẽ chứa thẻ <id> cung cấp ID video của video đó. | <command> <id>* <status> <status_detail>? <timestamp> |
|
| Submit video | Một video YouTube mới đã được tạo bằng nội dung của tệp. Thẻ <id> đã báo cáo cho tác vụ này sẽ chỉ định ID video mà YouTube gán để nhận dạng duy nhất video mới. | <command> <id> <status> <status_detail>? <timestamp> |
|
| Submit AudioSwap track | Tệp bản ghi âm đã được đưa vào chương trình Hoán đổi âm thanh của YouTube. | <status> <status_detail>? <timestamp> |
|
| Submit image | Bạn đã liên kết hình ảnh với một video cụ thể. Thẻ <artwork> xác định các loại hình ảnh khác nhau mà bạn có thể liên kết với video. Hoặc bạn đã đặt hình thu nhỏ tùy chỉnh cho video. | <status> <status_detail>? <timestamp> |
|
| Submit Timed Text | Bạn đã thêm phụ đề gốc cho video. | <command> <status> <status_detail>? <timestamp> |
|
| Process claim | Set rights policy Claim video |
YouTube đã cố gắng xác nhận quyền sở hữu video cho tài khoản của bạn và đặt chính sách cho xác nhận quyền sở hữu đó. Nếu thành công, tác vụ này sẽ bao gồm các thẻ <id> xác định video đang được xác nhận quyền sở hữu và ID nội dung khớp với video được xác nhận quyền sở hữu đó. | <command> <id> <status> <status_detail>? <timestamp> <action>* |
| Set rights policy | YouTube đã cố gắng đặt chính sách sử dụng cho video của bạn. Chính sách sử dụng sẽ hướng dẫn YouTube về cách xử lý video mà bạn đã tải lên. Lưu ý rằng tác vụ Set rights policy cũng được báo cáo khi YouTube xử lý một nội dung và trong luồng xử lý đó, chính sách được đặt là chính sách đối sánh. |
<policy> <status> <status_detail>? <timestamp> |
|
| Claim video | YouTube đã xác nhận quyền sở hữu video tải lên của bạn. Thẻ <in_file> chỉ định giá trị XPath xác định video đó trong nguồn cấp dữ liệu XML của bạn. | <status> <status_detail>? <timestamp> |
|
| Update video | YouTube đã cố gắng cập nhật siêu dữ liệu của video. Thẻ <id> đã báo cáo cho tác vụ này sẽ chỉ định ID video mà người dùng YouTube sử dụng để nhận dạng duy nhất video và thẻ <in_file> chứa XPath xác định video đó trong nguồn cấp dữ liệu XML của bạn. | <command> <id> <status> <status_detail>? <timestamp> |
|
| Update reference | YouTube đã cố gắng kích hoạt, hủy kích hoạt hoặc xóa tham chiếu. Thẻ <id> đã báo cho tác vụ này sẽ chỉ định ID tham chiếu mà YouTube sử dụng để nhận dạng tham chiếu và thẻ <in_file> chứa XPath xác định tham chiếu trong nguồn cấp dữ liệu XML của bạn. Nếu bạn kích hoạt hoặc hủy kích hoạt thành công tham chiếu thì giá trị của thẻ <command> sẽ là Cập nhật và giá trị của thẻ <command_detail> sẽ là Activate hoặc Deactivate. Nếu bạn xóa tham chiếu thành công thì giá trị của thẻ <command> sẽ là Delete. | <command> <command_detail>? <id> <status> <status_detail>? <timestamp> |
|
| Set asset relationship | YouTube đã cố gắng liên kết hai nội dung bằng cách biểu thị rằng một nội dung chứa nội dung kia. Đối với tác vụ này, thẻ <in_file> sẽ xác định mối quan hệ liên kết hai nội dung trong nguồn cấp dữ liệu của bạn. | <in_file> <status> <status_detail>? <timestamp> |
|
| Set playlist | YouTube đã tạo, cập nhật hoặc xóa danh sách phát dựa trên hướng dẫn trong nguồn cấp dữ liệu của bạn. Thẻ <id> đã báo cáo cho tác vụ này sẽ chỉ định ID danh sách phát mà YouTube sử dụng để nhận dạng duy nhất danh sách phát và thẻ <in_file> chứa XPath xác định danh sách phát trong nguồn cấp dữ liệu XML của bạn. | <command> <id> <in_file> <status> <status_detail>? <timestamp> |
|
| Report error | Nguồn cấp dữ liệu của bạn chứa một hoặc nhiều lỗi không nghiêm trọng. Lỗi không nghiêm trọng cần phải được trình phân tích cú pháp bỏ qua. Ví dụ: lỗi không nghiêm trọng sẽ xuất hiện nếu bạn đã đưa thẻ siêu dữ liệu không mong đợi vào cho một nội dung và không đặt thuộc tính nghiêm ngặt thành true cho nguồn cấp dữ liệu của bạn. Trong trường hợp này, YouTube sẽ chỉ bỏ qua thẻ không mong đợi. | <status> <status_detail>? <timestamp> |
* Nguồn: Youtube