Collect the metadata of your content

Google uses the metadata properties to reconcile the content in your feed with the content in Google's databases; the more metadata you provide for your content, the better Google can match the content.

There are properties in the documentation that are not listed as required because we understand that you might be missing this information for some content depending on how and where it is sourced. However, as we run evaluations, these fields might become required to help your feed achieve launch quality. Including these properties at the very beginning is highly recommended to avoid delays in the launch process. These properties include:

  • description
  • releasedEvent
  • Cast (actor, director)
  • TMS ID (identifier)

Google uses the metadata properties to reconcile the content in your feed with the content in Google's databases. A successful match means your title can appear in Google results. Google will not approve your feed if it has too many unsuccessful matches.

The likelihood of a successful match improves both with the completeness and accuracy of the metadata you provide. Properties like title, description, releaseDate, cast, and identifier (with a TMS ID) are particularly valuable for matching. Though some of these properties are not documented as required, Google may still require you to supply some or all of these for the entities that are not successfully matching.

Release Date (Other Uses)

On the prime time app, it helps users discover your content as they show up in prominent sections of the app.

    • Many collections are ranked based on recency of the content in that collection
    • New episodes get their own collection
    • New episode featured in top carousel
    • On the Google Play Movies app, some rows factor in release date into titles that appear and how they are ordered.
    • Push notification for TV shows, in user watchlist, when new episode is available
    • Episode air date in show detail page to help users find the right episodes

    The following metadata are recommended for each entity type:

    Movie duration, image, sameAs, trailer, and identifier.
    TVEpisode duration, image, sameAs, trailer, and identifier.
    TVSeries duration, image, sameAs, trailer, and identifier.
    TVSeasons duration, image, sameAs, trailer, and identifier.
    BroadcastService alternateName, callSign, slogan, areaServed, logo, sameAs, videoFormat, broadcastTimezone, and identifier.
    MusicGroup description, image, sameAs, and isFamilyFriendly.
    MusicAlbum description, image, sameAs, isFamilyFriendly, numTracks, and timeRequired.
    MusicRecording description, image, sameAs, isFamilyFriendly, duration, and inAlbum.
    MusicPlaylist description, image, creator,keywords, and isFamilyFriendly.
    RadioBroadcastService alternateName, callSign, slogan, areaServed, logo, popularityScore, inLanguage, sameAs, identifier, and keywords.

    Descriptions

    The following list contains the descriptions of the recommended properties:

    • sameAs: A URL to a web page that references the content; for example, a movie's IMDB page or Wikipedia page.
    • trailer.description: The description of the content's trailer.
    • trailer.inLanguage: The language of the trailer.
    • trailer.url: The URL of the trailer hosted on YouTube.
    • trailer.regionsAllowed: The regions where the trailer is allowed. (Type: Place)
    • releasedEvent: The details about the release of the content. (Type: PublicationEvent)
    • identifier: An externally recognizable ID that can identify this content. Multiple identifiers are allowed.
    • isFamilyFriendly: An indicator that tells whether the content is family friendly.
    • timeRequired: The length of the album.
    • inAlbum.id: The @id of the album on which this MusicRecording appears.
    • inAlbum.name: The name of the album on which this MusicRecording appears.
    • creator: The creator of the playlist; it indicates that the playlist is created by your service or a high interest user of your service. (Type: Organization or Person)
    • keywords: A list of words that are associated with the content.
    • alternateName: An alternate name that helps users identify the broadcast service.
    • callSign: The official government-issued callsign of the broadcast service.
    • contentRating: The official rating of the content. For example, "_USAPARENTAL TV-Y". For an adult only TV broadcast service, this is required.
    • slogan: The slogan of the broadcast service.
    • areaServed: The area where the broadcast service is available.
    • logo: A logo image of the broadcast station. (Type: ImageObject)
    • videoFormat: The highest quality definition supported by the broadcast service.
    • broadcastTimezone: The timezone of the broadcast service.
    • popularityScore: A popularity score that helps determine the serving priority when there are multiple candidates.
    • inLanguage: The language of the program broadcast on this radio station.

    Example

    Example of the recommended properties of a Movie entity.

    {
      ...
      "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
      "releasedEvent": {
        "@type": "PublicationEvent",
        "startDate": "2008-01-20",
        "location": {
          "@type": "Country",
          "name": "US"
        }
      },
      "description": "This is my favorite TV show.",
      "actor": [
        {
          "@type": "Person",
          "name": "John Doe",
          "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
        },
        {
          "@type": "Person",
          "name": "Jane Doe",
          "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
        }
      ],
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "IMDB_ID",
          "value":  "tt0123456"
        }
      ]
      ...
    }
    

    Collect the metadata

    Do the following:

    1. Identify the recommended properties of your content.
    2. Gather and organize the metadata information in one place.