Watch Actions proprietà comuni

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

Proprietà di markup delle azioni

Proprietà Tipo previsto Descrizione
@type Testo Obbligatorio - Imposta sempre su WatchAction.
target EntryPoint Obbligatorio: un oggetto target che fornisce il mapping profonda link a varie piattaforme Google.
target.@type Testo Obbligatorio - Imposta sempre su EntryPoint.
target.urlTemplate URL Obbligatorio - A profonda link che indirizza gli utenti alla tua app o piattaforma e avvia la riproduzione dei contenuti.
target.inLanguage Testo Facoltativo - Lingua originale della serie in BCP 47 formato.
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 desktop.
  • http://schema.org/MobileWebPlatform: piattaforma di ricerca su browser web mobile.
  • http://schema.org/AndroidPlatform: Ricerca e Guida di Play su app per Android.
  • http://schema.org/AndroidTVPlatform: Android TV sull'app per Android TV.
  • http://schema.org/IOSPlatform: piattaforma di ricerca su iOS dell'app.
  • http://schema.googleapis.com/GoogleVideoCast: trasmetti e Piattaforme Home su un dispositivo Chromecast.
  • http://schema.googleapis.com/GoogleAudioCast: trasmetti e Piattaforme Home su un dispositivo Chromecast (solo azioni di ascolto).
Consulta le Piattaforma tipi per i requisiti.
target.additionalProperty PropertyValue Obbligatorio se applicabile: un elenco di coppie proprietà-valore da che rappresentano altre proprietà del link diretto. Ecco alcuni esempi: seguenti:
  • contentLanguage: la lingua della trasmissione (doppiaggio), in BCP 47 standard. Se i contenuti sono doppiati in una lingua diversa, questo è obbligatoria. Utilizza un array per più codici lingua.
  • subtitleLanguage: le lingue dei sottotitoli o sottotitoli codificati, in BCP 47 standard. Utilizza un array per più codici lingua.
  • cameraAngle: l'angolazione della videocamera per i contenuti; della Ad esempio, "A livello dell'occhio" e "Angolo alto". Se i contenuti sono disponibili in angolazioni diverse della videocamera. Questa proprietà è obbligatoria. Utilizza un array per diverse angolazioni di ripresa.
  • videoFormat: il formato file utilizzato per memorizzare l'elemento data del video; ad esempio "SD" per definizione standard e "HD" della ad alta definizione. I formati video validi includono SD, HD, 2K, 4K e 8K. Utilizza un array per più formati video.
Consulta le additionalProperty esempio.
actionAccessibilityRequirement ActionAccessSpecification Obbligatorio - Un'azione accesso specifico che descrive il requisito di accesso di dei contenuti. Vedi Azione Accedi alle proprietà della specifica.

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

Proprietà della specifica di accesso all'azione

Proprietà Tipo previsto Descrizione
actionAccessibilityRequirement.@type Testo Obbligatorio - Imposta sempre su ActionAccessSpecification.
actionAccessibilityRequirement.category Testo

Obbligatorio: un requisito di accesso ai contenuti. Per maggiori informazioni le informazioni, vedi Tipo di paywall.

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

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

  • La data può essere impostata nel futuro.

È necessario che l'entità corrispondente sia fornita nel feed all'indirizzo almeno 7 giorni prima della data di disponibilità Data di inizio. In questo modo migliorerai probabilità che i contenuti vengano visualizzati in tempo sulle piattaforme Google.

actionAccessibilityRequirement.availabilityEnds Data Obbligatorio: data dopo la quale l'azione non è più disponibile. in 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 questo sia di 20 anni dalla data corrente.

È obbligatorio che gli aggiornamenti alla data di disponibilitàEnds vengano apportati nel feed almeno 7 giorni prima della data di fine della disponibilità. Questo aumentano le probabilità che i contenuti non vengano più visualizzati su Google vengono visualizzate nella data di disponibilità.

actionAccessibilityRequirement.eligibleRegion Paese, Città, Stato, GeoShape oppure Testo Obbligatorio: le regioni in cui sono disponibili i contenuti. Utilizza la stringa speciale EARTH se i contenuti sono disponibili a livello globale.
actionAccessibilityRequirement.ineligibleRegion Paese, Città, Stato oppure GeoShape Obbligatorio se applicabile: regioni in cui i contenuti vengono limitato. Non è necessario fornire questa proprietà se i contenuti sono disponibile ovunque all'interno di eligibleRegion.
actionAccessibilityRequirement.requiresSubscription MediaSubscription

Obbligatorio se applicabile: i dettagli del abbonamento richiesto agli utenti per accedere ai contenuti. Consulta Proprietà degli abbonamenti multimediali.

  • Fornisci questa proprietà se category è subscription o externalSubscription.
actionAccessibilityRequirement.expectsAcceptanceOf Offerta Obbligatorio se i contenuti richiedono un acquisto: i dettagli dei 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 sottoscrittori (subscription o externalsubscription)
Se il prezzo è 0,00, rimuovi completamente l'oggetto Offer e imposta category dall'oggetto ActionAccessSpecification su free. Consulta Proprietà dell'offerta.

Proprietà delle sottoscrizioni multimediali

Obbligatorio se actionAccessibilityRequirement.category è subscription o externalSubscription.

Proprietà Tipo previsto Descrizione
requiresSubscription.@type Testo Obbligatorio - Imposta sempre su MediaSubscription
requiresSubscription.@id URL Obbligatorio: l'ID univoco dell'abbonamento. Se i contenuti è accessibile 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 tuo sistema di autenticazione utente. Per 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, usa PKG1.
  • Per i provider TVE, si tratta del nome dell'autenticatore registrato con il tuo autenticatore TVE. È una stringa che identifica in modo univoco con TVE Authenticator.
requiresSubscription.sameAs URL La pagina che descrive l'abbonamento.
requiresSubscription.identifier Testo Obbligatorio se category è subscription AND commonTier è false - Una stringa univoca per questa sottoscrizione 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:sport
  • Questa proprietà sarà uguale alla tua identificatore del diritto se fornisci un'API dei diritti
requiresSubscription.authenticator Organizzazione Obbligatorio se category è externalsubscription: un container che fornisce il parametro i dettagli dell'autenticatore del provider esterno.
requiresSubscription.authenticator.@type Testo Obbligatorio se category è externalsubscription - Imposta sempre su Organization.
requiresSubscription.authenticator.name Testo Obbligatorio se category è externalsubscription: il nome dell'autenticazione completamente gestito di Google Cloud. Per i fornitori di TVE, imposta il valore su TVE
requiresSubscription.commonTier Valore booleano Obbligatorio se applicabile: questo campo è obbligatorio se la categoria è impostata su abbonamento. Scopri di più su CommonTier nel comune sui requisiti dei livelli di assistenza.

Requisiti dell'API Entitlements

Un'API entitlement è obbligatorio se actionAccessibilityRequirement.category è subscription o externalSubscription e la tua offerta di abbonamento include più di pacchetti o livelli oppure prevede l'assistenza di componenti aggiuntivi. Non includerlo se le tue abbonamento è a un livello e dà accesso a tutti i contenuti del catalogo.

  • L'azienda A ha una singola offerta di abbonamento che offre agli utenti abbonati accesso a tutti i contenuti disponibili: l'identificatore del diritto / l'API non obbligatorio
  • L'Azienda B ha un abbonamento di base che fornisce accesso ad alcuni contenuti e un abbonamento premium che dà accesso a contenuti premium: Identificatore / API obbligatorio
  • L'Azienda C ha un abbonamento di base che fornisce accesso ad alcuni contenuti e componenti aggiuntivi che forniscono accesso a contenuti di terze parti: L'ID diritto / l'API è obbligatoria

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

Proprietà dell'offerta

Proprietà Tipo previsto Descrizione
expectsAcceptanceOf.@type Testo Obbligatorio - Imposta 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 "senza costi".
expectsAcceptanceOf.priceCurrency Testo Obbligatorio: la valuta del prezzo a tre lettere ISO 4217.
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 sulla home page del venditore.

Pagina correlata all'offerta

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

Identificatori

I feed di azione multimediale accettano una serie di identificatori che possono aiutare a identificare un in modo non ambiguo. Questi identificatori possono aiutare ad accelerare di riconciliazione dei contenuti del feed con i contenuti dell'account di Google o Microsoft SQL Server. La maggior parte di questi identificatori può essere aggiunta al feed utilizzando Proprietà identifier su vari tipi di entità, gli EIDR hanno una propria una proprietà rappresentativa. Di seguito vengono descritti entrambi questi aspetti.

Proprietà dell'identificatore

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

Questa proprietà è disponibile per tutti i tipi di entità Watch Action.

La tabella seguente elenca gli identificatori e le proprietà secondarie accettati della proprietà identifier. Consulta la sezione Esempio di identificatore/EIDR nella sezione degli esempi di feed per le azioni di visualizzazione.
Proprietà Tipo previsto Descrizione
@type Testo Obbligatorio - Imposta sempre su PropertyValue.
propertyID Testo Obbligatorio - Sono supportati i seguenti tipi di ID:
    .
  • TMS_ROOT_ID: l'ID root Gracenote (TMS), ad esempio 15829).
    • di Google. Questo non è applicabile all'organizzazione. Entità 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 esempio, Q134773).
  • IMDB_ID: l'ID IMDB (ad esempio, tt0109830).
  • OPTA_ID: l'ID sport OPTA.
  • STATS_ID: l'ID esecuzione delle STATS.
  • VIP_TIMES_ID: l'ID VIPTimes del Giappone (Nihon Tarento Meikan) per i talenti giapponesi.
  • DMA_ID: il prefisso designato degli Stati Uniti, utilizzato in 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 identificazione univoco a livello globale per una vasta 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. 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, a 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 di un film noto come "Ghostbusters" è "10.5240/7EC7-228A-510A-053E-CBB8-J".

Vedi Esempio di identificatore/EIDR nella sezione degli esempi di feed Azioni dell'orologio.
editEIDR Testo Altamente consigliato: un identificatore EIDR (Entertainment Identifier Registry) rappresenta un montaggio/un'edizione specifica di un'opera cinematografica o televisiva.

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

Ad esempio, il film "Ghostbusters" il cui titolo EIDR è "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".

titleEIDR è obbligatoria quando viene fornito editEIDR.

Consulta Esempio di identificatore/EIDR nella sezione degli esempi di feed per le 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 come "R" negli Stati Uniti dovrebbe avere un valore Movie.contentRating pari a "MPAA R".
  • Una serie TV classificata come "TV-MA" negli Stati Uniti dovrebbe avere un valore TVSeries.contentRating di "TVPG TV-MA".

Paese Agenzia di classificazione TV Agenzia di valutazione 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) TV ACB Film 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) CLASSE CLASSE
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
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 del Nord 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
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 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 - Imposta sempre su GeoShape.
addressCountry Testo Obbligatorio: le due lettere ISO 3166-1 alpha-2 codice paese.
postalCode Testo Facoltativo - Elenco di uno o più codici postali e/o codici FSA (Forward Sortation Area).
identifier PropertyValue Facoltativo - A ID DMA (Designated Market Area, area di mercato designata), che è un identificatore di una regione negli Stati Uniti in cui le persone ricevono l' gli stessi canali e programmi televisivi.
identifier.@type Testo Obbligatorio - Imposta sempre su PropertyValue.
identifier.propertyID Testo Obbligatorio - Imposta sempre su DMA_ID.
identifier.value Testo Obbligatorio: il codice DMA della 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 codici postali e FSA (forward Sortation Area):

{
  "@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"
    }
  ]
}