Watch Actions proprietà comuni

Questa sezione fornisce i dettagli delle proprietà comuni delle azioni di visualizzazione.

Proprietà del markup dell'azione

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

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

Proprietà delle specifiche di accesso all'azione

Proprietà Tipo previsto Descrizione
actionAccessibilityRequirement.@type Testo Obbligatorio: sempre impostato 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 alcuni impostati su subscription, imposta questo TVSeries su nologinrequired.
actionAccessibilityRequirement.availabilityStarts Data

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

  • La data può essere impostata nel futuro.

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

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

È necessario che eventuali aggiornamenti alla data availabilityEnds vengano apportati nel feed almeno 7 giorni prima della data availabilityEnds. In questo modo aumenteranno le probabilità che i contenuti non vengano più visualizzati sulle piattaforme Google alla data di fine disponibilità.

actionAccessibilityRequirement.eligibleRegion Country, City, State, GeoShape o Text Obbligatorio: le regioni in cui sono disponibili i contenuti. 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 necessario agli utenti per accedere ai contenuti. Consulta le proprietà degli abbonamenti 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 i seguenti casi:
  • 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 le proprietà dell'offerta.
actionAccessibilityRequirement.additionalProperty PropertyValue Obbligatorio se applicabile: un riferimento al pacchetto di abbonamento che verrà visualizzato nell'esperienza.
actionAccessibilityRequirement.additionalProperty.name Testo Obbligatorio: impostato sempre su "DisplaySubscriptionIdentifier"
actionAccessibilityRequirement.additionalProperty.value Testo Obbligatorio: il requiresSubscription.@id che verrà visualizzato per l'entità.

Proprietà dell'abbonamento ai contenuti multimediali

Obbligatorio se actionAccessibilityRequirement.category è subscription o externalSubscription.

Proprietà Tipo previsto Descrizione
requiresSubscription.@type Testo Obbligatorio: sempre impostato 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. Nota quanto segue:
  • Se i contenuti sono accessibili tramite abbonamenti diversi, questo nome deve corrispondere a quello del tuo sistema di autenticazione degli utenti. Ad esempio, se un utente può accedere ai contenuti in base all'abbonamento denominato Pacchetto 1, ma il sistema di autenticazione utilizza il nome PKG1a, utilizza PKG1.
  • Per i fornitori TVE, si tratta del nome dell'autenticatore registrato con il tuo autenticatore TVE. È una stringa che identifica in modo univoco il nome del tuo servizio con TVE Authenticator.
  • Se l'abbonamento ha più nomi, specifica un array di valori. Consulta il seguente esempio per scoprire come aggiungere un array di nomi con più traduzioni
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, ad esempio : example.com:basic, example.com:premium, example.com:sports
  • Questa proprietà sarà uguale al tuo identificatore di diritto se fornisci un'API Entitlements
requiresSubscription.authenticator Organizzazione Obbligatorio se category è externalsubscription: un contenitore che fornisce i dettagli dello strumento di autenticazione del provider esterno.
requiresSubscription.authenticator.@type Testo Obbligatorio se category è externalsubscription - Impostato sempre su Organization.
requiresSubscription.authenticator.name Testo Obbligatorio se category è externalsubscription: il nome del servizio di autenticazione. Per i fornitori TVE, impostalo su TVE.
requiresSubscription.commonTier Valore booleano Obbligatorio se applicabile: questo campo è obbligatorio se la categoria è impostata su abbonamento. Scopri di più su commonTier nella documentazione sui requisiti del livello comune.

Requisiti dell'API Entitlements

Un'API per i diritti è obbligatoria se actionAccessibilityRequirement.category è subscription o externalSubscription e la tua offerta di abbonamento include più pacchetti o livelli oppure supporta i componenti aggiuntivi. Non includere questo valore se il tuo abbonamento è a più livelli e dà accesso a tutti i contenuti del tuo catalogo.

  • La società A ha una singola offerta di abbonamento che consente agli utenti abbonati di accedere a tutti i contenuti disponibili: l'identificatore del diritto / API non è obbligatorio
  • La società B ha un abbonamento di base che fornisce l'accesso ad alcuni contenuti e un abbonamento premium che fornisce l'accesso a contenuti premium: Identificatore diritto / API è obbligatorio
  • La società C ha un abbonamento di base che fornisce l'accesso ad alcuni contenuti e pacchetti aggiuntivi che forniscono l'accesso a contenuti di terze parti: Identificatore diritto / API è obbligatorio

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

Proprietà dell'offerta

Proprietà Tipo previsto Descrizione
expectsAcceptanceOf.@type Testo Obbligatorio: sempre impostato 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 0,00, specifica la categoria come "senza costi".
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 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 correlati a queste proprietà:

Identificatori

I feed Azioni multimediali accettano una serie di identificatori che possono aiutare a identificare un'entità in modo univoco. 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 ID pubblicità digitale hanno una propria proprietà rappresentativa. Entrambe sono descritte di seguito.

Proprietà dell'identificatore

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

Questa proprietà è disponibile per tutti i tipi di entità Azione di visualizzazione.

La tabella seguente elenca gli identificatori e le proprietà secondarie accettati della proprietà identifier. Consulta Esempio di identificatore/EIDR nella sezione Esempi di feed Azioni di visualizzazione.
Proprietà Tipo previsto Descrizione
@type Testo Obbligatorio: sempre impostato su PropertyValue.
propertyID Testo Obbligatorio: supportiamo i seguenti tipi di documento di identità:
  • TMS_ROOT_ID: l'ID radice Gracenote (TMS) (ad esempio, 15829).
    • . Questo non si applica alle entità Organization e BroadcastService in cui deve essere utilizzato solo TMS_ID.
  • TMS_ID: l'ID variante Gracenote (TMS) (ad esempio, MV000398520000).
  • WIKIDATA_ID: l'ID WikiData (ad esempio, Q134773).
  • IMDB_ID: l'ID IMDB (ad esempio, tt0109830).
  • OPTA_ID: l'ID OPTA Sports.
  • STATS_ID: l'ID STATS Perform.
  • VIP_TIMES_ID: l'ID Japan 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 The Entertainment Identifier Registry) è un sistema di identificatori univoci a livello globale per un'ampia gamma di contenuti multimediali, tra cui film e programmi televisivi. Il sistema di identificazione risolve un identificatore in un record di metadati associato a titoli di primo livello, modifiche e altro ancora. La tabella seguente elenca le proprietà associate a EIDR e il loro utilizzo.

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

Questa proprietà è disponibile nelle pagine delle 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 Azioni di visualizzazione.
editEIDR Testo Altamente consigliato: un identificatore EIDR (Entertainment Identifier Registry) rappresenta una modifica/edizione specifica per un'opera cinematografica o televisiva.

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

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

La proprietà titleEIDR è obbligatoria quando viene fornita editEIDR.

Vedi Esempio di identificatore/EIDR nella sezione Esempi di feed 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 classificazione deve essere anteposta al valore della classificazione. Esempi:

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

Paese Ente di classificazione 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
Bielorussia (BY) Non disponibile MKRF/RUSSIA
Belgio (BE) Non disponibile MPAA
Belize (BZ) Non disponibile Non disponibile
Benin (BJ) Non disponibile CNC
Bolivia (BO) Non disponibile MPAA
Bosnia ed Erzegovina (BA) Non disponibile MPAA
Botswana (BW) Non disponibile MPAA
Brasile (BR) CLASSIND CLASSIND
Burkina Faso (BF) Non disponibile CNC
Cambogia (KH) Non disponibile Non disponibile
Canada (CA) CA_TV CHVRS
Capo Verde (CV) Non disponibile CCE
Cile (CL) Non disponibile MPAA
Colombia (CO) Non disponibile MPAA
Costarica (CR) Non disponibile MPAA
Croazia (HR) Non disponibile Non disponibile
Cipro (CY) Non disponibile GRFILM
Repubblica Ceca (CZ) Non disponibile CZFILM
Danimarca (DK) Non disponibile MCCYP
Ecuador (EC) Non disponibile MPAA
Egitto (EG) Non disponibile MPAA
El Salvador (SV) Non disponibile MPAA
Estonia (EE) Non disponibile EEFILM
Figi (FJ) Non disponibile Non disponibile
Finlandia (FI) Non disponibile MEKU
Francia (FR) CSA CSA
Gabon (GA) Non disponibile CNC
Germania (DE) FSK FSK
Grecia (GR) ESR GRFILM
Guatemala (GT) Non disponibile MPAA
Haiti (HT) Non disponibile Non disponibile
Honduras (HN) Non disponibile MPAA
Hong Kong (HK) CA FCO
Ungheria (HU) Non disponibile MPAA
Islanda (IS) Non disponibile KIJKWIJZER
India (IN) CBFC CBFC
Indonesia (ID) KPI LSF
Irlanda (IE) Non disponibile IFCO
Italia (IT) AGCOM AGCOM
Costa d'Avorio (CI) Non disponibile CNC
Giamaica (JM) Non disponibile MPAA
Giappone (JP) ND EIRIN
Giordania (JO) Non disponibile MPAA
Kazakistan (KZ) Non disponibile MRKF
Corea (KR) KMRB KMRB
Kuwait (KW) Non disponibile MPAA
Kirghizistan (KG) Non disponibile MKRF/RUSSIA
Laos (LA) Non disponibile Non disponibile
Lettonia (LV) Non disponibile NKCLV
Libano (LB) Non disponibile MPAA
Lituania (LT) Non disponibile Non disponibile
Lussemburgo (LU) Non disponibile KIJKWIJZER
Macedonia (MK) Non disponibile MPAA
Malaysia (MY) Non disponibile FCBM
Mali (ML) Non disponibile CNC
Malta (MT) Non disponibile MCCAA
Mauritius (MU) Non disponibile BBFC
Messico (MX) RTC RTC
Moldavia (MD) Non disponibile Non disponibile
Namibia (NA) Non disponibile Non disponibile
Nepal (NP) Non disponibile MPAA
Paesi Bassi (NL) KIJKWIJZER KIJKWIJZER
Nuova Zelanda (NZ) BSA OFLC
Nicaragua (NI) Non disponibile MPAA
Niger (NE) Non disponibile CNC
Norvegia (NO) Non disponibile MEDIETILSYNET
Oman (OM) Non disponibile MPAA
Panama (PA) Non disponibile MPAA
Papua Nuova Guinea (PG) Non disponibile MPAA
Paraguay (PY) Non disponibile MPAA
Perù (PE) Non disponibile MPAA
Filippine (PH) MTRCB MTRCB
Polonia (PL) Non disponibile MPAA
Portogallo (PT) Non disponibile CCE
Qatar (QA) Non disponibile MPAA
Russia (RU) MKRF/RUSSIA MKRF/RUSSIA
Ruanda (RW) Non disponibile CNC
Arabia Saudita (SA) Non disponibile MPAA
Senegal (SN) Non disponibile MPAA
Singapore (SG) Non disponibile MDA
Slovacchia (SK) Non disponibile MPAA
Slovenia (SI) Non disponibile MPAA
Sudafrica (ZA) FPB FPB
Spagna (ES) SETSI ICAA
Sri Lanka (LK) Non disponibile Non disponibile
Svezia (SE) Non disponibile SMSA
Svizzera (CH) FSK FSK
Taiwan (TW) Non disponibile MOCTW
Tagikistan (TJ) Non disponibile MKRF/RUSSIA
Tanzania (TZ) Non disponibile MPAA
Thailandia (TH) Non disponibile BFVC
Togo (TG) Non disponibile CNC
Trinidad e Tobago (TT) Non disponibile Non disponibile
Turchia (TR) RTÜK ECBMCT
Turkmenistan (TM) Non disponibile MKRF/RUSSIA
Uganda (UG) Non disponibile MPAA
Ucraina (UA) Non disponibile Non disponibile
Emirati Arabi Uniti (AE) Non disponibile MPAA
Regno Unito (GB) BBFC BBFC
Stati Uniti (US) TV_PG MPAA
Uruguay (UY) Non disponibile MPAA
Uzbekistan (UZ) Non disponibile MKRF/RUSSIA
Venezuela (VE) Non disponibile RESORTEVIOLENCIA
Vietnam (VN) Non disponibile MCST
Zambia (ZM) Non disponibile MPAA
Zimbabwe (ZW) Non disponibile MPAA

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: sempre impostato 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 canali e programmi televisivi.
identifier.@type Testo Obbligatorio: sempre impostato su PropertyValue.
identifier.propertyID Testo Obbligatorio: sempre impostato 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 che contiene 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"
    }
  ]
}