Trang này được dịch bởi Cloud Translation API.

Tổng quan về cấu trúc nguồn cấp dữ liệu

Nguồn cấp dữ liệu Hành động đa phương tiện là một đối tượng JSON chứa một tập hợp các thực thể. Thực thể là một đối tượng schema.org đại diện cho một mục trong danh mục của bạn: một tập chương trình truyền hình, một chương trình truyền hình dài tập, một bộ phim, một bài hát, một đĩa nhạc, v.v.

Cấu trúc nguồn cấp dữ liệu

Hành động xem và Hành động nghe có cấu trúc nguồn cấp dữ liệu khác nhau.

Hành động trên đồng hồ có hệ phân cấp sau:

Đối tượng phong bì nguồn cấp dữ liệu

Đối tượng đánh dấu nội dung

Đối tượng đánh dấu hành động

Đối tượng mục tiêu
Đối tượng quy cách truy cập hành động

Đối tượng gói thuê bao nội dung đa phương tiện

Đối tượng ưu đãi

Hành động nghe có hệ phân cấp sau:

Đối tượng phong bì nguồn cấp dữ liệu

Đối tượng đánh dấu nội dung

Đối tượng đánh dấu hành động

Đối tượng mục tiêu
Đối tượng ưu đãi

Đối tượng đánh dấu nội dung (Hành động do thực thể tạo)

Phong bì nguồn cấp dữ liệu

Phong bì nguồn cấp dữ liệu 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. Đối tượng này chứa một mảng đối tượng đánh dấu nội dung (thực thể) đại diện cho tất cả nội dung trong danh mục của bạn.

Phong bì nguồn cấp dữ liệu hỗ trợ các thuộc tính sau:

Thuộc tính	Loại	Mô tả
`@context`	URL	Bắt buộc – Đặt thành `http://schema.org`
`@type`	Văn bản	Bắt buộc – Đặt thành `DataFeed`.
`dateModified`	DateTime	Bắt buộc – Ngày và giờ sửa đổi gần đây nhất của nguồn cấp dữ liệu, ở định dạng ISO 8601 (bao gồm cả múi giờ).
`dataFeedElement`	Thing	Bắt buộc – Thực thể của danh mục nội dung nghe nhìn.

Mẫu phong bì nguồn cấp dữ liệu

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    { <CONTENT MARKUP OBJECT 01> },
    { <CONTENT MARKUP OBJECT 02> },
    { <CONTENT MARKUP OBJECT 03> },
    ...
  ]
}

Mã đánh dấu nội dung

Đối tượng đánh dấu nội dung đại diện cho một thực thể trong danh mục của bạn: một bộ phim, một tập chương trình truyền hình, một chương trình truyền hình dài tập, một bài hát, một đĩa nhạc, một đài phát thanh, v.v. Đối tượng này chứa mã nhận dạng và URL chính tắc của nội dung, đồng thời giúp mô tả nội dung thông qua metadata.

Mẫu đánh dấu nội dung

Một đối tượng đánh dấu nội dung có thể có một mảng đối tượng đánh dấu Hành động, cho phép liên kết nội dung với nhiều đối tượng đánh dấu Hành động. Ví dụ: nội dung có thể có một đối tượng đánh dấu Hành động khác nhau cho mỗi khu vực.

{
   "@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": [
     { <ACTION MARKUP OBJECT 01> },
     { <ACTION MARKUP OBJECT 02> }
   ],
   ...
}

Mã đánh dấu hành động

Đối tượng đánh dấu Hành động mô tả đường liên kết sâu đưa người dùng đến nội dung và cấp truy cập cần thiết cho nội dung đó. Đối tượng này là một thuộc tính (potentialAction) của đối tượng đánh dấu nội dung.

Có hai cách để chỉ định các quy định hạn chế truy cập:

Đối với Hành động trên đồng hồ, hãy sử dụng đối tượng thông số kỹ thuật về quyền truy cập vào hành động.
Đối với Hành động nghe, hãy sử dụng đối tượng ưu đãi.

Mẫu đánh dấu hành động

Nếu nội dung có nhiều đường liên kết sâu, thì đối tượng đánh dấu Hành động sẽ bao gồm nhiều đối tượng mục tiêu. Ví dụ: đường liên kết sâu của nội dung dành cho iOS có thể khác với đường liên kết sâu của Android. Ngoài ra, nếu có nhiều quy định hạn chế quyền truy cập dựa trên khu vực và khoảng thời gian, thì một đối tượng đánh dấu Hành động có thể có nhiều đối tượng quy cách quyền truy cập Hành động hoặc đối tượng ưu đãi, như trong các mẫu bên dưới.

Mẫu đối tượng đánh dấu hành động cho Watch Action:

"potentialAction": {
  "@type": "WatchAction",
  "target": [
    { <TARGET OBJECT 01> },
    { <TARGET OBJECT 02> }
  ],
  "actionAccessibilityRequirement": [
    { <ACTION ACCESSIBILITY OBJECT 01> },
    { <ACTION ACCESSIBILITY OBJECT 02> }
  ]
}

Mẫu đối tượng đánh dấu hành động cho Hành động nghe:

"potentialAction": {
  "@type": "ListenAction",
  "target": [
    { <TARGET OBJECT 01> },
    { <TARGET OBJECT 02> }
  ],
  "expectsAcceptanceOf": [
    { <OFFER OBJECT 01> },
    { <OFFER OBJECT 02> }
  ]
}

Mục tiêu

Đối tượng mục tiêu cung cấp thông tin liên kết của đường liên kết sâu đến nhiều nền tảng của Google. Đối tượng này là một thuộc tính (target) của đối tượng đánh dấu Hành động.

Ví dụ về mục tiêu

Nếu nội dung có nhiều đường liên kết sâu dựa trên nền tảng, hãy tạo nhiều đối tượng mục tiêu để cung cấp các mối liên kết khác nhau. Ví dụ: đường liên kết sâu của nội dung cho Chromecast có thể khác với đường liên kết sâu của các nền tảng khác, như trong ví dụ dưới đây.

Ví dụ về đối tượng mục tiêu (cơ bản):

"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/AndroidPlatform",
    "http://schema.org/AndroidTVPlatform",
    "http://schema.org/IOSPlatform",
    "http://schema.googleapis.com/GoogleVideoCast"
  ]
}

Ví dụ về đối tượng mục tiêu có hai đường liên kết sâu:

"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/AndroidPlatform",
      "http://schema.org/AndroidTVPlatform",
      "http://schema.org/IOSPlatform"
    ]
  },
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/cast/my_favorite_movie?autoplay=true",
    "actionPlatform": [
      "http://schema.googleapis.com/GoogleVideoCast"
    ]
  }
]

Quy cách truy cập hành động

Đối tượng quy cách truy cập Hành động mô tả yêu cầu truy cập vào nội dung dựa trên khu vực và khoảng thời gian. Đối tượng này là một thuộc tính, actionAccessibilityRequirement, của một đối tượng đánh dấu Hành động.

category của đối tượng có thể là bất kỳ giá trị nào sau đây:

nologinrequired
free
subscription

Để mô tả thông tin chi tiết về gói thuê bao, hãy tạo một đối tượng gói thuê bao nội dung nghe nhìn. Nếu nội dung yêu cầu người đăng ký mua thêm, hãy sử dụng đối tượng ưu đãi để chỉ định giá.
externalsubscription

Để mô tả thông tin chi tiết về gói thuê bao, hãy tạo một đối tượng gói thuê bao nội dung nghe nhìn. Nếu nội dung yêu cầu người đăng ký mua thêm, hãy sử dụng đối tượng ưu đãi để chỉ định giá.
rental

Sử dụng đối tượng ưu đãi để chỉ định giá.
purchase

Sử dụng đối tượng ưu đãi để chỉ định giá.

Gói thuê bao nội dung nghe nhìn

Đối tượng gói thuê bao nội dung nghe nhìn mô tả thông tin chi tiết về gói thuê bao cần thiết cho nội dung. Đối tượng này là một thuộc tính, requiresSubscription, của một đối tượng quy cách truy cập Hành động. Bạn bắt buộc phải sử dụng thuộc tính này nếu actionAccessibilityRequirement.category là subscription hoặc externalSubscription và gói thuê bao của bạn bao gồm nhiều gói hoặc bậc hoặc có dịch vụ hỗ trợ bổ sung. Đừng thêm thông tin này nếu gói thuê bao của bạn chỉ có một cấp và cấp quyền truy cập vào tất cả nội dung trong danh mục.

Ví dụ về gói thuê bao nội dung nghe nhìn

Ví dụ về đối tượng thuê bao nội dung đa phương tiện:

"requiresSubscription": {
  "@type": "MediaSubscription",
  "@id": "http://www.example.com/premium_subscription",
  "name": "Example Premium",
  "sameAs": "http://www.example.com/premium_subscription"
}

Lời đề nghị

Đối tượng ưu đãi mô tả giá liên kết với nội dung. Đối tượng này là một thuộc tính (expectsAcceptanceOf) của các đối tượng sau:

Đối với Hành động trên đồng hồ, một đối tượng đặc tả quyền truy cập vào hành động.
Đối với Hành động nghe, một đối tượng đánh dấu Hành động.

Ví dụ về ưu đãi

Hành động trên đồng hồ chỉ định thuộc tính expectsAcceptanceOf trong đối tượng quy cách truy cập hành động:

"potentialAction":{
  "@type":"WatchAction",
  "target":{
    "@type":"EntryPoint",
    "urlTemplate":"http://www.example.com/my_favorite_movie?autoplay=true",
    "actionPlatform":[ "http://schema.org/DesktopWebPlatform" ]
  },
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "purchase",
    "availabilityStarts": "2019-01-01T00:00Z",
    "availabilityEnds": "2019-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    },
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "price": 7.99,
      "priceCurrency": "USD",
      "seller": {
        "@type": "Organization",
        "name": "My example seller"
      }
    }
  }
}

Hành động nghe chỉ định thuộc tính expectsAcceptanceOf ngay trong đối tượng đánh dấu Hành động:

"potentialAction":{
  "@type":"ListenAction",
  "target":{
    "@type":"EntryPoint",
    "urlTemplate":"http://www.example.com/playlist/top_pop_songs?autoplay=true",
    "actionPlatform":[ "http://schema.org/DesktopWebPlatform" ]
  },
  "expectsAcceptanceOf":{
    "@type": "Offer",
    "eligibleRegion": {
      "@type":"Country",
      "name":"US"
    },
    "category": "subscription",
    "name": "Example Music",
    "price": 9.99,
    "priceCurrency": "USD",
    "seller": {
      "@type": "Organization",
      "name": "My example seller",
      "sameAs": "http://www.example.com"
    }
  }
}

Hình ảnh

Đối tượng hình ảnh mô tả hình ảnh được liên kết với nội dung.

Sau đây là các yêu cầu đối với hình ảnh:

Đối với Hành động trên YouTube, hãy cung cấp hình ảnh có độ phân giải cao (tối thiểu 140x210 pixel) với tỷ lệ khung hình 2:3.
- Hình ảnh phải ở định dạng .jpg hoặc .png.
Đối với Hành động nghe, hãy cung cấp hình ảnh có độ phân giải cao (tối thiểu 300x300 pixel) với tỷ lệ khung hình 1x1.
- Bạn nên sử dụng hình ảnh có kích thước từ 600x600 pixel trở lên.
- Hình ảnh phải ở định dạng .jpg, .png hoặc .gif.
URL của hình ảnh phải cho phép Google thu thập dữ liệu và lập chỉ mục.
Bạn phải có quyền sử dụng hình ảnh và cho phép hình ảnh xuất hiện trên các thiết bị và tài sản của Google.
Hình ảnh không được chứa những nội dung sau:
- Hình ảnh bị mờ, bị vỡ ảnh, bị xoay hoặc có chất lượng kém.
- Ảnh chụp kho hình ảnh hoặc ảnh không có giấy phép.
- Ảnh khoả thân.
- Nội dung bất hợp pháp.
Khi bạn cập nhật MusicPlaylist, hãy cập nhật hình ảnh của lớp này để phản ánh nội dung mới.

Ví dụ về hình ảnh

"image": {
  "@type": "ImageObject",
  "contentUrl" : "http://www.example.com/artist/my_favorite_artist/1x1/photo1.jpg",
  "dateModified" : "2019-01-05T22:11:33+00:00",
  "regionsAllowed" : ["US","UK","MX"]
}

Ví dụ về nguồn cấp dữ liệu

Các ví dụ sau đây cho thấy sự khác biệt về cấu trúc nguồn cấp dữ liệu giữa Hành động xem và Hành động nghe.

Ví dụ về Hành động trên Watch

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {
      "@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",
           "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"
        }
      ]
    }
  ]
}

Ví dụ về Hành động nghe

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {
      "@context":"http://schema.googleapis.com/",
      "@type":"MusicGroup",
      "@id":"http://www.example.com/artist/my_favorite_artist/",
      "url":"http://www.example.com/artist/my_favorite_artist/",
      "name":"My Favorite Artist",
      "sameAs":"https://en.wikipedia.org/wiki/my_favorite_artist",
      "description":"This is my favorite pop music artist.",
      "potentialAction": {
        "@type":"ListenAction",
        "target": {
          "@type":"EntryPoint",
          "urlTemplate":"http://www.example.com/artist/my_favorite_artist?autoplay=true",
          "actionPlatform":[
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/AndroidTVPlatform",
            "http://schema.googleapis.com/GoogleAudioCast",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
        "expectsAcceptanceOf":{
          "@type":"Offer",
          "category":"subscription",
          "eligibleRegion": {
            "@type":"Country",
            "name":"US"
          },
          "price": 8.99,
          "priceCurrency": "USD"
        }
      },
      "subjectOf": {
        "@type":"MusicPlaylist",
        "@id":"http://www.example.com/artist_mix/my_favorite_artist/",
        "url":"http://www.example.com/artist_mix/my_favorite_artist/",
        "name":"My Favorite Artist Mix",
        "description":"A mix of music similar to My Favorite Artist",
        "potentialAction":{
          "@type":"ListenAction",
          "target": {
            "@type":"EntryPoint",
            "urlTemplate":"http://www.example.com/artist_mix/my_favorite_artist?autoplay=true",
            "actionPlatform":[
              "http://schema.org/DesktopWebPlatform",
              "http://schema.org/IOSPlatform",
              "http://schema.org/AndroidPlatform",
              "http://schema.org/AndroidTVPlatform",
              "http://schema.googleapis.com/GoogleAudioCast",
              "http://schema.googleapis.com/GoogleVideoCast"
            ]
          },
          "expectsAcceptanceOf":{
            "@type":"Offer",
            "category":"free",
            "eligibleRegion": {
              "@type":"Country",
              "name":"US"
            }
          }
        }
      }
    }
  ]
}