Content entities in your catalog generally require the following properties:

- `@id`: A global [identifier](https://developers.google.com/actions/media/collect-information/collect-the-id-url-and-name#identifier) for the entity.
- `url`: A [canonical URL](https://developers.google.com/actions/media/collect-information/collect-the-id-url-and-name#canonical_url) for the content. Don't use `url` on `BroadcastEvent`, `SportsEvent`, or channel lineup entities (`TelevisionChannel` and `CableOrSatelliteService`).
- `name`: The name of the content.

Example of `@id`, `url`, and `name`:

    "@id": "http://www.example.com/episode/video/432432432",
    "url": "http://www.example.com/episode/video/432432432",
    "name": "My example episode",

## Identifier

An identifier (`@id`) must meet the following requirements:

- Globally unique across your catalog
  - For instance, don't use the same `@id` for a `TVSeries` and a `TVSeason`.
- Static
  - You cannot change `@id` later.
- In the form of Unified Resource Identifier (URI)
  - If your content's local identifier (ID) is not in a URI format, prepend your domain to the ID to satisfy this requirement; for example, if your content's ID is *1234abc* and your domain is *https://example.com* , `@id` can be *https://example.com/1234abc.*
  - `@id` does not have to be a working URL; it only needs to be in a URI format.
  - The domain used in `@id` (for example, *https://example.com*) must be owned by your organization.

Because an entity's `url` meets all the requirements as an identifier (that is, globally unique, static, and in the form of a URI), we recommend you use an entity's `url` as `@id`.

## Canonical URL

A canonical URL (`url`) helps Google accurately reconcile the content in your catalog with the content in Google's databases.

"A canonical URL is the URL of the page that Google thinks is most representative from a set of duplicate pages on your site. For example, if you have URLs for the same page (for example: *example.com?dress=1234* and *example.com/dresses/1234* ), Google chooses one as canonical." (Source: [Consolidate duplicate URLs](https://support.google.com/webmasters/answer/139066))

The following are the requirements for the canonical URL:

- `url` must be globally unique.
- `url` must contain a working canonical URL that Google can crawl.
- (Listen Actions only) `url` needs to point to a content description page that is not blocked by a paywall.
- (Live TV) Do **not** include `url` on `BroadcastEvent` entities. For TV and movie broadcasts, provide `url` on the underlying `Movie`, `TVSeries`, or `TVEpisode` entity.
- (Sports) Do **not** include `url` on `SportsEvent` entities. Provide playback links using `SportsEvent.potentialAction`.
- (Live TV and Sports) Ensure `BroadcastEvent.@id` is distinct from the `@id` of the referenced `Movie`, `TVSeries`, `TVEpisode`, or `SportsEvent` entity.

## Collect the ID, URL, and name

Do the following:

1. Gather the names of the content in your catalog.
2. Identify the canonical URLs of the content. (We recommend you use the content's `url` as its `@id`.)