Watch Actions proprietà comuni

Questa sezione fornisce i dettagli delle proprietà comuni di Watch Actions.

Proprietà del markup dell'azione

Proprietà Tipo previsto Descrizione
@type Testo Obbligatorio: impostato sempre su WatchAction.
target EntryPoint Obbligatorio: un oggetto target che fornisce la mappatura dei link approfonditi a varie piattaforme Google.
target.@type Testo Obbligatorio: impostato sempre su EntryPoint.
target.urlTemplate URL Obbligatorio: un link diretto che indirizzi gli utenti alla tua app o piattaforma e avvia la riproduzione dei contenuti.
target.inLanguage Testo Facoltativo: lingua originale della serie in formato BCP 47.
target.actionPlatform Testo Obbligatorio: le piattaforme mappate a urlTemplate. Azioni multimediali supporta quanto segue:
  • http://schema.org/DesktopWebPlatform: piattaforma di ricerca su browser web desktop.
  • http://schema.org/MobileWebPlatform: piattaforma di ricerca su browser web mobile.
  • http://schema.org/AndroidPlatform: piattaforme di ricerca e PlayGuide nell'app per Android.
  • http://schema.org/AndroidTVPlatform: piattaforma Android TV nell'app Android TV.
  • http://schema.org/IOSPlatform: piattaforma di ricerca sull'app per iOS.
  • http://schema.googleapis.com/GoogleVideoCast: piattaforme Cast e Home su un dispositivo Chromecast.
  • http://schema.googleapis.com/GoogleAudioCast: piattaforme Cast e Home su un dispositivo Chromecast (solo azioni di ascolto).
Per i requisiti, consulta la sezione Tipi di piattaforme.
target.additionalProperty PropertyValue Obbligatorio se applicabile: un elenco di coppie proprietà-valore per rappresentare proprietà aggiuntive del link diretto. ad esempio:
  • contentLanguage: la lingua della trasmissione (doppiaggio), nel formato BCP 47. Se i contenuti sono doppiati in un'altra lingua, questa proprietà è obbligatoria. Utilizza un array per più codici lingua.
  • subtitleLanguage: le lingue dei sottotitoli codificati o dei sottotitoli codificati codificati, in formato BCP 47. Utilizza un array per più codici lingua.
  • cameraAngle: l'angolo della fotocamera per i contenuti; ad esempio, "A livello degli occhi" e "Angolo alto". Se i contenuti sono disponibili con diversi angoli di ripresa, questa proprietà è obbligatoria. Utilizza un array per più angolazioni della fotocamera.
  • videoFormat: il formato del file utilizzato per memorizzare la data del video digitale, ad esempio "SD" per la definizione standard e "HD" per la definizione elevata. I formati video validi includono SD, HD, 2K, 4K e 8K. Utilizza un array per più formati video.
Vedi l'esempio di additionalProperty.
actionAccessibilityRequirement ActionAccessSpecification Obbligatorio: un oggetto di specifica di accesso all'azione che descrive il requisito di accesso dei contenuti. Consulta la sezione Proprietà della specifica di accesso alle azioni.

Consulta le seguenti pagine per gli argomenti relativi a queste proprietà:

Proprietà della specifica di accesso alle azioni

Proprietà Tipo previsto Descrizione
actionAccessibilityRequirement.@type Testo Obbligatorio: impostato sempre su ActionAccessSpecification.
actionAccessibilityRequirement.category Testo

Obbligatorio: un requisito di accesso per i contenuti. Per ulteriori informazioni, consulta Tipo di paywall.

Se un'entità rappresenta un gruppo di contenuti, devi impostare category sul requisito di accesso meno restrittivo dei suoi contenuti. Ad esempio, se un TVSeries ha alcuni contenuti TVEpisode impostati su nologinrequired e altri su subscription, imposta questo TVSeries su nologinrequired.
actionAccessibilityRequirement.availabilityStarts Data

Obbligatorio: la data dopo la quale l'azione è disponibile, nel formato ISO 8601 (incluso il fuso orario).

  • La data può essere impostata in futuro.

È necessario che l'entità corrispondente venga fornita nel feed almeno 7 giorni prima della data di disponibilità. In questo modo aumenterai le probabilità che i contenuti vengano visualizzati sulle piattaforme Google in tempo.

actionAccessibilityRequirement.availabilityEnds Data Obbligatorio: la data dopo la quale l'azione non è più disponibile, nel formato ISO 8601 (incluso il fuso orario).
  • Deve essere uguale o superiore a 72 ore dopo availabilityStarts.
  • Se i contenuti sono sempre disponibili dopo la pubblicazione, imposta questa data su 20 anni dalla data corrente.

È obbligatorio apportare eventuali aggiornamenti alla data di fine disponibilità nel feed almeno 7 giorni prima della data di fine disponibilità. In questo modo, aumenteranno le probabilità che i contenuti smettano di essere visualizzati sulle piattaforme Google alla data di disponibilitàEnds.

actionAccessibilityRequirement.eligibleRegion Country, City, State, GeoShape o Text Obbligatorio: le regioni in cui i contenuti sono disponibili. Utilizza la stringa speciale EARTH se i contenuti sono disponibili a livello globale.
actionAccessibilityRequirement.ineligibleRegion Country, City, State o GeoShape Obbligatorio se applicabile: regioni in cui i contenuti sono soggetti a limitazioni. Non è necessario fornire questa proprietà se i contenuti sono disponibili ovunque all'interno di eligibleRegion.
actionAccessibilityRequirement.requiresSubscription MediaSubscription

Obbligatorio se applicabile: i dettagli dell'abbonamento di cui gli utenti hanno bisogno per accedere ai contenuti. Consulta Proprietà di abbonamento ai contenuti multimediali.

  • Fornisci questa proprietà se category è subscription o externalSubscription.
actionAccessibilityRequirement.expectsAcceptanceOf Offerta Obbligatorio se i contenuti richiedono un acquisto: i dettagli dell'offerta associata ai contenuti. Fornisci le informazioni sui prezzi per le seguenti situazioni:
  • Contenuti acquistati una tantum (rental o purchase)
  • Contenuti in abbonamento che richiedono un acquisto aggiuntivo da parte degli abbonati (subscription o externalsubscription)
Se il prezzo è 0,00, rimuovi completamente l'oggetto Offer e imposta category dell'oggetto ActionAccessSpecification su free. Consulta Proprietà dell'offerta.

Proprietà di abbonamento ai contenuti multimediali

Obbligatorio se actionAccessibilityRequirement.category è subscription o externalSubscription.

Proprietà Tipo previsto Descrizione
requiresSubscription.@type Testo Obbligatorio: impostato sempre su MediaSubscription
requiresSubscription.@id URL Obbligatorio: l'ID univoco dell'abbonamento. Se i contenuti sono accessibili tramite abbonamenti diversi, ogni abbonamento deve avere un ID univoco.
requiresSubscription.name Testo Obbligatorio: il nome dell'abbonamento. Tieni presente quanto segue:
  • Se i contenuti sono accessibili tramite abbonamenti diversi, questo nome deve corrispondere a quello nel sistema di autenticazione utente. Ad esempio, se un utente può accedere ai contenuti in base all'abbonamento chiamato Pacchetto 1, ma il sistema di autenticazione utilizza il nome PKG1a, utilizza PKG1.
  • Per i fornitori di TVE, si tratta del nome dell'autenticatore registrato con l'autenticatore TVE. Si tratta di una stringa che identifica in modo univoco il nome del servizio con l'app di autenticazione TVE.
requiresSubscription.sameAs URL La pagina che descrive l'abbonamento.
requiresSubscription.identifier Testo Obbligatorio se category è subscription E commonTier è false - Una stringa univoca per questo abbonamento che rappresenta l'accesso a un gruppo di contenuti nel tuo catalogo multimediale.
  • Google consiglia di utilizzare la seguente sintassi per l'identificatore:
    nome di dominio + due punti (:) + livello di accesso ai contenuti, Esempi : example.com:base, example.com:premium, example.com:sport
  • Questa proprietà sarà uguale al tuo identificatore dei diritti se fornisci un'API per i diritti
requiresSubscription.authenticator Organizzazione Obbligatorio se category è externalsubscription: un contenitore che fornisce i dettagli dell'autenticatore del fornitore esterno.
requiresSubscription.authenticator.@type Testo Obbligatorio se category è externalsubscription - Imposta sempre su Organization.
requiresSubscription.authenticator.name Testo Obbligatorio se category è externalsubscription: il nome del servizio di autenticazione. Per i fornitori di TVE, impostalo su TVE
requiresSubscription.commonTier Valore booleano Obbligatorio se applicabile: obbligatorio se la categoria è impostata su abbonamento. Scopri di più su commonTier nella documentazione relativa ai requisiti dei livelli comuni.

Requisiti dell'API Entitlements

È obbligatoria un'API per i diritti se actionAccessibilityRequirement.category è subscription o externalSubscription e la tua offerta in abbonamento include più pacchetti o livelli o supporta i componenti aggiuntivi. Non includere questa informazione se il tuo abbonamento è a un livello e consente l'accesso a tutti i contenuti del tuo catalogo.

  • La società A offre un unico abbonamento che consente agli utenti abbonati di accedere a tutti i contenuti disponibili: l'API / l'identificatore dei diritti non è obbligatorio
  • La società B ha un abbonamento base che fornisce l'accesso ad alcuni contenuti e un abbonamento premium che fornisce l'accesso a contenuti premium: è obbligatorio l'identificatore dei diritti / l'API
  • La società C ha un abbonamento base che fornisce l'accesso ad alcuni contenuti e pacchetti aggiuntivi che forniscono l'accesso a contenuti di terze parti: Entitlement Identifier / API è obbligatorio

Consulta le seguenti pagine per gli argomenti relativi a queste proprietà:

Proprietà dell'offerta

Proprietà Tipo previsto Descrizione
expectsAcceptanceOf.@type Testo Obbligatorio: impostato sempre su Offer.
expectsAcceptanceOf.price Number Obbligatorio: il prezzo di acquisto dei contenuti. Il prezzo deve essere un valore positivo diverso da zero. Per le entità con prezzo pari a 0,00, specifica la categoria come "free".
expectsAcceptanceOf.priceCurrency Testo Obbligatorio: la valuta del prezzo in formato ISO 4217 a tre lettere.
expectsAcceptanceOf.seller Organizzazione L'organizzazione che offre l'acquisto di contenuti.
expectsAcceptanceOf.seller.@type Testo Deve essere sempre impostato su Organization.
expectsAcceptanceOf.seller.name Testo Il nome del venditore.
expectsAcceptanceOf.seller.sameAs Testo L'URL di una pagina web che identifica il venditore, ad esempio la home page del venditore.

Pagina correlata all'offerta

Consulta le seguenti pagine per gli argomenti relativi a queste proprietà:

Identificatori

I feed di azioni multimediali accettano una serie di identificatori che possono aiutare a identificare un'entità in modo inequivocabile. Questi identificatori possono contribuire ad accelerare la procedura di riconciliazione dei contenuti nel tuo feed con i contenuti nei database di Google. Sebbene la maggior parte di questi identificatori possa essere aggiunta al feed utilizzando la proprietà identifier su vari tipi di entità, gli EIDR hanno una propria proprietà rappresentativa. Entrambe queste opzioni sono descritte di seguito.

Proprietà degli identificatori

Proprietà Tipo previsto Descrizione
identifier Testo Molto consigliato: un identificatore, di solito esterno, che identifica in modo univoco una determinata entità. Sono consentiti più identificatori.

Questa proprietà è disponibile in tutti i tipi di entità Azione sul dispositivo.

La tabella seguente elenca gli identificatori e le proprietà secondarie accettati della proprietà identifier. Consulta l'esempio di identificatore/EIDR nella sezione Esempi di feed di Watch Actions.
Proprietà Tipo previsto Descrizione
@type Testo Obbligatorio: impostato sempre su PropertyValue.
propertyID Testo Obbligatorio: supportiamo i seguenti tipi di documento di identità:
  • TMS_ROOT_ID: l'ID principale Gracenote (TMS) (ad es. 15829).
    • . Questo non è applicabile alle entità Organization e BroadcastService, in cui deve essere utilizzato solo TMS_ID.
  • TMS_ID: l'ID variante Gracenote (TMS) (ad es. MV000398520000).
  • WIKIDATA_ID: l'ID Wikidata (ad es. Q134773).
  • IMDB_ID: l'ID IMDb (ad es. tt0109830).
  • OPTA_ID: l'ID OPTA Sports.
  • STATS_ID: l'ID esecuzione STATS.
  • VIP_TIMES_ID: l'ID di VIPTimes (Nihon Tarento Meikan) per i talenti giapponesi.
  • DMA_ID: il codice dell'area di marketing designata degli Stati Uniti, utilizzato nell'oggetto GeoShape.
  • _PARTNER_ID_: questa proprietà deve contenere la stringa "_PARTNER_ID_". Il valore deve essere un ID univoco utilizzato da un fornitore di servizi, internamente o esternamente, per identificare l'entità (ad esempio 12345 o a5c604e2-e9e5-4ff3-b728-245799dc37f1).
value Testo Obbligatorio: il valore per il sistema di ID specificato.

Proprietà EIDR

EIDR (abbreviazione di Entertainment Identifier Registry) è un sistema di identificatori univoci a livello globale per una vasta gamma di contenuti multimediali, inclusi film e programmi televisivi. Il sistema di identificazione risolve un identificatore in un record dei metadati associato a titoli di primo livello, modifiche e altro ancora. La tabella seguente elenca le proprietà associate all'EIDR e il relativo utilizzo.

Proprietà Tipo previsto Descrizione
titleEIDR Testo Molto consigliato: un identificatore EIDR (Entertainment Identifier Registry) rappresenta, a livello più generale/astratto, un'opera cinematografica o televisiva.

Questa proprietà è disponibile nelle pagine di specifiche delle entità TVSeries, TVSeason, TVEpisode e Movie.

Ad esempio, titleEIDR per il film noto come "Ghostbusters" è "10.5240/7EC7-228A-510A-053E-CBB8-J".

Consulta l'esempio di identificatore/EIDR nella sezione degli esempi di feed di Watch Actions.
editEIDR Testo Molto consigliato: un identificatore EIDR (Entertainment Identifier Registry) rappresenta una modifica/edizione specifica di un'opera cinematografica o televisiva.

Questa proprietà è disponibile nelle pagine di specifica delle entità TVEpisode e Movie.

Ad esempio, il film noto come "Ghostbusters", il cui titleEIDR è "10.5240/7EC7-228A-510A-053E-CBB8-J", ha diversi montaggi, ad esempio "10.5240/1F2A-E1C5-680A-14C6-E76B-I" e "10.5240/8A35-3BEE-6497-5D12-9E4F-3".

La proprietà titleEIDR è obbligatoria se viene fornito editEIDR.

Consulta l'esempio di identificatore/EIDR nella sezione Esempi di feed di azioni di visualizzazione.

Agenzie di classificazione dei contenuti

Utilizza i valori in questa tabella per BroadcastService.contentRating, Movie.contentRating e TVSeries.contentRating. L'agenzia di rating deve essere anteposta al valore della classificazione. Esempi:

  • Un film classificato come "R" negli Stati Uniti deve avere un valore Movie.contentRating pari a "MPAA R".
  • Una serie TV classificata come "TV-MA" negli Stati Uniti deve avere un valore TVSeries.contentRating pari a "TV_PG TV-MA".

Paese Ente di classificazione dei programmi TV Ente di classificazione dei film
Albania (AL) Non disponibile Non disponibile
Angola (AO) Non disponibile CCE
Antigua e Barbuda (AG) Non disponibile MPAA
Argentina (AR) INCAA INCAA
Armenia (AM) Non disponibile MKRF/RUSSIA
Aruba (AW) Non disponibile Non disponibile
Australia (AU) ACB TV ACB Movies
Austria (AT) FSK FSK
Azerbaigian (AZ) Non disponibile MKRF/RUSSIA
Bahrein (BH) Non disponibile MPAA
12345…12

Proprietà GeoShape

Un oggetto GeoShape contiene uno dei seguenti tipi di dati:

Proprietà Tipo previsto Descrizione
@id URL Obbligatorio: l'identificatore della regione geografica in formato URI.
@type Testo Obbligatorio: impostato sempre su GeoShape.
addressCountry Testo Obbligatorio: il codice paese ISO 3166-1 alpha-2 a due lettere.
postalCode Testo Facoltativo: elenco di uno o più codici postali e/o FSA (Forward Sortation Area).
identifier PropertyValue Facoltativo: un ID Designated Market Area (DMA), ovvero un identificatore di una regione degli Stati Uniti in cui le persone ricevono gli stessi programmi e canali televisivi.
identifier.@type Testo Obbligatorio: impostato sempre su PropertyValue.
identifier.propertyID Testo Obbligatorio: impostato sempre su DMA_ID.
identifier.value Testo Obbligatorio: il codice DMA per la regione.

Esempio di oggetto GeoShape che contiene un elenco di codici postali:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area1",
  "addressCountry": "US",
  "postalCode": [
    "94118",
    "94119"
  ]
}

Esempio di oggetto GeoShape contenente una combinazione di FSA (Forward Sortation Area) e codici postali:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area2",
  "addressCountry": "CA",
  "postalCode": [
    "1A1",
    "K1A",
    "K1AOB1"
  ]
}

Esempio di oggetto GeoShape che contiene un ID DMA:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area3",
  "addressCountry": "US",
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "DMA_ID",
      "value": "501"
    }
  ]
}