Ví dụ về nguồn cấp dữ liệu cho Hành động xem

Các ví dụ sau đây minh hoạ một số trường hợp phổ biến đối với Hành động trên YouTube.

Lưu ý quan trọng: Để ngắn gọn, tất cả ví dụ bên dưới đều bỏ qua phong bì nguồn cấp dữ liệu. Đây là đối tượng cấp cao nhất trong nguồn cấp dữ liệu Hành động trong nội dung nghe nhìn và chứa một mảng các thực thể đại diện cho nội dung trong danh mục của bạn. Tất cả nguồn cấp dữ liệu gửi đến Google phải bao gồm phong bì nguồn cấp dữ liệu như phần Tổng quan cho biết.

Thận trọng: Các ví dụ bên dưới chỉ cho thấy các thực thể và thuộc tính phù hợp nhất với trường hợp được đề cập trong ví dụ. Có thể bạn cần thêm các thực thể và thuộc tính khác trước khi nguồn cấp dữ liệu được phân phối đến Google.

Thực thể mẫu của từng loại

Phim

Một thực thể Movie đại diện cho một bộ phim hư cấu có tên là "Bộ phim yêu thích của tôi"

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie",
  "url": "http://www.example.com/my_favorite_movie",
  "name": "My Favorite Movie",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "This is my favorite movie.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    }
  ]
}

TVSeries

Một thực thể TVSeries đại diện cho một chương trình truyền hình hư cấu có tên "Chương trình truyền hình yêu thích của tôi"

 {
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type": "TVSeries",
   "@id": "http://www.example.com/my_favorite_tv_show/",
   "url": "http://www.example.com/my_favorite_tv_show/",
   "name": "My Favorite TV Show",
   "potentialAction": {
     "@type": "WatchAction",
     "target": {
       "@type": "EntryPoint",
       "urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?autoplay=true",
       "inLanguage": "en",
       "actionPlatform": [
         "http://schema.org/DesktopWebPlatform",
         "http://schema.org/MobileWebPlatform",
         "http://schema.org/AndroidPlatform",
         "http://schema.org/AndroidTVPlatform",
         "http://schema.org/IOSPlatform",
         "http://schema.googleapis.com/GoogleVideoCast"
       ]
     },
       "actionAccessibilityRequirement": {
         "@type": "ActionAccessSpecification",
         "category": "subscription",
         "requiresSubscription": {
           "@type": "MediaSubscription",
           "name": "Example Package",
           "commonTier": true,
           "@id": "https://example.com/package/example"
         },
         "availabilityStarts": "2017-07-21T10:35:29Z",
         "availabilityEnds": "2018-10-21T10:35:29Z",
         "eligibleRegion": [
           {
             "@type": "Country",
             "name": "US"
           },
           {
             "@type": "Country",
             "name": "CA"
           }
         ]
     }
   },
   "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
   "releasedEvent": {
     "@type": "PublicationEvent",
     "startDate": "2008-01-20",
     "location": {
       "@type": "Country",
       "name": "US"
     }
   },
   "popularityScore": {
     "@type": "PopularityScoreSpecification",
     "value": 4.1,
     "eligibleRegion": [
       {
         "@type": "Country",
         "name": "US"
       },
       {
         "@type": "Country",
         "name": "CA"
       }
     ]
   },
   "description": "This is my favorite TV show.",
   "contentRating": "RATING NOT KNOWN",
   "actor": [
     {
       "@type": "Person",
       "name": "John Doe",
       "sameAs": "https://en.wikipedia.org/wiki/john_doe"
     },
     {
       "@type": "Person",
       "name": "Jane Doe",
       "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
     }
   ],
   "identifier": [
       {
         "@type": "PropertyValue",
         "propertyID": "IMDB_ID",
         "value":  "tt0903747"
       }
     ]
 }
 ```

TVEpisode

Một thực thể TVEpisode đại diện cho tập 14 của phần 7 trong chương trình truyền hình hư cấu có tên "Chương trình truyền hình yêu thích của tôi"

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVEpisode",
  "@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "url": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "name": "John Doe returns with a horse",
  "episodeNumber": 14,
  "contentRating": "TVPG TV-MA",
  "partOfSeason": {
    "@type": "TVSeason",
    "@id": "http://www.example.com/my_favorite_tv_show/s7",
    "seasonNumber": 7
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
        "availabilityStarts": "2017-07-21T10:35:29Z",
        "availabilityEnds": "2018-10-21T10:35:29Z",
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "CA"
          }
        ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
  "duration": "PT00H25M",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2014-01-09",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 3.9,
    "eligibleRegion": "EARTH"
  },
  "description": "John Doe returns to the village three years after his disappearance.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt3453320"
    }
}

TVSeason

Một thực thể TVSeason đại diện cho phần 7 của một chương trình truyền hình hư cấu có tên "Chương trình truyền hình yêu thích của tôi"

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeason",
  "@id": "http://www.example.com/my_favorite_tv_show/s7",
  "url": "http://www.example.com/my_favorite_tv_show/s7",
  "name": "Season 7",
  "seasonNumber": 7,
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
        "availabilityStarts": "2017-07-21T10:35:29Z",
        "availabilityEnds": "2018-10-21T10:35:29Z",
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
      }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2010-09-23",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "The seventh season of My Favorite TV Show.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ]
}

Tổ chức (Nhà cung cấp dịch vụ truyền hình)

Một thực thể Organization đại diện cho một nhà cung cấp dịch vụ truyền hình hư cấu, "Công ty truyền hình cáp mẫu", cung cấp dịch vụ Truyền hình trực tiếp qua mạng truyền hình cáp

{
  "@context":"http://schema.org",
  "@type":"Organization",
  "@id": "http://example.com/example_cable_tv_company",
  "name": "Example Cable TV Company",
  "sameAs": "https://en.wikipedia.org/wiki/example_cable_company"
}

CableOrSatelliteService

CableOrSatelliteService đại diện cho các dịch vụ truyền hình cáp ở New York (DMA_ID=501), do nhà cung cấp dịch vụ truyền hình trên toàn quốc "Công ty truyền hình cáp mẫu" cung cấp

{
  "@context":"http://schema.org",
  "@type":"CableOrSatelliteService",
  "@id":"http://example.com/example_cable_tv_company_new_york",
  "name":"Example Cable TV Company - New York",
  "provider": {
    "@type": "Organization",
    "@id": "http://example.com/example_cable_tv_company",
  },
  "areaServed":[
    {
      "@type": "GeoShape",
      "@id": "http://example.com/newyork_01",
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "DMA_ID",
          "value": "501"
        }
      ]
    }
  ]
}

Tổ chức

Một thực thể Organization đại diện cho kênh "ExampleTV Channel" (Kênh ExampleTV) do nhà cung cấp dịch vụ truyền hình hư cấu "Example Cable TV Company" (Công ty truyền hình cáp Example) ở New York cung cấp cho người dùng

{
  "@context":"http://schema.org",
  "@type":"Organization",
  "@id":"http://example.com/exampletv",
  "name":"ExampleTV Channel",
  "sameAs": "https://en.wikipedia.org/wiki/exampletv"
}

BroadcastService

Một thực thể BroadcastService đại diện cho kênh "ExampleTV Channel" (Kênh ExampleTV). Kênh này do nhà cung cấp dịch vụ truyền hình hư cấu "Example Cable TV Company" (Công ty truyền hình cáp Example) ở New York cung cấp cho người dùng. Các thực thể BroadcastService cung cấp thông tin chi tiết về đường liên kết sâu và yêu cầu truy cập cho kênh

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"https://www.example.com/exampletv/broadcast/hd",
  "name": "ExampleTV Channel",
  "description": "A fictional TV broadcast service in HD",
  "broadcastDisplayName":"ExampleTV-Channel",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://www.example.com/exampletv"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": [
      {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/exampletv/broadcast/hd?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/AndroidTVPlatform",
          "http://schema.org/IOSPlatform"
        ]
      },
      {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/exampletv/broadcast/androidtv/hd?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      }
    ],
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://www.example.com/exampletv/basic_subscription",
        "name": "Basic subscription",
        "identifier": "example.com:basic",
        "commonTier": true
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  },
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value": "102610"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "_PARTNER_ID_",
      "value": "exampletv-12345"
    }
  ]
}

TelevisionChannel

Một thực thể TelevisionChannel cho biết rằng kênh "ExampleTV Channel" có trên kênh 7 và là một phần của dịch vụ truyền hình cáp do nhà cung cấp dịch vụ truyền hình hư cấu "Example Cable TV Company" cung cấp ở New York

{
  "@context":"http://schema.org",
  "@type":"TelevisionChannel",
  "@id":"http://example.com/example_cable_tv_company_san_francisco/exampletv",
  "broadcastChannelId":"7",
  "broadcastServiceTier":"Standard",
  "inBroadcastLineup":{
    "@type":"CableOrSatelliteService",
    "@id":"http://example.com/example_cable_tv_company_san_francisco_bay"
  },
  "providesBroadcastService":{
    "@type":"BroadcastService",
    "@id":"https://www.example.com/exampletv/broadcast/hd"
  }
}

BroadcastEvent

Một thực thể BroadcastEvent đại diện cho việc phát sóng một bộ phim trên "Kênh ExampleTV" từ 5 giờ chiều đến 7 giờ tối vào ngày 12 tháng 7 năm 2019.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live/movie/new_release",
  "name": "My Favorite Movie",
  "description": "John Doe spent years perfecting his survival skills in a tropical jungle.",
  "startDate": "2019-07-12T17:00-08:00",
  "endDate": "2019-07-12T19:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": "False",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "workPerformed": {
    "@type": "Movie",
    "@id": "http://www.example.com/my_favorite_movie"
  }
}

SportsEvent

Một thực thể SportsEvent đại diện cho một trận đấu bóng rổ giữa hai đội

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/basketball/professional/final_game_6",
  "name":"2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "sport":"https://en.wikipedia.org/wiki/Basketball",
  "description": {
      "@language": "en",
      "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
    },
  "startDate": "2018-09-16T10:00-08:00",
  "endDate": "2018-09-16T13:00-08:00",
  "homeTeam":{
    "@type":"SportsTeam",
    "name":"Team B",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization":{
      "@type":"SportsOrganization",
      "name":"Professional Basketball League",
      "sameAs":"http://www.example.com/professional_basketball_league"
    },
    "athlete":[
      {
        "@type":"Person",
        "name":"John doe"
      }
    ]
  },
  "awayTeam":{
    "@type":"SportsTeam",
    "name":"Team A",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "athlete":[
      {
        "@type":"Person",
        "name":"Jane Doe"
      }
    ]
  },
  "location":{
    "@type":"Place",
    "name":"Example Stadium",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value":  "EP000194303282"
    }
  ]
}

Ví dụ liên quan đến đường liên kết sâu

Cung cấp đường liên kết sâu không phổ quát

Một thực thể có đường liên kết kiểu cũ cho nền tảng Android và một đường liên kết sâu chung cho tất cả các nền tảng khác

  "potentialAction": {
    "@type": "WatchAction",
    "target": [
      {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      
      {
        "@type": "EntryPoint",
        "urlTemplate": "android-app://com.example/example-scheme/my_favorite_movie?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/AndroidPlatform",
          "http://schema.org/AndroidTVPlatform"
        ]
      }
    ],
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package"
       },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  }

Cung cấp các yêu cầu về hỗ trợ tiếp cận có giới hạn thời gian

Một thực thể thay đổi yêu cầu hỗ trợ tiếp cận theo thời gian: free trong một khoảng thời gian giới hạn và subscription sau đó

  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": [
      {
        "@type": "ActionAccessSpecification",
        "category": "free",
        "availabilityStarts": "2019-01-01T00:00Z",
        "availabilityEnds": "2019-05-31T00:00Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      },
      {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-06-01T10:35:29Z",
        "availabilityEnds": "2020-06-01T10:35:29Z",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "http://www.example.com/example_package"
         },
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "CA"
          }
        ]
      }
    ]
  }

Cung cấp nhiều yêu cầu về khả năng hỗ trợ tiếp cận dựa trên nền tảng

Một thực thể có nhiều yêu cầu về hỗ trợ tiếp cận dựa trên nền tảng: free cho nền tảng Máy tính và Thiết bị di động và subscription cho nền tảng ChromeCast

  "potentialAction": [
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/AndroidTVPlatform",
          "http://schema.org/IOSPlatform"
        ]
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "free",
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      }
    },
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": "http://schema.googleapis.com/GoogleVideoCast",
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "http://www.example.com/example_package"
         },
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "CA"
          }
        ]
      }
    }
  ]

Cách sử dụng thuộc tính additionalProperty

Một thực thể Phim giới thiệu cách sử dụng thuộc tính additionalProperty và các thuộc tính phụ của thuộc tính này để cung cấp thông tin về nội dung và ngôn ngữ phụ đề, định dạng video và góc máy được sử dụng.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie",
  "url": "http://www.example.com/my_favorite_movie",
  "name": "My Favorite Movie",
  "potentialAction": [
    {
      "@type": "WatchAction",
      "target": [
        {
          "@type":"EntryPoint",
          "urlTemplate":"http://www.example.com/my_favorite_movie/multipleViews",
          "actionPlatform": [
            "http://schema.org/IOSPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/AndroidTVPlatform",
            "http://schema.googleapis.com/GoogleVideoCast"
          ],
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentLanguage",
              "value": [
                "en"
              ]
            },
            {
              "@type": "PropertyValue",
              "name": "subtitleLanguage",
              "value": [
                "en",
                "es"
              ]
            },
            {
              "@type": "PropertyValue",
              "name": "videoFormat",
              "value": [
                "HD",
                "4K"
              ]
            },
            {
              "@type": "PropertyValue",
              "name": "cameraAngle",
              "value": [
                "Eye-Level",
                "High-Angle"
              ]
            }
          ]
        }
      ],
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "http://www.example.com/example_package"
        },
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2019-05-31T10:35:29Z",
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "CA"
          }
        ]
      }
    }
  ]
}

Thực thể có ở nhiều khu vực và ngôn ngữ

Lưu ý quan trọng: @language biểu thị ngôn ngữ dùng cho @value; không có nghĩa là nội dung có sẵn bằng ngôn ngữ đó hoặc ở khu vực đó. Ví dụ: pt-br trong @language không có nghĩa là nội dung có sẵn bằng tiếng Bồ Đào Nha ở Brazil; mã này xác định ngôn ngữ được sử dụng trong @value là tiếng Bồ Đào Nha Brazil. Sử dụng eligibleRegion để chỉ định vị trí cung cấp nội dung và sử dụng contentLanguage để chỉ định ngôn ngữ mà người dùng có thể sử dụng nội dung.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie",
  "url": "http://www.example.com/my_favorite_movie",
  "name": [
    {
      "@language": "en-us",
      "@value": "My Favorite Movie"
    },
    {
      "@language": "en-gb",
      "@value": "My Favourite Movie"
    },
    {
      "@language": "es-mx",
      "@value": "mi película favorita"
    },
  ],
  "description": [
    {
      "@language": "en-us",
      "@value": "Jenny meets Paul."
    },
    {
      "@language": "en-gb",
      "@value": "Jenny meets Paul."
    },
    {
      "@language": "es-mx",
      "@value": "Jenny conoce a paul."
    }
  ],
  "potentialAction": [
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/AndroidTVPlatform"
        ],
      }
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "http://www.example.com/example_package"
        },
        "availabilityStarts": "2018-07-21T10:35:29Z",
        "availabilityEnds": "2019-10-21T10:35:29Z",
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "GB"
          },
          {
            "@type": "Country",
            "name": "MX"
          }
        ]
      },
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentLanguage",
          "value": [
            "en",
            "es"
          ]
        },
      ]
    }
  ],
  // Other properties...
}

Cung cấp thông tin về đoạn giới thiệu thông qua thực thể Phim

Thận trọng: Bạn không thể gửi đoạn giới thiệu cho Google dưới dạng thực thể cấp cao nhất mà chỉ có thể thêm đoạn giới thiệu vào thực thể Phim dưới dạng thuộc tính.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie",
  "url": "http://www.example.com/my_favorite_movie",
  "name": "My Favorite Movie",
  "trailer":[
    {
      "@type":"VideoObject",
      "description":"In a world where dreamers continue to dream...",
      "inLanguage":"en-US",
      "url":"https://www.youtube.com/watch?v=contentIDhere"
    }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "requiresSubscription": {
         "@type": "MediaSubscription",
         "name": "Example Package",
         "commonTier": true,
         "@id": "http://www.example.com/example_package"
      },
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Mô tả gói thuê bao theo bậc cho danh mục của bạn

Phim

Một thực thể Phim có sẵn thông qua cả gói thuê bao "Gói Premium" và "Gói Basic". Mở rộng ví dụ này để thu thập các gói thuê bao bao gồm nhiều gói hoặc bậc hoặc có hỗ trợ gói bổ sung.

{
  "@context": [
    "http://schema.org",
    {
      "@language": "en"
    }
  ],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie",
  "url": "http://www.example.com/my_favorite_movie",
  "name": "My Favorite Movie",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": [
        {
          "@type": "MediaSubscription",
          "name": "Basic Package",
          "@id": "http://www.example.com/basic_package",
          "commonTier": true
        },
        {
          "@type": "MediaSubscription",
          "name": "Premium Package",
          "@id": "http://www.example.com/premium_package",
          "commonTier": false,
          "identifier": "example.com:premium_package"
        }
      ],
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "This is my favorite movie.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value": "tt0123456"
    }
  ]
}

TVSeries

Một thực thể TVSeries chỉ có trong "Gói Premium" của gói thuê bao.

{
  "@context": [
    "http://schema.org",
    {
      "@language": "en"
    }
  ],
  "@type": "TVSeries",
  "@id": "http://www.example.com/my_favorite_tv_show/",
  "url": "http://www.example.com/my_favorite_tv_show/",
  "name": "My Favorite TV Show",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2017-07-21T10:35:29Z",
      "availabilityEnds": "2018-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Premium Package",
        "@id": "http://www.example.com/premium_package",
        "identifier": "example.com:premium",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  }
  "description": "This is my favorite TV show.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    }
  ]
}

Cung cấp nhiều loại releasedEvents – PublicationEvent, FeaturedEvent và ExclusiveEvents

Biểu thị nội dung original but not exclusive

Nhà cung cấp nguồn cấp dữ liệu này sẽ giới thiệu một bộ phim trên toàn thế giới trong tháng 4 năm 2020. Ban đầu, bộ phim được phát hành tại Hoa Kỳ vào ngày 1 tháng 10 năm 2018.

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie",
  "url": "http://www.example.com/my_favorite_movie",
  "releasedEvent": [
    {
      "@type": "FeaturedEvent",
      "location": "EARTH",
      "startDate": "2020-04-01",
      "endDate":   "2020-04-30",
      "publishedBy": {
        "@type": "Organization",
        "@id": "https://www.abcmedia.com/",
        "sameAs": "https://en.wikipedia.org/wiki/ABCMedia",
        "name": "ABC Media"
      }
    },
    {
     "@type": "PublicationEvent",
     "location": {
       "@type": "Country",
       "name": "US"
     },
     "startDate": "2018-10-01T20:00",
     "publishedBy": {
       "@type": "Organization",
       "@id": "https://www.abcmedia.com/",
       "sameAs": "https://en.wikipedia.org/wiki/ABCMedia",
       "name": "ABC Media"
     }
   }
 ]
}

Biểu thị nội dung exclusive but not original

Nhà cung cấp cung cấp nguồn cấp dữ liệu có quyền độc quyền đối với một bộ phim trên toàn thế giới từ tháng 9 năm 2019 đến tháng 9 năm 2030.

{
"@context": [ "http://schema.org", { "@language": "en" } ],
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie",
"url": "http://www.example.com/my_favorite_movie",
"releasedEvent": [ {
  "@type": "ExclusiveEvent",
  "location": "EARTH",
  "startDate": "2019-09-01T00:00",
  "endDate": "2030-09-27T00:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.abcmedia.com/",
    "sameAs": "https://en.wikipedia.org/wiki/ABCMedia",
    "name": "ABC Media"
  }, {
  "@type": "PublicationEvent",
  "location": "EARTH",
  "startDate": "2018-10-01T20:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.abcmedia.com/",
    "sameAs": "https://en.wikipedia.org/wiki/ABCMedia",
    "name": "ABC Media"
   }
 }
 ]
}

Biểu thị nội dung exclusive and original

Nhà cung cấp cung cấp nguồn cấp dữ liệu này có quyền độc quyền đối với nội dung trên toàn thế giới từ tháng 9 năm 2019 đến tháng 9 năm 2030. Pháp nhân này xuất hiện ở Hoa Kỳ và Canada trong tháng 4 năm 2020.

Lưu ý: Việc đánh dấu một chương trình truyền hình là độc quyền hoặc nguyên bản có nghĩa là tất cả các tập của chương trình đều được đánh dấu như vậy.

{
"@context": [ "http://schema.org", { "@language": "en" } ],
"@type": "TVSeries",
"@id": "http://www.example.com/my_favorite_tvshow",
"url": "http://www.example.com/my_favorite_tvshow",
"releasedEvent": [ {
  "@type": "FeaturedEvent",
  "location": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
  ],
  "startDate": "2020-04-01",
  "endDate":   "2020-04-30",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.abcmedia.com/",
    "sameAs": "https://en.wikipedia.org/wiki/ABCMedia",
    "name": "ABC Media"
  }
 }, {
  "@type": "ExclusiveEvent",
  "location": "EARTH",
  "startDate": "2019-09-01T00:00",
  "endDate": "2030-09-27T00:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.abcmedia.com/",
    "sameAs": "https://en.wikipedia.org/wiki/ABCMedia",
    "name": "ABC Media"
  }, {
  "@type": "PublicationEvent",
  "location": "EARTH",
  "startDate": "2018-10-01T20:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.abcmedia.com/",
    "sameAs": "https://en.wikipedia.org/wiki/ABCMedia",
    "name": "ABC Media"
   }
 }
 ]
}

Ví dụ về mã nhận dạng/EIDR

Phim chính

Một bộ phim có biến thể bản cắt dài. Lưu ý rằng thực thể này có một titleEIDR ngoài giá trị nhận dạng IMDB_ID.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie",
  "url": "http://www.example.com/my_favorite_movie",
  "name": "My Favorite Movie",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
  "contentRating": "RATING NOT KNOWN",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 78,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite movie.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
  "titleEIDR" : "10.5240/7EC7-228A-510A-053E-CBB8-J",
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    }
  ],
  "workExample": {
      "@type": "Movie",
      "@id": "http://www.example.com/my_favorite_movie_extended_cut",
      "name": "My Favorite Movie Extended Cut"
      "category": "Extended Cut"
  }
}

Biến thể bản cắt dài

Phiên bản mở rộng của phim chính. Lưu ý rằng thực thể biến thể này có cả titleEIDR và editEIDR.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie_extended_cut",
  "url": "http://www.example.com/my_favorite_movie_extended_cut",
  "name": "My Favorite Movie Extended Cut",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie_extended_cut?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package",
        "identifier": "example.com:example_package"
       },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie_extended_cut",
  "contentRating": {
        "@type": "Rating",
        "author": "MPAA",
        "ratingValue": "R",
        "advisoryCode": "FV"
   },
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "This is the extended cut of my favorite movie.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
 "titleEIDR" : "10.5240/7EC7-228A-510A-053E-CBB8-J",
 "editEIDR" : "10.5240/1F2A-E1C5-680A-14C6-E76B-I",
 "exampleOfWork": {
  "@id": "http://www.example.com/my_favorite_movie",
 }
 "category": "Extended Cut"
}