Feed 结构概览

媒体操作 Feed 是一个包含实体集合的 JSON 对象。实体是 schema.org 对象，代表目录中的项：电视剧集、电视连续剧、电影、歌曲、专辑等。

图 1. 观看操作和收听操作的 Feed 结构。

Feed 结构

观看操作和收听操作具有不同的 Feed 结构。

观看操作具有以下层次结构：
<ph type="x-smartling-placeholder"> 		监听操作具有以下层次结构：
<ph type="x-smartling-placeholder">

数据 Feed 信封

数据 Feed 信封是媒体操作 Feed 中的顶级对象。该对象包含一组内容标记对象（实体），代表目录中的所有内容。

数据 Feed 信封支持以下属性：

属性 类型 说明
@context 网址 必需 - 设置为 http://schema.org
@type 文本 必需 - 设置为 DataFeed。
dateModified DateTime 必需 - Feed 的上次修改日期和时间，采用 ISO 8601 格式（包括时区）。
dataFeedElement Thing 的子类型 必需 - 媒体目录的实体。

数据 Feed 信封模板

{
  "@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> },
    ...
  ]
}

内容标记

内容标记对象代表目录中的单个实体：电影、电视剧集、电视连续剧、歌曲、专辑、电台等。该对象包含内容的标识符和规范网址，有助于通过元数据描述内容。

内容标记模板

一个内容标记对象可以具有一系列 Action 标记对象，用于将内容与多个 Action 标记对象相关联。例如，内容可以针对每个区域具有不同的操作标记对象。

{
   "@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> }
   ],
   ...
}

操作标记

操作标记对象用于描述可将用户转到相应内容的深层链接以及相应内容所需的访问权限级别。该对象是内容标记对象的属性 (potentialAction)。

您可以通过以下两种方式指定访问限制：

操作标记模板

如果内容有多个深层链接，则一个 Action 标记对象会包含多个目标对象。例如，内容的 iOS 深层链接可能与 Android 深层链接不同。此外，如果具有基于区域和时间段的不同访问权限限制，一个 Action 标记对象可以有多个 Action 访问规范对象或优惠对象，如以下模板所示。

适用于观看操作的操作标记对象模板：

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

适用于监听操作的操作标记对象模板：

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

目标

目标对象可提供深层链接到各种 Google 平台的映射。该对象是操作标记对象的属性 (target)。

目标示例

如果内容有多个基于平台的深层链接，请创建多个目标对象以提供不同的映射。例如，内容针对 Chromecast 的深层链接可能不同于其他平台的深层链接深层链接，如以下示例所示。

目标对象示例（基本）：

"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"
  ]
}

包含两个深层链接的目标对象示例：

"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"
    ]
  }
]

操作访问规范

一个操作访问规范对象描述了 按区域和时间段展示内容。该对象是一个属性 第 actionAccessibilityRequirement 页，共 操作标记对象。

对象的 category 可以是以下任意一项：

  • nologinrequired
  • free

  • subscription

    要描述订阅的详细信息，请创建 媒体订阅对象。如果 内容需要额外为订阅者购买，请使用 优惠对象来指定价格。

  • externalsubscription

    要描述订阅的详细信息，请创建 媒体订阅对象。如果 内容需要额外为订阅者购买，请使用 优惠对象来指定价格。

  • rental

    使用 优惠对象来指定价格。

  • purchase

    使用 优惠对象来指定价格。

媒体订阅

媒体订阅对象用于描述所需订阅的详细信息 。该对象是一个属性 requiresSubscription，属于 操作访问规范对象。这是 如果 actionAccessibilityRequirement.category 为 subscription，则必须提供此值；或者 externalSubscription和您的订阅产品/服务 或具有附加支持。如果您的 订阅是层级的，可支持访问您目录中的所有内容。

媒体订阅示例

媒体订阅对象示例：

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

优惠

优惠对象用于描述与内容相关的价格。该对象是以下对象的属性 (expectsAcceptanceOf)：

优惠示例

观看操作会在expectsAcceptanceOf 操作访问规范对象：

"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"
      }
    }
  }
}

监听操作直接在操作标记对象中指定 expectsAcceptanceOf 属性：

"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"
    }
  }
}

映像

图片对象用于描述与内容相关联的图片。

映像的要求如下：

  • 对于观看操作，请提供一张宽高比为 2:3 的高分辨率图片（最小 140x210 像素）。
    • 图片必须为 .jpg 或 .png 格式。
  • 对于监听操作，请提供一张宽高比为 1x1 的高分辨率图片（最小 300x300 像素）。
    • 我们建议使用 600x600 像素或更高像素。
    • 图片必须为 .jpg、.png 或 .gif 格式。
  • 图片的网址必须可抓取且可编入索引。
  • 您必须拥有使用图片的权限，并允许图片显示在 Google 设备和产品和服务中。
  • 图片不得包含以下内容：
    • 模糊、像素化、旋转或画质不佳。
    • 未经许可或图库照片。
    • 裸露内容。
    • 非法内容。
  • 更新 MusicPlaylist 时，请更新其映像以反映新内容。

图片示例

"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"]
}

Feed 示例

以下示例展示了 观看 Action 和监听 Action。

观看操作示例

{
  "@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"
        }
      ]
    }
  ]
}

监听 Action 示例

{
  "@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"
            }
          }
        }
      }
    }
  ]
}