This section provides the details of the content markup properties for the
`Preview`, `Recap`, `Review`, `Highlight`, `Blooper`, `BehindTheScene`,
`DeletedScene`, and `Interview` clip types.

> [!IMPORTANT]
> **Important:** The specifications on this page are in early testing. If you have clips content and are interested in trying them out, reach out to [media-actions-support+watch@google.com]().

## Preview specification table

| Property | Expected Type | Description |
|---|---|---|
| `@context` | [Text](http://schema.org/Text) | **Required** - Always set to `["http://schema.org", {"@language": "xx"}]`. - `xx` represents the language of the strings in the feed. Each root entity context should have its `@language` set to the appropriate language code in [BCP 47 format](http://tools.ietf.org/html/bcp47). For example, if the language is set to Spanish, the values for `name` and `description` are assumed to be in Spanish even if the subtitle/dub language is in English. |
| `@type` | [Text](http://schema.org/Text) | **Required** - Always set to `Preview`. |
| `@id` | [URL](http://schema.org/URL) | **Required** - The preview's identifier in URI format; for example, *https://example.com/1234abc* . `@id` must meet the following requirements: - It's globally unique across your catalog. - It's static. The ID must be stable and not change over time. - It's in the form of a Unified Resource Identifier (URI). - The domain used for the `@id` value must be owned by your organization. |
| `name` | [Text](http://schema.org/Text) | **Required** - The name of the preview clip. |
| `description` | [Text](http://schema.org/Text) | **Required** - A description of the preview, limited to 300 characters. |
| `potentialAction` | [WatchAction](http://schema.org/WatchAction) | **Required** - An [Action markup object](https://developers.google.com/actions/media/reference#action_markup) that provides the [details](https://developers.google.com/actions/media/reference/data-specification/watch-actions-common-specification#action_markup_properties) of the action. |
| `mainEntity.@type` | [Text](http://schema.org/Text) | **Required** - Use the `mainEntity` property to represent the entity that this preview belongs to. This property can have the following values: - [`Movie`](https://developers.google.com/actions/media/reference/data-specification/movies-specification) - [`TVSeries`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvseries) - [`TVSeason`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvseason) - [`TVEpisode`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvepisode) - [`SportsEvent`](https://developers.google.com/actions/media/reference/data-specification/events-specification#sportsevent_specification_table) - [`Event`](https://developers.google.com/actions/media/reference/data-specification/events-specification#event_specification_table) The `mainEntity` property must also exist as a top-level entity in the feed. Add all of the necessary metadata for its respective types, as indicated by their specification tables throughout this documentation. It's optional for these `mainEntity` types to include [Deep links](https://developers.google.com/actions/media/collect-information/identify-the-deep-links), as conveyed through the `potentialAction` property. |
| `mainEntity.@id` | [URL](http://schema.org/URL) | **Required** - The `@id` of the corresponding entity. The entity must exist in the feed and have an `@id` that's different from the `Preview` `@id`. |

### Preview example

The following example shows the markup for a `Preview` clip on the left tab and
its linked `mainEntity` on the right tab. This example doesn't include a deep
link on the `mainEntity` type.

> [!NOTE]
> **Note:** For a list of available `mainEntity` types, see [`mainEntity@type`](https://developers.google.com/actions/media/reference/data-specification/clips#preview-mainentity-type).

### Preview

The following clip represents a preview of a sports event. The sports event
is specified by the `@type` and `@id` of the `mainEntity` property.

    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "Preview",
      "@id": "https://www.example.com/preview_clip/teama-teamb",
      "name": "A preview for Team A vs Team B",
      "description": "An analysis of two teams, Team A and Team B, before their game.",
      "potentialAction": {
        "@type": "WatchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "http://www.example.com/premium/teama_vs_teamb_pregame",
          "inLanguage": "en",
          "actionPlatform": [
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/MobileWebPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
        "actionAccessibilityRequirement": {
          "@type": "ActionAccessSpecification",
          "category": "subscription",
          "availabilityStarts": "2019-09-09T10:00:00Z",
          "availabilityEnds": "2019-09-30T10:00:00Z",
          "requiresSubscription": {
            "@type": "MediaSubscription",
            "@id": "http://www.example.com/premium_subscription",
            "name": "Example Premium",
            "sameAs": "http://www.example.com/premium_subscription",
            "commonTier": true
          },
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            },
            {
              "@type": "Country",
              "name": "CA"
            }
          ]
        }
      },
      "mainEntity": {
        "@type": "SportsEvent",
        "@id": "https://www.example.com/game/2019-09-12/teama-teamb"
      }
    }

### SportsEvent

The following is the `mainEntity` associated with the clip specified in the
`Preview` clip. This entity doesn't include a deep link. If you have deep
links, you can add them with the `potentialAction` property.

    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "SportsEvent",
      "@id": "https://www.example.com/game/2019-09-12/teama-teamb",
      "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."
        },
        {
          "@language": "es",
          "@value": "Finales de Baloncesto Profesional 2019, Juego 6: Equipo A contra Equipo B."
        }
      ],
      "startDate": "2019-09-12T18:00-08:00",
      "endDate": "2019-09-12T21:00-08:00",
      "homeTeam": {
        "@type": "SportsTeam",
        "name": "Team B",
        "sport": "https://en.wikipedia.org/wiki/Basketball",
        "parentOrganization": {
          "@type": "SportsOrganization",
          "name": "Professional Basketball League",
          "sameAs": "https://en.wikipedia.org/wiki/National_Basketball_Association"
        },
        "athlete": [
          {
            "@type": "Person",
            "name": "John Doe"
          }
        ]
      },
      "awayTeam": {
        "@type": "SportsTeam",
        "name": "Team A",
        "sport": "https://en.wikipedia.org/wiki/Basketball",
        "parentOrganization": {
          "@type": "SportsOrganization",
          "name": "Professional Basketball League",
          "sameAs": "https://en.wikipedia.org/wiki/National_Basketball_Association"
        },
        "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": "TMS ID of this game"
        }
      ]
    }

## Recap specification table

| Property | Expected Type | Description |
|---|---|---|
| `@context` | [Text](http://schema.org/Text) | **Required** - Always set to `["http://schema.org", {"@language": "xx"}]`. - `xx` represents the language of the strings in the feed. Each root entity context should have its `@language` set to the appropriate language code in [BCP 47 format](http://tools.ietf.org/html/bcp47). For example, if the language is set to Spanish, the values for `name` and `description` are assumed to be in Spanish even if the subtitle/dub language is in English. |
| `@type` | [Text](http://schema.org/Text) | **Required** - Always set to `Recap`. |
| `@id` | [URL](http://schema.org/URL) | **Required** - The recap's identifier in URI format; for example, *https://example.com/1234abc* . `@id` must meet the following requirements: - It's globally unique across your catalog. - It's static. The ID must be stable and not change over time. - It's in the form of a Unified Resource Identifier (URI). - The domain used for the `@id` value must be owned by your organization. |
| `name` | [Text](http://schema.org/Text) | **Required** - The name of the recap clip. |
| `description` | [Text](http://schema.org/Text) | **Required** - A description of the recap, limited to 300 characters. |
| `potentialAction` | [WatchAction](http://schema.org/WatchAction) | **Required** - An [Action markup object](https://developers.google.com/actions/media/reference#action_markup) that provides the [details](https://developers.google.com/actions/media/reference/data-specification/watch-actions-common-specification#action_markup_properties) of the action. |
| `mainEntity.@type` | [Text](http://schema.org/Text) | **Required** - Use the `mainEntity` property to represent the entity that this recap belongs to. This property can have the following values: - [`Movie`](https://developers.google.com/actions/media/reference/data-specification/movies-specification) - [`TVSeries`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvseries) - [`TVSeason`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvseason) - [`TVEpisode`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvepisode) - [`SportsEvent`](https://developers.google.com/actions/media/reference/data-specification/events-specification#sportsevent_specification_table) - [`Event`](https://developers.google.com/actions/media/reference/data-specification/events-specification#event_specification_table) The `mainEntity` property must also exist as a top-level entity in the feed. Add all of the necessary metadata for its respective types, as indicated by their specification tables throughout this documentation. It's optional for these `mainEntity` types to include [Deep links](https://developers.google.com/actions/media/collect-information/identify-the-deep-links), as conveyed through the `potentialAction` property. |
| `mainEntity.@id` | [URL](http://schema.org/URL) | **Required** - The `@id` of the corresponding entity. The entity must exist in the feed and have an `@id` that's different from the `Recap` `@id`. |

### Recap example

The following example shows the markup for a `Recap` clip on the left tab and
its linked `mainEntity` on the right tab. This example doesn't include a deep
link on the `mainEntity` type.

> [!NOTE]
> **Note:** For a list of available `mainEntity` types, see [`mainEntity@type`](https://developers.google.com/actions/media/reference/data-specification/clips#recap-mainentity-type).

### Recap

The following clip represents a recap of a sports event. The sports event is
specified by the `@type` and `@id` of the `mainEntity` property.

    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "Recap",
      "@id": "https://www.example.com/recap_clip/teama-teamb",
      "name": "A recap for Team A vs Team B",
      "description": "An analysis of two teams, Team A and Team B, after their game.",
      "potentialAction": {
        "@type": "WatchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "http://www.example.com/premium/teama_vs_teamb_recap",
          "inLanguage": "en",
          "actionPlatform": [
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/MobileWebPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
        "actionAccessibilityRequirement": {
          "@type": "ActionAccessSpecification",
          "category": "subscription",
          "availabilityStarts": "2019-09-09T10:00:00Z",
          "availabilityEnds": "2019-09-30T10:00:00Z",
          "requiresSubscription": {
            "@type": "MediaSubscription",
            "@id": "http://www.example.com/premium_subscription",
            "name": "Example Premium",
            "sameAs": "http://www.example.com/premium_subscription",
            "commonTier": true
          },
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            },
            {
              "@type": "Country",
              "name": "CA"
            }
          ]
        }
      },
      "mainEntity": {
        "@type": "SportsEvent",
        "@id": "https://www.example.com/game/2019-09-12/teama-teamb"
      }
    }

### SportsEvent

The following is the `mainEntity` associated with the clip specified in the
`Recap` clip. This entity doesn't include a deep link. If you have deep
links, you can add them with the `potentialAction` property.

    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "SportsEvent",
      "@id": "https://www.example.com/game/2019-09-12/teama-teamb",
      "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."
        },
        {
          "@language": "es",
          "@value": "Finales de Baloncesto Profesional 2019, Juego 6: Equipo A contra Equipo B."
        }
      ],
      "startDate": "2019-09-12T18:00-08:00",
      "endDate": "2019-09-12T21:00-08:00",
      "homeTeam": {
        "@type": "SportsTeam",
        "name": "Team B",
        "sport": "https://en.wikipedia.org/wiki/Basketball",
        "parentOrganization": {
          "@type": "SportsOrganization",
          "name": "Professional Basketball League",
          "sameAs": "https://en.wikipedia.org/wiki/National_Basketball_Association"
        },
        "athlete": [
          {
            "@type": "Person",
            "name": "John Doe"
          }
        ]
      },
      "awayTeam": {
        "@type": "SportsTeam",
        "name": "Team A",
        "sport": "https://en.wikipedia.org/wiki/Basketball",
        "parentOrganization": {
          "@type": "SportsOrganization",
          "name": "Professional Basketball League",
          "sameAs": "https://en.wikipedia.org/wiki/National_Basketball_Association"
        },
        "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": "TMS ID of this game"
        }
      ]
    }

## Review specification table

| Property | Expected Type | Description |
|---|---|---|
| `@context` | [Text](http://schema.org/Text) | **Required** - Always set to `["http://schema.org", {"@language": "xx"}]`. - `xx` represents the language of the strings in the feed. Each root entity context should have its `@language` set to the appropriate language code in [BCP 47 format](http://tools.ietf.org/html/bcp47). For example, if the language is set to Spanish, the values for `name` and `description` are assumed to be in Spanish even if the subtitle/dub language is in English. |
| `@type` | [Text](http://schema.org/Text) | **Required** - Always set to `Review`. |
| `@id` | [URL](http://schema.org/URL) | **Required** - The review's identifier in URI format; for example, *https://example.com/1234abc* . `@id` must meet the following requirements: - It's globally unique across your catalog. - It's static. The ID must be stable and not change over time. - It's in the form of a Unified Resource Identifier (URI). - The domain used for the `@id` value must be owned by your organization. |
| `name` | [Text](http://schema.org/Text) | **Required** - The name of the review clip. |
| `description` | [Text](http://schema.org/Text) | **Required** - A description of the review, limited to 300 characters. |
| `potentialAction` | [WatchAction](http://schema.org/WatchAction) | **Required** - An [Action markup object](https://developers.google.com/actions/media/reference#action_markup) that provides the [details](https://developers.google.com/actions/media/reference/data-specification/watch-actions-common-specification#action_markup_properties) of the action. |
| `mainEntity.@type` | [Text](http://schema.org/Text) | **Required** - Use the `mainEntity` property to represent the entity that this review belongs to. This property can have the following values: - [`Movie`](https://developers.google.com/actions/media/reference/data-specification/movies-specification) - [`TVSeries`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvseries) - [`TVSeason`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvseason) - [`TVEpisode`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvepisode) - [`SportsEvent`](https://developers.google.com/actions/media/reference/data-specification/events-specification#sportsevent_specification_table) - [`Event`](https://developers.google.com/actions/media/reference/data-specification/events-specification#event_specification_table) The `mainEntity` property must also exist as a top-level entity in the feed. Add all of the necessary metadata for its respective types, as indicated by their specification tables throughout this documentation. It's optional for these `mainEntity` types to include [Deep links](https://developers.google.com/actions/media/collect-information/identify-the-deep-links), as conveyed through the `potentialAction` property. |
| `mainEntity.@id` | [URL](http://schema.org/URL) | **Required** - The `@id` of the corresponding entity. The entity must exist in the feed and have an `@id` that's different from the `Review` `@id`. |

### Review example

The following example shows the markup for a `Review` clip on the left tab and
its linked `mainEntity` on the right tab. This example includes a deep link.

> [!NOTE]
> **Note:** For a list of available `mainEntity` types, see [`mainEntity@type`](https://developers.google.com/actions/media/reference/data-specification/clips#review-mainentity-type).

### Review

The following clip represents a review of a movie. The movie is specified by
the `@type` and `@id` of the `mainEntity` property.

    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "Review",
      "@id": "https://www.example.com/review_clip/abc",
      "name": "A review of ABC",
      "description": "A no-spoiler review of the Sci-Fi Movie, ABC.",
      "potentialAction": {
        "@type": "WatchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "https://www.example.com/review_clip/abc",
          "inLanguage": "en",
          "actionPlatform": [
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/MobileWebPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
        "actionAccessibilityRequirement": {
          "@type": "ActionAccessSpecification",
          "category": "subscription",
          "availabilityStarts": "2019-09-09T10:00:00Z",
          "availabilityEnds": "2019-09-30T10:00:00Z",
          "requiresSubscription": {
            "@type": "MediaSubscription",
            "@id": "http://www.example.com/premium_subscription",
            "name": "Example Premium",
            "sameAs": "http://www.example.com/premium_subscription",
            "commonTier": true
          },
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            },
            {
              "@type": "Country",
              "name": "CA"
            }
          ]
        }
      },
      "mainEntity": {
        "@type": "Movie",
        "@id": "https://www.example.com/movie/abc"
      }
    }

### Movie

The following is the `mainEntity` associated with the clip specified in the
`Review` clip. This entity includes deep links in its `potentialAction`
property.

    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "Movie",
      "@id": "https://www.example.com/movie/abc",
      "url": "https://www.example.com/movie/abc",
      "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",
      "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"
        }
      ],
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "IMDB_ID",
          "value":  "tt0123456"
        }
      ]
    }

## Highlight specification table

| Property | Expected Type | Description |
|---|---|---|
| `@context` | [Text](http://schema.org/Text) | **Required** - Always set to `["http://schema.org", {"@language": "xx"}]`. - `xx` represents the language of the strings in the feed. Each root entity context should have its `@language` set to the appropriate language code in [BCP 47 format](http://tools.ietf.org/html/bcp47). For example, if the language is set to Spanish, the values for `name` and `description` are assumed to be in Spanish even if the subtitle/dub language is in English. |
| `@type` | [Text](http://schema.org/Text) | **Required** - Always set to `Highlight`. |
| `@id` | [URL](http://schema.org/URL) | **Required** - The highlight's identifier in URI format; for example, *https://example.com/1234abc* . `@id` must meet the following requirements: - It's globally unique across your catalog. - It's static. The ID must be stable and not change over time. - It's in the form of a Unified Resource Identifier (URI). - The domain used for the `@id` value must be owned by your organization. |
| `name` | [Text](http://schema.org/Text) | **Required** - The name of the highlight clip. |
| `description` | [Text](http://schema.org/Text) | **Required** - A description of the highlight, limited to 300 characters. |
| `potentialAction` | [WatchAction](http://schema.org/WatchAction) | **Required** - An [Action markup object](https://developers.google.com/actions/media/reference#action_markup) that provides the [details](https://developers.google.com/actions/media/reference/data-specification/watch-actions-common-specification#action_markup_properties) of the action. |
| `mainEntity.@type` | [Text](http://schema.org/Text) | **Required** - Use the `mainEntity` property to represent the entity that this highlight belongs to. This property can have the following values: - [`Movie`](https://developers.google.com/actions/media/reference/data-specification/movies-specification) - [`TVSeries`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvseries) - [`TVSeason`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvseason) - [`TVEpisode`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvepisode) - [`SportsEvent`](https://developers.google.com/actions/media/reference/data-specification/events-specification#sportsevent_specification_table) - [`Event`](https://developers.google.com/actions/media/reference/data-specification/events-specification#event_specification_table) The `mainEntity` property must also exist as a top-level entity in the feed. Add all of the necessary metadata for its respective types, as indicated by their specification tables throughout this documentation. It's optional for these `mainEntity` types to include [Deep links](https://developers.google.com/actions/media/collect-information/identify-the-deep-links), as conveyed through the `potentialAction` property. |
| `mainEntity.@id` | [URL](http://schema.org/URL) | **Required** - The `@id` of the corresponding entity. The entity must exist in the feed and have an `@id` that's different from the `Highlight` `@id`. |

### Highlight example

The following example shows the markup for a `Highlight` clip on the left tab
and its linked `mainEntity` on the right tab. This example doesn't include a
deep link on the `mainEntity` type.

> [!NOTE]
> **Note:** For a list of available `mainEntity` types, see [`mainEntity@type`](https://developers.google.com/actions/media/reference/data-specification/clips#highlight-mainentity-type).

### Highlight

The following clip represents a highlight from a sports event. The sports
event is specified by the `@type` and `@id` of the `mainEntity` property.

    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "Highlight",
      "@id": "https://www.example.com/highlight_clip/teama-teamb",
      "name": "Highlight for the Team A vs Team B game",
      "description": "Highlight for the Team A vs Team B game.",
      "potentialAction": {
        "@type": "WatchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "http://www.example.com/premium/teama_vs_teamb_highlight",
          "inLanguage": "en",
          "actionPlatform": [
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/MobileWebPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
        "actionAccessibilityRequirement": {
          "@type": "ActionAccessSpecification",
          "category": "subscription",
          "availabilityStarts": "2019-09-09T10:00:00Z",
          "availabilityEnds": "2019-09-30T10:00:00Z",
          "requiresSubscription": {
            "@type": "MediaSubscription",
            "@id": "http://www.example.com/premium_subscription",
            "name": "Example Premium",
            "sameAs": "http://www.example.com/premium_subscription",
            "commonTier": true
          },
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            },
            {
              "@type": "Country",
              "name": "CA"
            }
          ]
        }
      },
      "mainEntity": {
        "@type": "SportsEvent",
        "@id": "https://www.example.com/game/2019-09-12/teama-teamb"
      }
    }

### SportsEvent

The following is the `mainEntity` associated with the clip specified in the
`Highlight` clip. This entity doesn't include a deep link. If you have deep
links, you can add them with the `potentialAction` property.

    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "SportsEvent",
      "@id": "https://www.example.com/game/2019-09-12/teama-teamb",
      "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."
        },
        {
          "@language": "es",
          "@value": "Finales de Baloncesto Profesional 2019, Juego 6: Equipo A contra Equipo B."
        }
      ],
      "startDate": "2019-09-12T18:00-08:00",
      "endDate": "2019-09-12T21:00-08:00",
      "homeTeam": {
        "@type": "SportsTeam",
        "name": "Team B",
        "sport": "https://en.wikipedia.org/wiki/Basketball",
        "parentOrganization": {
          "@type": "SportsOrganization",
          "name": "Professional Basketball League",
          "sameAs": "https://en.wikipedia.org/wiki/National_Basketball_Association"
        },
        "athlete": [
          {
            "@type": "Person",
            "name": "John Doe"
          }
        ]
      },
      "awayTeam": {
        "@type": "SportsTeam",
        "name": "Team A",
        "sport": "https://en.wikipedia.org/wiki/Basketball",
        "parentOrganization": {
          "@type": "SportsOrganization",
          "name": "Professional Basketball League",
          "sameAs": "https://en.wikipedia.org/wiki/National_Basketball_Association"
        },
        "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": "TMS ID of this game"
        }
      ]
    }

## Blooper specification table

| Property | Expected Type | Description |
|---|---|---|
| `@context` | [Text](http://schema.org/Text) | **Required** - Always set to `["http://schema.org", {"@language": "xx"}]`. - `xx` represents the language of the strings in the feed. Each root entity context should have its `@language` set to the appropriate language code in [BCP 47 format](http://tools.ietf.org/html/bcp47). For example, if the language is set to Spanish, the values for `name` and `description` are assumed to be in Spanish even if the subtitle/dub language is in English. |
| `@type` | [Text](http://schema.org/Text) | **Required** - Always set to `Blooper`. |
| `@id` | [URL](http://schema.org/URL) | **Required** - The blooper's identifier in URI format; for example, *https://example.com/1234abc* . `@id` must meet the following requirements: - It's globally unique across your catalog. - It's static. The ID must be stable and not change over time. - It's in the form of a Unified Resource Identifier (URI). - The domain used for the `@id` value must be owned by your organization. |
| `name` | [Text](http://schema.org/Text) | **Required** - The name of the blooper clip. |
| `description` | [Text](http://schema.org/Text) | **Required** - A description of the blooper, limited to 300 characters. |
| `potentialAction` | [WatchAction](http://schema.org/WatchAction) | **Required** - An [Action markup object](https://developers.google.com/actions/media/reference#action_markup) that provides the [details](https://developers.google.com/actions/media/reference/data-specification/watch-actions-common-specification#action_markup_properties) of the action. |
| `mainEntity.@type` | [Text](http://schema.org/Text) | **Required** - Use the `mainEntity` property to represent the entity that this blooper clip belongs to. This property can have the following values: - [`Movie`](https://developers.google.com/actions/media/reference/data-specification/movies-specification) - [`TVSeries`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvseries) - [`TVSeason`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvseason) - [`TVEpisode`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvepisode) The `mainEntity` property must also exist as a top-level entity in the feed. Add all of the necessary metadata for its respective types, as indicated by their specification tables throughout this documentation. It's optional for these `mainEntity` types to include [Deep links](https://developers.google.com/actions/media/collect-information/identify-the-deep-links), as conveyed through the `potentialAction` property. |
| `mainEntity.@id` | [URL](http://schema.org/URL) | **Required** - The `@id` of the corresponding entity. The entity must exist in the feed and have an `@id` that's different from the `Blooper` `@id`. |

### Blooper example

The following example shows the markup for a `Blooper` clip on the left tab and
its linked `mainEntity` on the right tab. This example includes a deep link.

> [!NOTE]
> **Note:** For a list of available `mainEntity` types, see [`mainEntity@type`](https://developers.google.com/actions/media/reference/data-specification/clips#blooper-mainentity-type).

### Blooper

The following clip represents a blooper from a movie. The movie is
specified by the `@type` and `@id` of the `mainEntity` property.

    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "Blooper",
      "@id": "https://www.example.com/blooper_abc",
      "name": "ABC Bloopers",
      "description": "Bloopers during the filming of ABC",
      "potentialAction": {
        "@type": "WatchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "https://www.example.com/blooper_abc",
          "inLanguage": "en",
          "actionPlatform": [
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/MobileWebPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
        "actionAccessibilityRequirement": {
          "@type": "ActionAccessSpecification",
          "category": "subscription",
          "availabilityStarts": "2019-09-09T10:00:00Z",
          "availabilityEnds": "2019-09-30T10:00:00Z",
          "requiresSubscription": {
            "@type": "MediaSubscription",
            "@id": "http://www.example.com/premium_subscription",
            "name": "Example Premium",
            "sameAs": "http://www.example.com/premium_subscription",
            "commonTier": true
          },
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            },
            {
              "@type": "Country",
              "name": "CA"
            }
          ]
        }
      },
      "mainEntity": {
        "@type": "Movie",
        "@id": "https://www.example.com/movie/abc"
      }
    }

### Movie

The following is the `mainEntity` associated with the clip specified in the
`Blooper` clip. This entity includes deep links in its `potentialAction`
property.

    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "Movie",
      "@id": "https://www.example.com/movie/abc",
      "url": "https://www.example.com/movie/abc",
      "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",
      "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"
        }
      ],
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "IMDB_ID",
          "value":  "tt0123456"
        }
      ]
    }

## BehindTheScene specification table

| Property | Expected Type | Description |
|---|---|---|
| `@context` | [Text](http://schema.org/Text) | **Required** - Always set to `["http://schema.org", {"@language": "xx"}]`. - `xx` represents the language of the strings in the feed. Each root entity context should have its `@language` set to the appropriate language code in [BCP 47 format](http://tools.ietf.org/html/bcp47). For example, if the language is set to Spanish, the values for `name` and `description` are assumed to be in Spanish even if the subtitle/dub language is in English. |
| `@type` | [Text](http://schema.org/Text) | **Required** - Always set to `BehindTheScene`. |
| `@id` | [URL](http://schema.org/URL) | **Required** - The clip's identifier in URI format; for example, *https://example.com/1234abc* . `@id` must meet the following requirements: - It's globally unique across your catalog. - It's static. The ID must be stable and not change over time. - It's in the form of a Unified Resource Identifier (URI). - The domain used for the `@id` value must be owned by your organization. |
| `name` | [Text](http://schema.org/Text) | **Required** - The name of the behind-the-scene clip. |
| `description` | [Text](http://schema.org/Text) | **Required** - A description of the behind-the-scene clip, limited to 300 characters. |
| `potentialAction` | [WatchAction](http://schema.org/WatchAction) | **Required** - An [Action markup object](https://developers.google.com/actions/media/reference#action_markup) that provides the [details](https://developers.google.com/actions/media/reference/data-specification/watch-actions-common-specification#action_markup_properties) of the action. |
| `mainEntity.@type` | [Text](http://schema.org/Text) | **Required** - Use the `mainEntity` property to represent the entity that this behind-the-scene clip belongs to. This property can have the following values: - [`Movie`](https://developers.google.com/actions/media/reference/data-specification/movies-specification) - [`TVSeries`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvseries) - [`TVSeason`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvseason) - [`TVEpisode`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvepisode) The `mainEntity` property must also exist as a top-level entity in the feed. Add all of the necessary metadata for its respective types, as indicated by their specification tables throughout this documentation. It's optional for these `mainEntity` types to include [Deep links](https://developers.google.com/actions/media/collect-information/identify-the-deep-links), as conveyed through the `potentialAction` property. |
| `mainEntity.@id` | [URL](http://schema.org/URL) | **Required** - The `@id` of the corresponding entity. The entity must exist in the feed and have an `@id` that's different from the `BehindTheScene` `@id`. |

### BehindTheScene example

The following example shows the markup for a `BehindTheScene` clip on the left
tab and its linked `mainEntity` on the right tab. This example includes a deep
link.

> [!NOTE]
> **Note:** For a list of available `mainEntity` types, see [`mainEntity@type`](https://developers.google.com/actions/media/reference/data-specification/clips#behind-the-scene-mainentity-type).

### BehindTheScene

The following represents a behind-the-scene clip from a movie. The movie is
specified by the `@type` and `@id` of the `mainEntity` property.

    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "BehindTheScene",
      "@id": "https://www.example.com/behind_the_scene_abc",
      "name": "ABC Behind the scene",
      "description": "Behind the scene of ABC.",
      "potentialAction": {
        "@type": "WatchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "https://www.example.com/behind_the_scene_abc",
          "inLanguage": "en",
          "actionPlatform": [
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/MobileWebPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
        "actionAccessibilityRequirement": {
          "@type": "ActionAccessSpecification",
          "category": "subscription",
          "availabilityStarts": "2019-09-09T10:00:00Z",
          "availabilityEnds": "2019-09-30T10:00:00Z",
          "requiresSubscription": {
            "@type": "MediaSubscription",
            "@id": "http://www.example.com/premium_subscription",
            "name": "Example Premium",
            "sameAs": "http://www.example.com/premium_subscription",
            "commonTier": true
          },
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            },
            {
              "@type": "Country",
              "name": "CA"
            }
          ]
        }
      },
      "mainEntity": {
        "@type": "Movie",
        "@id": "https://www.example.com/movie/abc"
      }
    }

### Movie

The following is the `mainEntity` associated with the clip specified in the
`BehindTheScene` clip. This entity includes deep links in its
`potentialAction` property.

    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "Movie",
      "@id": "https://www.example.com/movie/abc",
      "url": "https://www.example.com/movie/abc",
      "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",
      "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"
        }
      ],
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "IMDB_ID",
          "value":  "tt0123456"
        }
      ]
    }

## DeletedScene specification table

| Property | Expected Type | Description |
|---|---|---|
| `@context` | [Text](http://schema.org/Text) | **Required** - Always set to `["http://schema.org", {"@language": "xx"}]`. - `xx` represents the language of the strings in the feed. Each root entity context should have its `@language` set to the appropriate language code in [BCP 47 format](http://tools.ietf.org/html/bcp47). For example, if the language is set to Spanish, the values for `name` and `description` are assumed to be in Spanish even if the subtitle/dub language is in English. |
| `@type` | [Text](http://schema.org/Text) | **Required** - Always set to `DeletedScene`. |
| `@id` | [URL](http://schema.org/URL) | **Required** - The clip's identifier in URI format; for example, *https://example.com/1234abc* . `@id` must meet the following requirements: - It's globally unique across your catalog. - It's static. The ID must be stable and not change over time. - It's in the form of a Unified Resource Identifier (URI). - The domain used for the `@id` value must be owned by your organization. |
| `name` | [Text](http://schema.org/Text) | **Required** - The name of the deleted scene. |
| `description` | [Text](http://schema.org/Text) | **Required** - A description of the deleted scene, limited to 300 characters. |
| `potentialAction` | [WatchAction](http://schema.org/WatchAction) | **Required** - An [Action markup object](https://developers.google.com/actions/media/reference#action_markup) that provides the [details](https://developers.google.com/actions/media/reference/data-specification/watch-actions-common-specification#action_markup_properties) of the action. |
| `mainEntity.@type` | [Text](http://schema.org/Text) | **Required** - Use the `mainEntity` property to represent the entity that this deleted scene belongs to. This property can have the following values: - [`Movie`](https://developers.google.com/actions/media/reference/data-specification/movies-specification) - [`TVSeries`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvseries) - [`TVSeason`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvseason) - [`TVEpisode`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvepisode) The `mainEntity` property must also exist as a top-level entity in the feed. Add all of the necessary metadata for its respective types, as indicated by their specification tables throughout this documentation. It's optional for these `mainEntity` types to include [Deep links](https://developers.google.com/actions/media/collect-information/identify-the-deep-links), as conveyed through the `potentialAction` property. |
| `mainEntity.@id` | [URL](http://schema.org/URL) | **Required** - The `@id` of the corresponding entity. The entity must exist in the feed and have an `@id` that's different from the `DeletedScene` `@id`. |

### DeletedScene example

The following example shows the markup for a `DeletedScene` clip on the left tab
and its linked `mainEntity` on the right tab. This example includes a deep link.

> [!NOTE]
> **Note:** For a list of available `mainEntity` types, see [`mainEntity@type`](https://developers.google.com/actions/media/reference/data-specification/clips#deleted-scene-mainentity-type).

### DeletedScene

The following clip represents a deleted scene from a movie. The movie is
specified by the `@type` and `@id` of the `mainEntity` property.

    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "DeletedScene",
      "@id": "https://www.example.com/deleted_scene_abc",
      "name": "Deleted Scenes in ABC",
      "description": "Deleted Scenes in ABC.",
      "potentialAction": {
        "@type": "WatchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "https://www.example.com/deleted_scene_abc",
          "inLanguage": "en",
          "actionPlatform": [
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/MobileWebPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
        "actionAccessibilityRequirement": {
          "@type": "ActionAccessSpecification",
          "category": "subscription",
          "availabilityStarts": "2019-09-09T10:00:00Z",
          "availabilityEnds": "2019-09-30T10:00:00Z",
          "requiresSubscription": {
            "@type": "MediaSubscription",
            "@id": "http://www.example.com/premium_subscription",
            "name": "Example Premium",
            "sameAs": "http://www.example.com/premium_subscription",
            "commonTier": true
          },
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            },
            {
              "@type": "Country",
              "name": "CA"
            }
          ]
        }
      },
      "mainEntity": {
        "@type": "Movie",
        "@id": "https://www.example.com/movie/abc"
      }
    }

### Movie

The following is the `mainEntity` associated with the clip specified in the
`DeletedScene` clip. This entity includes deep links in its
`potentialAction` property.

    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "Movie",
      "@id": "https://www.example.com/movie/abc",
      "url": "https://www.example.com/movie/abc",
      "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",
      "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"
        }
      ],
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "IMDB_ID",
          "value":  "tt0123456"
        }
      ]
    }

## Interview specification table

| Property | Expected Type | Description |
|---|---|---|
| `@context` | [Text](http://schema.org/Text) | **Required** - Always set to `["http://schema.org", {"@language": "xx"}]`. - `xx` represents the language of the strings in the feed. Each root entity context should have its `@language` set to the appropriate language code in [BCP 47 format](http://tools.ietf.org/html/bcp47). For example, if the language is set to Spanish, the values for `name` and `description` are assumed to be in Spanish even if the subtitle/dub language is in English. |
| `@type` | [Text](http://schema.org/Text) | **Required** - Always set to `Interview`. |
| `@id` | [URL](http://schema.org/URL) | **Required** - The interview's identifier in URI format; for example, *https://example.com/1234abc* . `@id` must meet the following requirements: - It's globally unique across your catalog. - It's static. The ID must be stable and not change over time. - It's in the form of a Unified Resource Identifier (URI). - The domain used for the `@id` value must be owned by your organization. |
| `name` | [Text](http://schema.org/Text) | **Required** - The name of the interview clip. |
| `description` | [Text](http://schema.org/Text) | **Required** - A description of the interview, limited to 300 characters. |
| `potentialAction` | [WatchAction](http://schema.org/WatchAction) | **Required** - An [Action markup object](https://developers.google.com/actions/media/reference#action_markup) that provides the [details](https://developers.google.com/actions/media/reference/data-specification/watch-actions-common-specification#action_markup_properties) of the action. |
| `mainEntity.@type` | [Text](http://schema.org/Text) | **Required** - Use the `mainEntity` property to represent the entity that this interview belongs to. This property can have the following values: - [`Movie`](https://developers.google.com/actions/media/reference/data-specification/movies-specification) - [`TVSeries`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvseries) - [`TVSeason`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvseason) - [`TVEpisode`](https://developers.google.com/actions/media/reference/data-specification/tv-shows-specification#tvepisode) - [`SportsEvent`](https://developers.google.com/actions/media/reference/data-specification/events-specification#sportsevent_specification_table) The `mainEntity` property must also exist as a top-level entity in the feed. Add all of the necessary metadata for its respective types, as indicated by their specification tables throughout this documentation. It's optional for these `mainEntity` types to include [Deep links](https://developers.google.com/actions/media/collect-information/identify-the-deep-links), as conveyed through the `potentialAction` property. |
| `mainEntity.@id` | [URL](http://schema.org/URL) | **Required** - The `@id` of the corresponding entity. The entity must exist in the feed and have an `@id` that's different from the `Interview` `@id`. |
| `interviewer.@type` | [Text](http://schema.org/Text) | **Required** - Always set to `Person`. |
| `interviewer.@id` | [URL](http://schema.org/URL) | **Required** - The interviewer's identifier in URI format; for example, *https://example.com/person/1234abc* . `@id` must meet the following requirements: - It's globally unique across your catalog. - It's static. The ID must be stable and not change over time. - It's in the form of a Unified Resource Identifier (URI). - The domain used for the `@id` value must be owned by your organization. |
| `interviewer.name` | [Text](http://schema.org/Text) | **Required** - The name of the interviewer. |
| `interviewee.@type` | [Text](http://schema.org/Text) | **Required** - Always set to `Person`. |
| `interviewee.@id` | [URL](http://schema.org/URL) | **Required** - The interviewee's identifier in URI format; for example, *https://example.com/person/1234abc* . `@id` must meet the following requirements: - It's globally unique across your catalog. - It's static. The ID must be stable and not change over time. - It's in the form of a Unified Resource Identifier (URI). - The domain used for the `@id` value must be owned by your organization. |
| `interviewee.name` | [Text](http://schema.org/Text) | **Required** - The name of the interviewee. |

### Interview example

The following example shows the markup for a `Interview` clip on the left tab
and its linked `mainEntity` on the right tab. This example includes a deep link.

> [!NOTE]
> **Note:** For a list of available `mainEntity` types, see [`mainEntity@type`](https://developers.google.com/actions/media/reference/data-specification/clips#interview-mainentity-type).

### Interview

The following clip represents an interview about a movie. The movie is
specified by the `@type` and `@id` of the `mainEntity` property.

    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "Interview",
      "@id": "https://www.example.com/abc_personb_interview",
      "name": "ABC Promotional Interview",
      "description": "ABC promotional interview of Person B with host Person A.",
      "potentialAction": {
        "@type": "WatchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "https://www.example.com/abc_personb_interview",
          "inLanguage": "en",
          "actionPlatform": [
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/MobileWebPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
        "actionAccessibilityRequirement": {
          "@type": "ActionAccessSpecification",
          "category": "subscription",
          "availabilityStarts": "2019-09-09T10:00:00Z",
          "availabilityEnds": "2019-09-30T10:00:00Z",
          "requiresSubscription": {
            "@type": "MediaSubscription",
            "@id": "http://www.example.com/premium_subscription",
            "name": "Example Premium",
            "sameAs": "http://www.example.com/premium_subscription",
            "commonTier": true
          },
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            },
            {
              "@type": "Country",
              "name": "CA"
            }
          ]
        }
      },
      "mainEntity": {
        "@type": "Movie",
        "@id": "https://www.example.com/movie/abc"
      },
      "interviewer": {
        "@type": "Person",
        "@id": "https://example.com/person/1234abc",
        "name": "Person A"
      },
      "interviewee": {
        "@type": "Person",
        "@id": "https://example.com/person/45664abc",
        "name": "Person B"
      }
    }

### Movie

The following is the `mainEntity` associated with the clip specified in the
`Interview` clip. This entity includes deep links in its `potentialAction`
property.

    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "Movie",
      "@id": "https://www.example.com/movie/abc",
      "url": "https://www.example.com/movie/abc",
      "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",
      "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"
        }
      ],
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "IMDB_ID",
          "value":  "tt0123456"
        }
      ]
    }