Guarda le azioni comuni delle azioni

In questa sezione vengono forniti i dettagli delle proprietà comuni delle azioni di visualizzazione.

Proprietà del markup delle azioni

Proprietà Tipo previsto Descrizione
@type Testo Obbligatorio: sempre impostato su WatchAction.
target Ingresso Obbligatorio: un oggetto di destinazione che fornisce la mappatura di link diretti 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 alla tua 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. Le azioni multimediali supportano le seguenti funzionalità:
  • http://schema.org/DesktopWebPlatform: piattaforma di ricerca sui browser web per desktop.
  • http://schema.org/MobileWebPlatform: piattaforma di ricerca sui browser web per dispositivi mobili.
  • http://schema.org/AndroidPlatform: piattaforme di ricerca e PlayGuide sull'app Android.
  • http://schema.org/AndroidTVPlatform: piattaforma Android TV sull'app Android TV.
  • http://schema.org/IOSPlatform: piattaforma di ricerca sull'app per iOS.
  • http://schema.googleapis.com/GoogleVideoCast: piattaforme Google Cast e Home su un dispositivo Chromecast.
  • http://schema.googleapis.com/GoogleAudioCast: piattaforme Google Cast e Home su un dispositivo Chromecast (solo per le azioni di ascolto).
Consulta la sezione Tipi di piattaforma per conoscere i requisiti.
target.additionalProperty PropertyValue Obbligatorio se applicabile: un elenco di coppie di proprietà-valore per rappresentare proprietà aggiuntive del link diretto. che possono includere:
  • contentLanguage: la lingua di trasmissione (dub), in 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 in formato BCP 47 . Utilizza un array per più codici lingua.
  • cameraAngle: l'angolazione della videocamera per i contenuti, ad esempio "Livello degli occhi" e "Angolo elevato". Se i contenuti sono disponibili con diverse angolazioni della videocamera, questa proprietà è obbligatoria. Utilizza un array per più angolazioni della videocamera.
  • videoFormat: il formato 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.
Vedi l'esempio di additionalProperty.
actionAccessibilityRequirement AzioneAccessoSpecifica Obbligatorio: un oggetto della specifica di accesso per le azioni che descrive il requisito di accesso dei contenuti. Consulta la pagina relativa alle proprietà della specifica di accesso alle azioni.

Controlla gli argomenti correlati a queste proprietà nelle pagine seguenti:

Proprietà specifiche di accesso azioni

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 la pagina Tipo di paywall.

Se un'entità rappresenta un gruppo di contenuti, devi impostare category sul requisito di accesso meno restrittivo dei relativi 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 in futuro.

È necessario fornire l'entità corrispondente nel feed con almeno 7 giorni di anticipo rispetto alla data in cui inizia la disponibilità. Ciò migliorerà le probabilità che i contenuti vengano visualizzati sulle piattaforme Google in tempo.

actionAccessibilityRequirement.availabilityEnds Data Obbligatorio: data dopo la quale l'azione non è più disponibile, in 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.

È necessario aggiornare la data di disponibilità nel feed almeno sette giorni prima di tale data. Ciò aumenterà le probabilità che i contenuti cessano di essere pubblicati sulle piattaforme Google alla data di fine della disponibilità.

actionAccessibilityRequirement.eligibleRegion Paese, Città, Stato, GeoShape o Testo Obbligatorio: le aree geografiche in cui i contenuti sono disponibili. Utilizza la stringa speciale EARTH se i contenuti sono disponibili a livello globale.
actionAccessibilityRequirement.ineligibleRegion Paese, Città, Stato o GeoShape Obbligatorio se applicabile: aree geografiche 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 Abbonamento multimediale

Obbligatorio se applicabile: i dettagli dell'abbonamento necessario agli utenti per accedere ai contenuti. Consulta la pagina 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 di acquisto una tantum (rental o purchase)
  • Contenuti basati su 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 dall'oggetto ActionAccessSpecification su free. Consulta la pagina Proprietà dell'offerta.

Proprietà degli abbonamenti 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, il nome deve corrispondere al nome nel sistema di autenticazione dell'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 provider TVE, questo è il nome dell'autenticatore registrato presso il tuo autenticatore TVE. Si tratta di una stringa che identifica in modo univoco il nome del tuo servizio con TVE Authenticator.
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:basic, example.com:premium, example.com:sports
  • Questa proprietà sarà la stessa del tuo identificatore di diritto se fornisci un'API relative ai diritti
requiresSubscription.authenticator Organizzazione Obbligatorio se category è externalsubscription - Un container che fornisce i dettagli dell'autenticatore 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 Booleano Obbligatorio se applicabile: obbligatorio se la categoria è impostata sull'abbonamento. Scopri di più sul CommonTier nella documentazione relativa ai requisiti di livello comune.

Requisiti dell'API Entitlements

È necessaria un'API Entitlement se actionAccessibilityRequirement.category è subscription o externalSubscription e la tua offerta di abbonamento include più pacchetti o livelli o ha supporto aggiuntivo. Non includerlo se il tuo abbonamento è a più livelli e dà accesso a tutti i contenuti del tuo catalogo.

  • L'azienda A ha un'unica offerta di abbonamento che offre agli utenti abbonati l'accesso a tutti i contenuti disponibili: l'identificatore / diritto dell'API non è richiesto
  • La società B ha un abbonamento di base che fornisce l'accesso ad alcuni contenuti e un abbonamento premium che fornisce l'accesso ai contenuti premium: Identificatore del diritto / API obbligatoria
  • L'azienda C ha un abbonamento di base che fornisce accesso ad alcuni contenuti e aggiunge pacchetti che consentono di accedere a contenuti di terze parti: l'identificatore del diritto/l'API è obbligatorio

Controlla gli argomenti correlati a queste proprietà nelle pagine seguenti:

Proprietà di 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 diverso da zero. Per le entità con prezzo pari a 0,00, specifica la categoria "senza costi".
expectsAcceptanceOf.priceCurrency Testo Obbligatorio: la valuta del prezzo in formato ISO 4217 di tre lettere.
expectsAcceptanceOf.seller Organizzazione L'organizzazione che offre l'acquisto di contenuti.
expectsAcceptanceOf.seller.@type Testo Imposta sempre 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

Controlla gli argomenti correlati a queste proprietà nelle pagine seguenti:

Identificatori

I feed di azioni multimediali accettano vari identificatori che possono aiutare a identificare un'entità in modo univoco. Questi identificatori possono aiutarti ad accelerare il processo di riconciliazione dei contenuti nel tuo feed con i contenuti nei database di Google. La maggior parte di questi identificatori può essere aggiunta al feed utilizzando la proprietà identifier su vari tipi di entità, ma gli EIDR hanno una propria proprietà rappresentativa. Entrambe le opzioni sono illustrate di seguito.

Proprietà degli identificatori

Proprietà Tipo previsto Descrizione
identifier Testo Altamente consigliato: un identificatore, solitamente 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 degli esempi del feed di azioni di visualizzazione.
Proprietà Tipo previsto Descrizione
@type Testo Obbligatorio: sempre impostato su PropertyValue.
propertyID Testo Obbligatorio: sono supportati i seguenti tipi di ID:
  • TMS_ROOT_ID: l'ID root di Gracenote (TMS), ad esempio 15829.
    • . Questo non è applicabile alle entità Organization e BroadcastService in cui deve essere utilizzato solo TMS_ID.
  • TMS_ID: l'ID variante di 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 dello sport sportivo OPTA.
  • STATS_ID: l'ID dello stato.
  • VIP_TIMES_ID: ID del Giappone VIPTimes (Nihon Tarento Meikan) per talenti giapponesi.
  • DMA_ID: il prefisso dell'area di marketing designata degli Stati Uniti, usato nell'oggetto GeoShape.
  • _PARTNER_ID_: questa proprietà deve contenere la stringa "_PARTNER_ID_", il valore deve essere un ID univoco utilizzato da un provider 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 ID specificato.

Proprietà EIDR

EIDR (abbreviazione di The Entertainment Identifier Registry), un sistema di identificazione univoco 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 ai titoli, alle modifiche e altro ancora di primo livello. Nella tabella seguente sono elencate le proprietà associate all'EIDR e il relativo utilizzo.

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

Questa proprietà è disponibile nelle pagine di specifica delle entità relative a TVSeries, TVSeason, TVEpisode e Film.

Ad esempio, il titolo titleEIDR per l'immagine in movimento noto come "Ghostbusters" è "10.5240/7EC7-228A-510A-053E-CBB8-J".

Vedi l'ID sezione Esempio nella sezione Osservatore/EIDR{/10
editEIDR Testo Altamente consigliato. Un identificatore EIDR (Entertainment Identifier Registry) rappresenta una specifica modifica/edizione di un'opera cinematografica o televisiva.

Questa proprietà è disponibile sulle pagine con la specifica dell'entità TVEpisode e Movie.

Ad esempio, il film noto come "Ghostbusters", il cui titolo EIDR è "10.5240/7EC7-228A-510A-053E-CBB8-J", contiene più modifiche, ad esempio "10.5240-1-1-1-1-1-1-1-1-1-1-1-010101-2017-2011-1-2018-1-2015-2015-2015-2015-2015,01, 201, 201, 201, 201, 201 soltanto dell':

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 valutazione. Esempi:

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

Paese Agenzia di valutazione televisiva Agenzia di classificazione film
Albania (AL) Non disponibile Non disponibile
Angola (AO) Non disponibile CEC
Antigua e Barbuda (AG) Non disponibile MPAA
Argentina (AR) Inca Inca
Armenia (AM) Non disponibile MKRF/RUSSIA
Aruba (AW) Non disponibile Non disponibile
Australia (AU) TV Ab Film dell'ACB
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) CLASSIFICAZIONE CLASSIFICAZIONE
Burkina Faso (BF) Non disponibile CNC
Cambogia (KH) Non disponibile Non disponibile
Canada (CA) CA_TV CHVR
Capo Verde (CV) Non disponibile CEC
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 GRAFICO
Cechia (CZ) Non disponibile CZFILM
Danimarca (DK) Non disponibile Centro clienti
Ecuador (CE) Non disponibile MPAA
Egitto (EG) Non disponibile MPAA
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) SRL GRAFICO
Guatemala (GT) Non disponibile MPAA
Haiti (HT) Non disponibile Non disponibile
Honduras 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 Non disponibile CNC
Giamaica (JM) Non disponibile MPAA
Giappone (JP) N/D 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 (America Latina) 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 del Nord Non disponibile MPAA
Malaysia (MY) Non disponibile FCBM
Mali (ML) Non disponibile CNC
Malta (MT) Non disponibile Centro clienti
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
Nigeria Non disponibile CNC
Norvegia (NO) Non disponibile MEDIETILSYNET
Oman (OM) Non disponibile MPAA
Panamá (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 CEC
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 ICA
Sri Lanka (LK) Non disponibile Non disponibile
Svezia (SE) Non disponibile SMSA
Svizzera (CH) FSK FSK
Taiwan (TW) Non disponibile MODA
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) Logo 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) (solo canali a pagamento) 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 alpha-2 nel formato ISO 3166-1 di due lettere.
postalCode Testo Facoltativo: elenco di uno o più codici postali e/o FSA (area di ordinamento anticipato).
identifier PropertyValue Facoltativo: un ID Designated Market Area (DMA), che è un identificatore di una regione negli 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 (area di ordinamento diretto) 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"
    }
  ]
}