Thu thập mã nhận dạng, URL và tên cho nội dung của bạn

Các thực thể nội dung trong danh mục của bạn thường yêu cầu các thuộc tính sau:

  • @id: Giá trị nhận dạng chung cho thực thể.
  • url: URL chính tắc cho nội dung. Không sử dụng url trên các thực thể BroadcastEvent, SportsEvent hoặc nhóm kênh (TelevisionChannel và CableOrSatelliteService).
  • name: Tên của nội dung.

Ví dụ về @id, url và name:

"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",

Số nhận dạng

Giá trị nhận dạng (@id) phải đáp ứng các yêu cầu sau:

  • Duy nhất trên toàn hệ thống trong danh mục của bạn
    • Ví dụ: đừng sử dụng cùng một @id cho TVSeries và TVSeason.
  • Tĩnh
    • Bạn không thể thay đổi @id sau này.
  • Ở dạng Giá trị nhận dạng tài nguyên thống nhất (URI)
    • Nếu giá trị nhận dạng (mã nhận dạng) cục bộ của nội dung không ở định dạng URI, hãy thêm miền của bạn vào trước mã nhận dạng để đáp ứng yêu cầu này; ví dụ: nếu mã nhận dạng của nội dung là 1234abc và miền của bạn là https://example.com, thì @id có thể là https://example.com/1234abc.
    • @id không cần phải là một URL đang hoạt động; mà chỉ cần có định dạng URI.
    • Miền mà bạn dùng trong @id (ví dụ: https://example.com) phải thuộc sở hữu của tổ chức của bạn.

Vì url của một thực thể đáp ứng tất cả yêu cầu của một giá trị nhận dạng (tức là duy nhất trên toàn cầu, tĩnh và ở dạng URI), nên bạn nên sử dụng url của một thực thể làm @id.

URL chuẩn

URL chính tắc (url) giúp Google đối chiếu chính xác nội dung trong danh mục của bạn với nội dung trong cơ sở dữ liệu của Google.

"URL chính tắc là URL của trang mà Google đánh giá là tiêu biểu nhất trong số những trang trùng lặp trên trang web của bạn. Ví dụ: Nếu bạn dùng nhiều URL cho cùng một trang (chẳng hạn như example.com?dress=1234 và example.com/dresses/1234), thì Google sẽ chọn một trong số đó làm URL chính tắc." (Nguồn: Hợp nhất các URL trùng lặp)

Sau đây là các yêu cầu đối với URL chính tắc:

  • url phải là duy nhất trên toàn hệ thống.
  • url phải chứa một URL chính tắc đang hoạt động mà Google có thể thu thập dữ liệu.
  • (Chỉ dành cho Hành động nghe) url cần trỏ đến một trang mô tả nội dung không bị tường phí chặn.
  • (Truyền hình trực tuyến) Không bao gồm các thực thể url trên BroadcastEvent. Đối với chương trình truyền hình và phim phát sóng, hãy cung cấp url trên thực thể Movie, TVSeries hoặc TVEpisode cơ bản.
  • (Thể thao) Không thêm url vào thực thể SportsEvent. Cung cấp đường liên kết phát bằng SportsEvent.potentialAction.
  • (Truyền hình trực tiếp và Thể thao) Đảm bảo BroadcastEvent.@id khác với @id của thực thể Movie, TVSeries, TVEpisode hoặc SportsEvent được tham chiếu.

Thu thập mã nhận dạng, URL và tên

Hãy thực hiện như sau:

  1. Thu thập tên của nội dung trong danh mục của bạn.
  2. Xác định URL chính tắc của nội dung. (Bạn nên sử dụng url của nội dung làm @id.)