Esempi di feed di azioni di visualizzazione

I seguenti esempi mostrano alcuni degli scenari comuni per le azioni di visualizzazione.

Importante: per brevità, tutti gli esempi riportati di seguito omettono la busta del feed di dati, che è l'oggetto di primo livello nel feed di Azioni multimediali e contiene un array di entità che rappresentano i contenuti del tuo catalogo. Tutti i feed inviati a Google devono includere la busta del feed di dati, come indicato nella sezione Panoramica.

Attenzione: gli esempi riportati di seguito mostrano solo le entità e le proprietà più pertinenti allo scenario trattato nell'esempio. Potrebbero essere necessarie più entità e proprietà prima che il feed venga inviato a Google.

Entità di esempio di ogni tipo

Film

Un'entità Movie che rappresenta un film di fantasia intitolato "Il mio film preferito"

{
  "@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",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package"
      },
      "additionalProperty": {
        "@type": "PropertyValue",
        "name": "DisplaySubscriptionIdentifier",
        "value": "http://www.example.com/example_package"
      },
      "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"
    }
  ]
}

TVSeries

Un'entità TVSeries che rappresenta un programma TV immaginario chiamato "Il mio programma TV preferito"

 {
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type": "TVSeries",
   "@id": "http://www.example.com/my_favorite_tv_show/",
   "url": "http://www.example.com/my_favorite_tv_show/",
   "name": "My Favorite TV Show",
   "potentialAction": {
     "@type": "WatchAction",
     "target": {
       "@type": "EntryPoint",
       "urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?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",
         "requiresSubscription": {
           "@type": "MediaSubscription",
           "name": "Example Package",
           "commonTier": true,
           "@id": "https://example.com/package/example"
         },
         "additionalProperty": {
           "@type": "PropertyValue",
           "name": "DisplaySubscriptionIdentifier",
           "value": "http://www.example.com/package/example"
         },
         "availabilityStarts": "2017-07-21T10:35:29Z",
         "availabilityEnds": "2018-10-21T10:35:29Z",
         "eligibleRegion": [
           {
             "@type": "Country",
             "name": "US"
           },
           {
             "@type": "Country",
             "name": "CA"
           }
         ]
     }
   },
   "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
   "releasedEvent": {
     "@type": "PublicationEvent",
     "startDate": "2008-01-20",
     "location": {
       "@type": "Country",
       "name": "US"
     }
   },
   "popularityScore": {
     "@type": "PopularityScoreSpecification",
     "value": 4.1,
     "eligibleRegion": [
       {
         "@type": "Country",
         "name": "US"
       },
       {
         "@type": "Country",
         "name": "CA"
       }
     ]
   },
   "description": "This is my favorite TV show.",
   "contentRating": "RATING NOT KNOWN",
   "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":  "tt0903747"
       }
     ]
 }
 ```

TVEpisode

Un'entità TVEpisode che rappresenta il 14° episodio della 7ª stagione del programma TV di fantasia "My Favorite TV Show"

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVEpisode",
  "@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "url": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "name": "John Doe returns with a horse",
  "episodeNumber": 14,
  "contentRating": "TVPG TV-MA",
  "partOfSeason": {
    "@type": "TVSeason",
    "@id": "http://www.example.com/my_favorite_tv_show/s7",
    "seasonNumber": 7
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
        "additionalProperty": {
          "@type": "PropertyValue",
          "name": "DisplaySubscriptionIdentifier",
          "value": "http://www.example.com/package/example"
        },
        "availabilityStarts": "2017-07-21T10:35:29Z",
        "availabilityEnds": "2018-10-21T10:35:29Z",
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "CA"
          }
        ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
  "duration": "PT00H25M",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2014-01-09",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 3.9,
    "eligibleRegion": "EARTH"
  },
  "description": "John Doe returns to the village three years after his disappearance.",
  "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":  "tt3453320"
    }
}

TVSeason

Un'entità TVSeason che rappresenta la settima stagione di un programma TV di fantasia intitolato "Il mio programma TV preferito"

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeason",
  "@id": "http://www.example.com/my_favorite_tv_show/s7",
  "url": "http://www.example.com/my_favorite_tv_show/s7",
  "name": "Season 7",
  "seasonNumber": 7,
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
        "additionalProperty": {
          "@type": "PropertyValue",
          "name": "DisplaySubscriptionIdentifier",
          "value": "http://www.example.com/package/example"
        },
        "availabilityStarts": "2017-07-21T10:35:29Z",
        "availabilityEnds": "2018-10-21T10:35:29Z",
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
      }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2010-09-23",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "The seventh season of 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"
    }
  ]
}

Organizzazione (operatore TV)

Un'entità Organization che rappresenta un fornitore di servizi TV fittizio, "Example Cable TV Company", che fornisce un servizio di TV in diretta su una rete via cavo

{
  "@context":"http://schema.org",
  "@type":"Organization",
  "@id": "http://example.com/example_cable_tv_company",
  "name": "Example Cable TV Company",
  "sameAs": "https://en.wikipedia.org/wiki/example_cable_company"
}

CableOrSatelliteService

Un CableOrSatelliteService che rappresenta i servizi TV via cavo a New York (DMA_ID=501), forniti dal fornitore di servizi TV nazionale "Example Cable TV Company"

{
  "@context":"http://schema.org",
  "@type":"CableOrSatelliteService",
  "@id":"http://example.com/example_cable_tv_company_new_york",
  "name":"Example Cable TV Company - New York",
  "provider": {
    "@type": "Organization",
    "@id": "http://example.com/example_cable_tv_company"
  },
  "areaServed":[
    {
      "@type": "GeoShape",
      "@id": "http://example.com/newyork_01",
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "DMA_ID",
          "value": "501"
        }
      ]
    }
  ]
}

Organizzazione

Un'entità Organization che rappresenta il canale "ExampleTV Channel", offerto agli utenti da un fornitore di servizi TV fittizio "Example Cable TV Company" a New York

{
  "@context":"http://schema.org",
  "@type":"Organization",
  "@id":"http://example.com/exampletv",
  "name":"ExampleTV Channel",
  "sameAs": "https://en.wikipedia.org/wiki/exampletv"
}

BroadcastService

Un'entità BroadcastService che rappresenta il canale "ExampleTV Channel", offerto agli utenti da un fornitore di servizi TV fittizio "Example Cable TV Company" a New York. Le entità BroadcastService forniscono i dettagli dei deep link e i requisiti di accesso per il canale

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"https://www.example.com/exampletv/broadcast/hd",
  "name": "ExampleTV Channel",
  "description": "A fictional TV broadcast service in HD",
  "broadcastDisplayName":"ExampleTV-Channel",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://www.example.com/exampletv"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": [
      {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/exampletv/broadcast/hd?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"
        ]
      },
      {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/exampletv/broadcast/androidtv/hd?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      }
    ],
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://www.example.com/exampletv/basic_subscription",
        "name": "Basic subscription",
        "identifier": "example.com:basic",
        "commonTier": true
      },
      "additionalProperty": {
          "@type": "PropertyValue",
          "name": "DisplaySubscriptionIdentifier",
          "value": "http://www.example.com/exampletv/basic_subscription"
        },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  },
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value": "102610"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "_PARTNER_ID_",
      "value": "exampletv-12345"
    }
  ]
}

TelevisionChannel

Un'entità TelevisionChannel che indica che il canale "ExampleTV Channel" è disponibile sul canale 7 e fa parte dei servizi TV via cavo forniti a New York dal fornitore di servizi TV fittizio "Example Cable TV Company"

{
  "@context":"http://schema.org",
  "@type":"TelevisionChannel",
  "@id":"http://example.com/example_cable_tv_company_san_francisco/exampletv",
  "broadcastChannelId":"7",
  "broadcastServiceTier":"Standard",
  "inBroadcastLineup":{
    "@type":"CableOrSatelliteService",
    "@id":"http://example.com/example_cable_tv_company_san_francisco_bay"
  },
  "providesBroadcastService":{
    "@type":"BroadcastService",
    "@id":"https://www.example.com/exampletv/broadcast/hd"
  }
}

BroadcastEvent

Un'entità BroadcastEvent che rappresenta la trasmissione di un film su "ExampleTV Channel" tra le 17:00 e le 19:00 del 12 luglio 2019.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live/movie/new_release",
  "name": "My Favorite Movie",
  "description": "John Doe spent years perfecting his survival skills in a tropical jungle.",
  "startDate": "2019-07-12T17:00-08:00",
  "endDate": "2019-07-12T19:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "workPerformed": {
    "@type": "Movie",
    "@id": "http://www.example.com/my_favorite_movie"
  }
}

SportsEvent

Un'entità SportsEvent che rappresenta una partita di basket giocata tra due squadre

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/basketball/professional/final_game_6",
  "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."
    },
  "startDate": "2019-09-16T10:00-08:00",
  "endDate": "2019-09-16T13: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/Professional_Basketball_League"
    },
    "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/Professional_Basketball_League"
    },
    "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":  "EP000194303282"
    }
  ]
}

Esempi correlati ai deep link

Fornire deep link non universali

Un'entità con un link di vecchio stile per la piattaforma Android e un deep link universale per tutte le altre piattaforme

  "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/IOSPlatform",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      
      {
        "@type": "EntryPoint",
        "urlTemplate": "android-app://com.example/example-scheme/my_favorite_movie?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/AndroidPlatform",
          "http://schema.org/AndroidTVPlatform"
        ]
      }
    ],
    "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": "http://www.example.com/example_package"
       },
       "additionalProperty": {
            "@type": "PropertyValue",
            "name": "DisplaySubscriptionIdentifier",
            "value": "http://www.example.com/example_package"
          },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  }

Fornire requisiti di accessibilità con limiti di tempo

Un'entità che modifica il requisito di accessibilità nel tempo: free per un periodo di tempo limitato e subscription successivamente

  "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": "free",
        "availabilityStarts": "2019-01-01T00:00Z",
        "availabilityEnds": "2019-05-31T00:00Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      },
      {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-06-01T10:35:29Z",
        "availabilityEnds": "2020-06-01T10:35:29Z",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "http://www.example.com/example_package"
         },
         "additionalProperty": {
            "@type": "PropertyValue",
            "name": "DisplaySubscriptionIdentifier",
            "value": "http://www.example.com/example_package"
          },
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "CA"
          }
        ]
      }
    ]
  }

Fornire più requisiti di accessibilità basati sulla piattaforma

Un'entità con più requisiti di accessibilità in base alle piattaforme: free per le piattaforme desktop e mobile e subscription per la piattaforma ChromeCast

  "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"
        ]
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "free",
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      }
    },
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": "http://schema.googleapis.com/GoogleVideoCast",
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "http://www.example.com/example_package"
         },
         "additionalProperty": {
            "@type": "PropertyValue",
            "name": "DisplaySubscriptionIdentifier",
            "value": "http://www.example.com/example_package"
          },
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "CA"
          }
        ]
      }
    }
  ]

Utilizzo della proprietà additionalProperty per le informazioni sui contenuti

Un'entità Movie che mostra l'utilizzo della proprietà additionalProperty e delle relative proprietà secondarie per fornire informazioni sulla lingua dei contenuti e dei sottotitoli, sul formato video e sull'angolazione della videocamera utilizzata.

{
  "@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/multipleViews",
          "actionPlatform": [
            "http://schema.org/IOSPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/AndroidTVPlatform",
            "http://schema.googleapis.com/GoogleVideoCast"
          ],
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentLanguage",
              "value": [
                "en"
              ]
            },
            {
              "@type": "PropertyValue",
              "name": "subtitleLanguage",
              "value": [
                "en",
                "es"
              ]
            },
            {
              "@type": "PropertyValue",
              "name": "videoFormat",
              "value": [
                "HD",
                "4K"
              ]
            },
            {
              "@type": "PropertyValue",
              "name": "cameraAngle",
              "value": [
                "Eye-Level",
                "High-Angle"
              ]
            }
          ]
        }
      ],
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "http://www.example.com/example_package"
        },
        "additionalProperty": {
          "@type": "PropertyValue",
          "name": "DisplaySubscriptionIdentifier",
          "value": "http://www.example.com/example_package"
        },
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2019-05-31T10:35:29Z",
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "CA"
          }
        ]
      }
    }
  ]
}

Entità disponibile in più regioni e lingue

Importante: @language indica la lingua utilizzata per @value; non indica la disponibilità dei contenuti in quella lingua o in quella regione. Ad esempio, pt-br in @language non significa che i contenuti sono disponibili in portoghese in Brasile, ma identifica la lingua utilizzata in @value come portoghese brasiliano. Utilizza eligibleRegion per specificare dove sono disponibili i contenuti e contentLanguage per specificare la lingua in cui gli utenti possono fruire dei contenuti.

{
  "@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": [
    {
      "@language": "en-us",
      "@value": "My Favorite Movie"
    },
    {
      "@language": "en-gb",
      "@value": "My Favourite Movie"
    },
    {
      "@language": "es-mx",
      "@value": "mi película favorita"
    },
  ],
  "description": [
    {
      "@language": "en-us",
      "@value": "Jenny meets Paul."
    },
    {
      "@language": "en-gb",
      "@value": "Jenny meets Paul."
    },
    {
      "@language": "es-mx",
      "@value": "Jenny conoce a paul."
    }
  ],
  "potentialAction": [
    {
      "@type": "WatchAction",
      "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/IOSPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/AndroidTVPlatform"
        ],
      }
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": [
               {"@language": "en-US", @value: "Example Subscription"},
               {"@language": "es-MX", @value: "Suscripción de Ejemplo"},
               {"@language": "en-GB", @value: "Example Subscription"},
          ],
          "commonTier": true,
          "@id": "http://www.example.com/example_package"
        },
        "additionalProperty": {
          "@type": "PropertyValue",
          "name": "DisplaySubscriptionIdentifier",
          "value": "http://www.example.com/example_package"
        },
        "availabilityStarts": "2018-07-21T10:35:29Z",
        "availabilityEnds": "2019-10-21T10:35:29Z",
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "GB"
          },
          {
            "@type": "Country",
            "name": "MX"
          }
        ]
      },
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentLanguage",
          "value": [
            "en",
            "es"
          ]
        },
      ]
    }
  ],
  // Other properties...
}

Fornire informazioni sul trailer tramite l'entità Movie

Attenzione: i trailer non possono essere inviati a Google come entità di primo livello, ma possono essere aggiunti solo all'entità Movie come proprietà.

{
  "@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",
  "trailer":[
    {
      "@type":"VideoObject",
      "description":"In a world where dreamers continue to dream...",
      "inLanguage":"en-US",
      "url":"https://www.youtube.com/watch?v=contentIDhere"
    }
  ],
  "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"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "requiresSubscription": {
         "@type": "MediaSubscription",
         "name": "Example Package",
         "commonTier": true,
         "@id": "http://www.example.com/example_package"
      },
      "additionalProperty": {
        "@type": "PropertyValue",
        "name": "DisplaySubscriptionIdentifier",
        "value": "http://www.example.com/example_package"
      },
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Rappresentazione di un'offerta di pacchetti di abbonamento a più livelli per il tuo catalogo

Film

Un'entità Movie disponibile tramite i livelli di abbonamento "Premium Package" e "Basic Package". Estendi questo esempio per acquisire offerte di abbonamento che includono più pacchetti o livelli o che supportano componenti aggiuntivi.

{
  "@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"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": [
        {
          "@type": "MediaSubscription",
          "name": "Basic Package",
          "@id": "http://www.example.com/basic_package",
          "commonTier": true
        },
        {
          "@type": "MediaSubscription",
          "name": "Premium Package",
          "@id": "http://www.example.com/premium_package",
          "commonTier": false,
          "identifier": "example.com:premium_package"
        }
      ],
      "additionalProperty": {
        "@type": "PropertyValue",
        "name": "DisplaySubscriptionIdentifier",
        "value": "http://www.example.com/basic_package"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  },
  "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"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value": "tt0123456"
    }
  ]
}

TVSeries

Un'entità TVSeries disponibile solo tramite il "Pacchetto Premium" dell'abbonamento.

{
  "@context": [
    "http://schema.org",
    {
      "@language": "en"
    }
  ],
  "@type": "TVSeries",
  "@id": "http://www.example.com/my_favorite_tv_show/",
  "url": "http://www.example.com/my_favorite_tv_show/",
  "name": "My Favorite TV Show",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2017-07-21T10:35:29Z",
      "availabilityEnds": "2018-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Premium Package",
        "@id": "http://www.example.com/premium_package",
        "identifier": "example.com:premium",
        "commonTier": false
      },
      "additionalProperty": {
        "@type": "PropertyValue",
        "name": "DisplaySubscriptionIdentifier",
        "value": "http://www.example.com/premium_package"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  },
  "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"
    }
  ]
}

Fornire diversi tipi di releasedEvents: PublicationEvent, FeaturedEvent ed ExclusiveEvents

Rappresentazione dei contenuti di original but not exclusive

Il fornitore del feed presenta un film in tutto il mondo per il mese di aprile 2020. Il film è stato originariamente distribuito negli Stati Uniti il 1° ottobre 2018.

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie",
  "url": "http://www.example.com/my_favorite_movie",
  "releasedEvent": [
    {
      "@type": "FeaturedEvent",
      "location": "EARTH",
      "startDate": "2020-04-01",
      "endDate":   "2020-04-30",
      "publishedBy": {
        "@type": "Organization",
        "@id": "https://www.abcmedia.com/",
        "sameAs": "https://en.wikipedia.org/wiki/ABCMedia",
        "name": "ABC Media"
      }
    },
    {
     "@type": "PublicationEvent",
     "location": {
       "@type": "Country",
       "name": "US"
     },
     "startDate": "2018-10-01T20:00",
     "publishedBy": {
       "@type": "Organization",
       "@id": "https://www.abcmedia.com/",
       "sameAs": "https://en.wikipedia.org/wiki/ABCMedia",
       "name": "ABC Media"
     }
   }
 ]
}

Rappresentazione dei contenuti di exclusive but not original

Il fornitore che fornisce il feed ha il diritto esclusivo su un film in tutto il mondo da settembre 2019 a settembre 2030.

{
"@context": [ "http://schema.org", { "@language": "en" } ],
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie",
"url": "http://www.example.com/my_favorite_movie",
"releasedEvent": [ {
  "@type": "ExclusiveEvent",
  "location": "EARTH",
  "startDate": "2019-09-01T00:00",
  "endDate": "2030-09-27T00:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.abcmedia.com/",
    "sameAs": "https://en.wikipedia.org/wiki/ABCMedia",
    "name": "ABC Media"
  }
 }, {
  "@type": "PublicationEvent",
  "location": "EARTH",
  "startDate": "2018-10-01T20:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.abcmedia.com/",
    "sameAs": "https://en.wikipedia.org/wiki/ABCMedia",
    "name": "ABC Media"
   }
 }
 ]
}

Rappresentazione dei contenuti di exclusive and original

Il fornitore che fornisce il feed detiene i diritti esclusivi sui contenuti in tutto il mondo da settembre 2019 a settembre 2030. L'entità è in primo piano negli Stati Uniti e in Canada per il mese di aprile 2020.

Nota: se contrassegni una serie TV come esclusiva o originale, tutti gli episodi dello show verranno contrassegnati in questo modo.

{
"@context": [ "http://schema.org", { "@language": "en" } ],
"@type": "TVSeries",
"@id": "http://www.example.com/my_favorite_tvshow",
"url": "http://www.example.com/my_favorite_tvshow",
"releasedEvent": [ {
  "@type": "FeaturedEvent",
  "location": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
  ],
  "startDate": "2020-04-01",
  "endDate":   "2020-04-30",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.abcmedia.com/",
    "sameAs": "https://en.wikipedia.org/wiki/ABCMedia",
    "name": "ABC Media"
  }
 }, {
  "@type": "ExclusiveEvent",
  "location": "EARTH",
  "startDate": "2019-09-01T00:00",
  "endDate": "2030-09-27T00:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.abcmedia.com/",
    "sameAs": "https://en.wikipedia.org/wiki/ABCMedia",
    "name": "ABC Media"
  }
 }, {
  "@type": "PublicationEvent",
  "location": "EARTH",
  "startDate": "2018-10-01T20:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.abcmedia.com/",
    "sameAs": "https://en.wikipedia.org/wiki/ABCMedia",
    "name": "ABC Media"
   }
 }
 ]
}

Esempi di identificatori/EIDR

Film principale

Un film con una variante di versione estesa. Tieni presente che questa entità ha un titleEIDR oltre a un identificatore IMDB_ID e TMS_ROOT_ID per il film principale.

{
  "@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",
      "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
      },
      "additionalProperty": {
        "@type": "PropertyValue",
        "name": "DisplaySubscriptionIdentifier",
        "value": "http://www.example.com/package/example"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
  "contentRating": "RATING NOT KNOWN",
  "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"
    }
  ],
  "titleEIDR" : "10.5240/7EC7-228A-510A-053E-CBB8-J",
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ROOT_ID",
      "value":  ["MV00123456"]
    }
  ],
  "workExample": {
      "@type": "Movie",
      "@id": "http://www.example.com/my_favorite_movie_extended_cut",
      "name": "My Favorite Movie Extended Cut",
      "category": "Extended Cut"
  }
}

Variante con taglio esteso

La versione estesa del film principale. Tieni presente che questa entità variante ha sia titleEIDR che editEIDR, oltre a più TMS_ID correlati a questo taglio.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie_extended_cut",
  "url": "http://www.example.com/my_favorite_movie_extended_cut",
  "name": "My Favorite Movie Extended Cut",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie_extended_cut?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": "http://www.example.com/example_package",
        "identifier": "example.com:example_package"
       },
      "additionalProperty": {
        "@type": "PropertyValue",
        "name": "DisplaySubscriptionIdentifier",
        "value": "http://www.example.com/example_package"
       },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie_extended_cut",
  "contentRating": {
        "@type": "Rating",
        "author": "MPAA",
        "ratingValue": "R",
        "advisoryCode": "FV"
   },
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "This is the extended cut of 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"
    }
  ],
 "titleEIDR" : "10.5240/7EC7-228A-510A-053E-CBB8-J",
 "editEIDR" : "10.5240/1F2A-E1C5-680A-14C6-E76B-I",
 "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value":  ["MV00123450", "MV00123458"]
    }
  ],
 "exampleOfWork": {
  "@id": "http://www.example.com/my_favorite_movie"
 },
 "category": "Extended Cut"
}