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
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
Costa Rica (CR) Non disponibile MPAA
Croazia (HR) Non disponibile Non disponibile
Cipro (CY) Non disponibile GRFILM
Cechia (CZ) Non disponibile CZFILM
Danimarca (DK) Non disponibile MCCYP
Ecuador (CE) 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 (cinese) 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: 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"
    }
  ]
}