Quản lý danh sách phát

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.

Danh sách phát là tập hợp các video mà bạn có thể xem liên tục và chia sẻ với người dùng khác. Bạn có thể đưa cùng một video vào nhiều danh sách phát.

Thẻ <playlist> xác định danh sách phát bạn muốn tạo, cập nhật hoặc xóa. Các phần sau hiển thị các loại tác vụ khác nhau mà bạn có thể thực hiện cho danh sách phát.

Tạo danh sách phát

Ví dụ sau minh họa cách tạo danh sách phát. Thẻ <name> bên trong thẻ <playlist> chỉ định tên danh sách phát và thẻ <item> xác định video đang được thêm vào danh sách phát. Mỗi thẻ item chỉ định một giá trị cho thuộc tính index, cho biết vị trí video sẽ xuất hiện trong danh sách phát.


    <playlist>
      <name>Comedy highlights
      <item path="/external/video[@id='VIDEO_ID_1_']"/>
      <item path="/external/video[@id='VIDEO_ID_2_']"/>
      <item path="/external/video[@id='VIDEO_ID_3_']"/>
    

Ví dụ trên sử dụng một số cài đặt danh sách phát mặc định. Như vậy, nếu bạn đưa đoạn trích này vào nguồn cấp dữ liệu (có ID video hợp lệ), bạn sẽ thấy hành vi sau:

  • Vì thẻ playlist không chỉ định giá trị cho thuộc tính channel nên danh sách phát sẽ được tạo trong tài khoản người dùng YouTube mặc định đã xác định cho chủ sở hữu nội dung của bạn. Nếu bạn chỉ định giá trị cho thuộc tính channel thì thay vào đó, danh sách phát sẽ được tạo trong kênh đó. (Kênh phải được liên kết với chủ sở hữu nội dung của bạn).

  • Vì thẻ item không chỉ định giá trị cho thuộc tính index nên video sẽ được thêm vào danh sách phát theo thứ tự xuất hiện trong nguồn cấp dữ liệu.

  • Vì không có thẻ nào trong số thẻ item chứa thuộc tính icon (với giá trị True) nên hình thu nhỏ từ video đầu tiên trong danh sách phát sẽ được sử dụng làm biểu tượng của danh sách phát. Nếu bạn đặt thuộc tính icon thành True cho một trong các video trong danh sách phát thì video đó sẽ tự động xuất hiện đầu tiên trong danh sách phát cho dù mọi hướng dẫn sắp xếp khác mà bạn đưa vào cho video trong danh sách phát là gì.

Ngoài ra, lưu ý rằng ví dụ này chỉ định tên danh sách phát của "Comedy highlights". Nếu kênh của bạn đã có danh sách phát với tên đó thì yêu cầu ở trên sẽ tạo danh sách phát thứ hai bằng cùng tên đó.

Cập nhật các mục trong danh sách phát

XML sau đây minh họa cách thêm video bổ sung cho danh sách phát đã tạo trong phần trước:


   <playlist id="PL586D322B5E2764CF">
      <item path="/external/video[@id='VIDEO_ID_4_']"/>
    

Để sắp xếp lại video trong một danh sách phát, hãy sử dụng thuộc tính index của thẻ item để chỉ định rõ thứ tự hiển thị video. XML sau đây cập nhật danh sách phát đã tạo trong phần trước để thay vì video hiển thị theo thứ tự 1-2-3-4 thì sẽ hiển thị theo thứ tự 3-1-4-2. (Video thứ ba có giá trị index1, video đầu tiên có giá trị index2 và v.v.)


 <playlist id="PL586D322B5E2764CF">
      <item index="1" path="/external/video[@id='VIDEO_ID_3_']"/>
      <item index="2" path="/external/video[@id='VIDEO_ID_1_']"/>
      <item index="3" path="/external/video[@id='VIDEO_ID_4_']"/>
      <item index="4" path="/external/video[@id='VIDEO_ID_2_']"/>
   

Ví dụ dưới đây sắp xếp lại video theo cùng cách nhưng sử dụng thuộc tính icon để cho biết rằng video thứ ba hiển thị đầu tiên trong danh sách phát. Giá trị thuộc tính icon thay thế các hướng dẫn sắp xếp khác cho các mục trong danh sách phát:


<playlist id="PL586D322B5E2764CF">
      <item icon="True" path="/external/video[@id='VIDEO_ID_3_']"/>
      <item index="2" path="/external/video[@id='VIDEO_ID_1_']"/>
      <item index="3" path="/external/video[@id='VIDEO_ID_4_']"/>
      <item index="4" path="/external/video[@id='VIDEO_ID_2_']"/>
    

Để xóa video khỏi danh sách phát, đặt giá trị thuộc tính action thành delete cho mục đó. Ví dụ dưới đây xóa video thứ tư khỏi danh sách phát:


  <playlist id="PL586D322B5E2764CF">
      <item action="delete" path="/external/video[@id='VIDEO_ID_4_']"/>
   

Đổi tên danh sách phát

Ví dụ này sử dụng thuộc tính id của thẻ playlist để xác định danh sách phát đang được cập nhật và thẻ <name> để cung cấp tên danh sách phát mới.


  <playlist id="PL586D322B5E2764CF">
     <name>Playlist's new name
  

Đặt danh sách phát làm danh sách phát theo chuỗi

Để đặt danh sách phát làm danh sách phát theo chuỗi, hãy đặt giá trị thuộc tính series của thẻ <playlist> thành True cho danh sách phát đó. Theo mặc định, danh sách phát không được tạo dưới dạng danh sách phát theo chuỗi và nếu bạn không chỉ định giá trị cho thuộc tính series thì YouTube sẽ không cập nhật trạng thái hiện tại của danh sách phát.

XML sau đây cập nhật danh sách phát đã tạo trong ví dụ trên vào danh sách phát theo chuỗi:


<playlist series="True"/>
    <name>Comedy highlights

* Nguồn: Youtube