Questa pagina fornisce informazioni sui documenti e sugli archivi di dati per i contenuti multimediali. Se utilizzi i suggerimenti sui contenuti multimediali o la ricerca di contenuti multimediali, esamina i requisiti dello schema per i documenti e i datastore in questa pagina prima di caricare i dati.
Panoramica
Un documento è qualsiasi elemento che carichi in un datastore di AI Applications. Per
i contenuti multimediali, un documento in genere contiene informazioni sui metadati dei contenuti multimediali,
come video, articoli di notizie, file musicali o podcast. L'oggetto Document
nell'API acquisisce queste informazioni sui metadati.
Il tuo datastore contiene una raccolta di documenti che hai caricato. Quando
crei un datastore, specifichi che conterrà documenti multimediali. I datastore
per i contenuti multimediali possono essere collegati solo ad app multimediali, non ad altri tipi di app
come la ricerca personalizzata e i consigli. I datastore sono rappresentati nell'API dalla risorsa DataStore
.
La qualità dei dati che carichi ha un effetto diretto sulla qualità dei risultati forniti dalle app multimediali. In generale, più accurate e specifiche sono le informazioni che fornisci, migliore sarà la qualità dei risultati.
I dati che carichi nel datastore devono essere formattati in uno schema JSON specifico. I dati disposti in questo schema devono trovarsi in una tabella BigQuery, in un file o in un insieme di file in Cloud Storage oppure in un oggetto JSON che può essere caricato direttamente utilizzando la console Google Cloud .
Schema predefinito di Google e schema personalizzato
Sono disponibili due opzioni per lo schema dei dati multimediali:
Lo schema predefinito di Google. Se non hai ancora progettato uno schema per i tuoi dati multimediali, lo schema predefinito di Google è una buona scelta.
Il tuo schema. Se i dati sono già formattati in uno schema, puoi utilizzare il tuo schema. Per saperne di più, consulta la sezione Schema personalizzato di seguito.
Con entrambe le opzioni, puoi aggiungere campi allo schema dopo l'importazione iniziale dei dati. Tuttavia, con lo schema predefinito di Google, per l'importazione iniziale, i nomi e i tipi dei campi di dati devono corrispondere esattamente a quelli delle tabelle Campi del documento.
Proprietà chiave
Le proprietà vengono utilizzate per addestrare i modelli per la ricerca e i suggerimenti. I campi della proprietà rappresentano tutti i campi dello schema.
Le proprietà chiave sono un insieme fisso speciale di proprietà nello schema Google. Le proprietà della chiave identificano informazioni importanti utilizzate per comprendere i significati semantici dei dati.
Se utilizzi uno schema personalizzato, assicurati di mappare i campi al maggior numero possibile di proprietà chiave. Esegui il mapping nella console Google Cloud dopo aver importato i dati. Vedi Creare un datastore di contenuti multimediali.
Schema JSON predefinito di Google per Document
Quando utilizzi contenuti multimediali, i documenti possono utilizzare lo schema JSON predefinito di Google per i contenuti multimediali.
I documenti vengono caricati con una rappresentazione dei dati JSON o Struct. Assicurati che il JSON o lo struct del documento sia conforme al seguente schema JSON. Lo schema JSON utilizza JSON Schema 2020-12 per la convalida. Per saperne di più su JSON Schema, consulta anche la documentazione delle specifiche di JSON Schema su json-schema.org.
{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "title": { "type": "string", }, "description": { "type": "string", }, "media_type": { "type": "string", }, "language_code": { "type": "string", }, "categories": { "type": "array", "items": { "type": "string", } }, "uri": { "type": "string", }, "images": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string", }, "name": { "type": "string", } }, } }, "in_languages": { "type": "array", "items": { "type": "string", } }, "country_of_origin": { "type": "string", }, "transcript": { "type": "string", }, "content_index": { "type": "integer", }, "persons": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", }, "role": { "type": "string", }, "custom_role": { "type": "string", }, "rank": { "type": "integer", }, "uri": { "type": "string", } }, "required": ["name", "role"], } }, "organizations": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", }, "role": { "type": "string", }, "custom_role": { "type": "string", }, "rank": { "type": "integer", }, "uri": { "type": "string", } }, "required": ["name", "role"], } }, "hash_tags": { "type": "array", "items": { "type": "string", } }, "filter_tags": { "type": "array", "items": { "type": "string", } }, "duration": { "type": "string", }, "content_rating": { "type": "array", "items": { "type": "string", } }, "aggregate_ratings": { "type": "array", "items": { "type": "object", "properties": { "rating_source": { "type": "string", }, "rating_score": { "type": "number", }, "rating_count": { "type": "integer", } }, "required": ["rating_source"], } }, "available_time": { "type": "datetime", }, "expire_time": { "type": "datetime", }, "live_event_start_time": { "type": "datetime", }, "live_event_end_time": { "type": "datetime", }, "production_year": { "type": "integer", } }, "required": ["title", "categories", "uri", "available_time"], }
Oggetto JSON Document
di esempio
L'esempio seguente mostra un esempio di oggetto JSON Document
.
{ "title": "Test document title", "description": "Test document description", "media_type": "sports-game", "in_languages": [ "en-US" ], "language_code": "en-US", "categories": [ "sports > clip", "sports > highlight" ], "uri": "http://www.example.com", "images": [ { "uri": "http://example.com/img1", "name": "image_1" } ], "country_of_origin": "US", "content_index": 0, "transcript": "Test document transcript", "persons": [ { "name": "sports person", "role": "player", "rank": 0, "uri": "http://example.com/person" }, ], "organizations": [ { "name": "sports team", "role": "team", "rank": 0, "uri": "http://example.com/team" }, ], "hash_tags": [ "tag1" ], "filter_tags": [ "filter_tag" ], "duration": "100s", "production_year": 1900, "content_rating": [ "PG-13" ], "aggregate_ratings": [ { "rating_source": "imdb", "rating_score": 4.5, "rating_count": 1250 } ], "available_time": "2022-08-26T23:00:17Z" }
Campi documento
Questa sezione elenca i valori dei campi che fornisci quando crei documenti per il tuo datastore. I valori devono corrispondere a quelli utilizzati nel tuo database di documenti interno e devono riflettere con precisione l'articolo rappresentato.
Document
campi oggetto
I seguenti campi sono campi di primo livello per l'oggetto Document
. Fai riferimento anche
a questi campi nella pagina di riferimento Document
.
Nome campo | Note |
---|---|
name
|
Il nome completo e univoco della risorsa del documento. Obbligatorio per tutti i metodi
Document , ad eccezione di create e
import . Durante l'importazione, il nome viene generato automaticamente
e non deve essere fornito manualmente.
|
id
|
L'ID documento utilizzato dal tuo database interno. Il campo ID deve
essere univoco nell'intero datastore. Lo stesso valore viene utilizzato quando
registri un evento utente e viene restituito anche dai metodi recommend
e search .
|
schemaId
|
Obbligatorio. L'identificatore dello schema che si trova nello stesso datastore. Deve essere impostato come "default_schema", che viene creato automaticamente quando viene creato l'datastorei predefinito. |
parentDocumentId
|
L'ID del documento principale. Per i documenti di primo livello (radice),
parent_document_id può essere vuoto o puntare a se stesso. Per i documenti secondari, parent_document_id deve puntare a un documento principale valido.
|
Campi della proprietà
I seguenti campi sono definiti utilizzando il formato JSON Schema predefinito per i contenuti multimediali.
Per ulteriori informazioni sulle proprietà JSON, consulta la documentazione Understanding JSON Schema per le proprietà su json-schema.org.
La tabella seguente definisce i campi non strutturati
Nome campo | Note |
---|---|
title
|
Stringa - obbligatorio Il titolo del documento dal tuo database. Una stringa codificata UTF-8. Limite di 1000 caratteri. |
categories
|
Stringa - obbligatorio Categorie di documenti. Questa proprietà viene ripetuta per supportare un documento appartenente a diverse categorie parallele. Utilizza il percorso completo della categoria per risultati di qualità superiore.
Per rappresentare il percorso completo di una categoria, utilizza il simbolo Ad esempio:
Un documento può contenere al massimo 250 categorie. Ogni categoria è una stringa codificata UTF-8 con un limite di lunghezza di 5000 caratteri. |
uri
|
Stringa - obbligatorio URI del documento. Limite di lunghezza di 5000 caratteri. |
description
|
Stringa (altamente consigliato) Descrizione del documento. Limite di lunghezza di 5000 caratteri. |
media_type
|
Stringa: questo campo è obbligatorio per film e programmi Categoria di primo livello.
Tipi supportati:
I valori |
language_code
|
Stringa (facoltativo) Lingua del titolo/della descrizione e di altri attributi stringa. Utilizza i tag lingua definiti da BCP 47. Per i suggerimenti di documenti, questo campo viene ignorato e la lingua del testo viene rilevata automaticamente. Il documento può includere testo in lingue diverse, ma la duplicazione dei documenti per fornire testo in più lingue può comportare un peggioramento delle prestazioni.
Per la ricerca di documenti, questo campo è in uso. Se non viene impostato, il valore predefinito è "en-US".
Ad esempio, |
duration
|
Stringa: obbligatoria per le app di suggerimenti sui contenuti multimediali in cui l'obiettivo commerciale è il tasso di conversione (CVR) o la durata di visualizzazione per sessione.
Durata dei contenuti multimediali. La durata deve essere codificata come stringa.
La codifica deve essere la stessa della codifica della stringa JSON. |
available_time
|
Data/ora - obbligatorio Il periodo di tempo durante il quale i contenuti sono disponibili per gli utenti finali. Questo campo identifica l'aggiornamento di un contenuto per gli utenti finali. Il timestamp deve essere conforme allo standard RFC 3339. Ad esempio:
Per filtrare in base alla disponibilità, consulta Filtrare i consigli e Filtrare in base ai documenti disponibili. |
expire_time
|
Data/ora - facoltativo L'ora in cui i contenuti scadranno per gli utenti finali. Questo campo identifica l'aggiornamento di un contenuto per gli utenti finali. Il timestamp deve essere conforme allo standard RFC 3339. Ad esempio:
Per escludere i documenti scaduti dai risultati, vedi Filtrare i suggerimenti e Filtrare la ricerca di contenuti multimediali. |
live_event_start_time
|
Data/ora - facoltativo L'ora in cui inizia l'evento live. Il timestamp deve essere conforme allo standard RFC 3339. Ad esempio:
|
live_event_end_time
|
Data/ora - facoltativo L'ora in cui termina l'evento live. Il timestamp deve essere conforme allo standard RFC 3339. Ad esempio:
|
in_languages
|
Stringa - facoltativa - ripetuta La lingua dei contenuti multimediali. Utilizza i tag di lingua definiti da BCP 47.
Ad esempio: |
country_of_origin
|
Stringa (facoltativo) Paese di origine del documento multimediale. Limite di lunghezza di 128 caratteri.
Ad esempio: |
transcript
|
Stringa (facoltativo) Trascrizione del documento multimediale. |
content_index
|
Numero intero - facoltativo Indice dei contenuti del documento multimediale. Il campo Indice dei contenuti può essere utilizzato per ordinare i documenti rispetto agli altri. Ad esempio, il numero dell'episodio può essere utilizzato come indice dei contenuti. L'indice dei contenuti deve essere un numero intero non negativo.
Ad esempio: |
filter_tags
|
Stringa - facoltativa - ripetuta Filtra i tag per il documento. Sono consentiti al massimo 250 valori per documento con un limite di lunghezza di 1000 caratteri. In caso contrario, viene restituito un errore INVALID_ARGUMENT.
Questi tag possono essere utilizzati per filtrare i risultati di ricerca e i consigli. Per filtrare i risultati dei consigli, trasmetti i tag come parte di
Ad esempio: |
hash_tags
|
Stringa - facoltativa - ripetuta Hashtag per il documento. Sono consentiti al massimo 100 valori per documento, con un limite di lunghezza di 5000 caratteri.
Ad esempio: |
production_year
|
Numero intero - facoltativo L'anno in cui è stato prodotto il contenuto multimediale. |
content_rating
|
Stringa - facoltativa - ripetuta La classificazione dei contenuti, utilizzata per i sistemi di avviso sui contenuti e il filtro dei contenuti in base al pubblico. Sono consentiti al massimo 100 valori per documento con un limite di lunghezza di 128 caratteri.
Questo tag può essere utilizzato per filtrare i risultati dei consigli passando il
tag come parte di
Ad esempio: |
La tabella seguente definisce i campi gerarchici.
Nome campo | Note |
---|---|
images
|
Oggetto - facoltativo - ripetuto Proprietà chiave principale per l'incapsulamento delle proprietà correlate alle immagini. |
images.uri
|
Stringa (facoltativo) L'URI dell'immagine. Limite di lunghezza di 5000 caratteri. |
images.name
|
Stringa (facoltativo) Nome dell'immagine. Limite di lunghezza di 128 caratteri. |
persons
|
Oggetto - facoltativo - ripetuto Proprietà chiave principale per l'incapsulamento delle proprietà correlate alla persona.
Ad esempio:
|
persons.name
|
Stringa - obbligatorio Nome della persona. |
persons.role
|
Stringa - obbligatorio Il ruolo della persona nell'elemento multimediale. Valori supportati: director, actor, player, team, league, editor, author, character, contributor, creator, editor, funder, producer, provider, publisher, sponsor, translator, music-by, channel, custom-role
Se a |
persons.custom_role
|
Stringa (facoltativo)
|
persons.rank
|
Numero intero - facoltativo
Utilizzato per la classificazione dei ruoli. Ad esempio, per il primo attore,
|
persons.uri
|
Stringa (facoltativo) URI della persona. |
organizations
|
Oggetto - facoltativo - ripetuto
Proprietà della chiave principale per l'incapsulamento delle proprietà
relative a
Ad esempio:
|
organizations.name
|
Stringa - obbligatorio Nome dell'organizzazione. |
organizations.role
|
Stringa - obbligatorio Il ruolo dell'organizzazione nell'elemento multimediale. Valori supportati: director, actor, player, team, league, editor, author, character, contributor, creator, editor, funder, producer, provider, publisher, sponsor, translator, music-by, channel, custom-role
Se a |
organizations.custom_role
|
Stringa (facoltativo)
|
organizations.rank
|
Stringa (facoltativo)
Utilizzato per la classificazione dei ruoli. Ad esempio, per il primo editore:
|
organizations.uri
|
Stringa (facoltativo) URI dell'organizzazione. |
aggregate_ratings
|
Oggetto - facoltativo - ripetuto
Proprietà della chiave principale per incapsulare le
proprietà correlate |
aggregate_ratings.rating_source
|
Stringa - obbligatorio
L'origine della classificazione. Ad esempio, |
aggregate_ratings.rating_score
|
Doppio - obbligatorio La valutazione aggregata. La valutazione deve essere normalizzata nell'intervallo [1, 5]. |
aggregate_ratings.rating_count
|
Numero intero - facoltativo Il numero di recensioni individuali. Deve essere un valore non negativo. |
Livelli del documento
I livelli del documento determinano la gerarchia nel datastore. In genere, devi avere un datastore a un solo livello o a due livelli. Sono supportati solo due livelli.
Ad esempio, puoi avere un datastore a un solo livello in cui ogni documento è un singolo elemento. In alternativa, puoi scegliere un datastore a due livelli che contiene sia gruppi di elementi sia singoli elementi.
Tipi a livello di documento
Esistono due tipi di livello del documento:
Genitore. I documenti principali sono quelli che Vertex AI Search
ritorni nei consigli e nelle ricerche. I documenti genitore possono essere singoli documenti o gruppi di documenti simili. Questo tipo di livello è consigliato.
Bambino. I documenti secondari sono versioni del documento principale di un gruppo. I documenti dei bambini possono essere solo individuali. Ad esempio, se il documento principale è "Example TV Show", i documenti secondari potrebbero essere "Episode 1" e "Episode 2". Questo tipo di livello può essere difficile da configurare e gestire e non è consigliato.
Informazioni sulla gerarchia del datastore
Quando pianifichi la gerarchia del datastore, decidi se deve contenere solo i genitori o i genitori e i figli. Il punto chiave da ricordare è che i suggerimenti e le ricerche restituiscono solo i documenti principali.
Ad esempio, un datastore solo per i genitori potrebbe funzionare bene per gli audiolibri, dove un pannello dei consigli restituisce una selezione di singoli audiolibri. D'altra parte, se hai caricato episodi di programmi TV come documenti principali in un archivio dati solo per i genitori, nello stesso riquadro potrebbero essere consigliati diversi episodi fuori ordine.
Un datastore di programmi TV potrebbe funzionare sia con i genitori che con i figli, dove ogni documento padre rappresenta un programma TV con documenti figlio che rappresentano gli episodi di quel programma TV. Questo datastore a due livelli consente al pannello dei consigli di mostrare una serie di programmi TV simili. L'utente finale può fare clic su un programma specifico per selezionare un episodio da guardare.
Poiché le gerarchie padre-figlio possono essere difficili da configurare e gestire, sono consigliati i datastore solo padre.
Ad esempio, un datastore di programmi TV può funzionare bene come datastore solo padre in cui ogni documento padre rappresenta un programma TV che può essere consigliato e i singoli episodi non sono inclusi (e quindi non consigliati).
Se determini che il tuo datastore deve contenere sia genitori che figli, ovvero gruppi e singoli elementi, ma al momento hai solo singoli elementi, devi creare i genitori per i gruppi. Le informazioni minime che devi fornire per un genitore sono id
, title
e categories
. Per saperne di più, consulta la sezione Campi del documento.
Schema BigQuery per i contenuti multimediali
Se prevedi di importare i documenti da BigQuery, utilizza lo schema BigQuery predefinito per creare una tabella BigQuery con il formato corretto e caricala con i dati dei documenti prima di importare i documenti.
[ { "name": "id", "mode": "REQUIRED", "type": "STRING", "fields": [] }, { "name": "schemaId", "mode": "REQUIRED", "type": "STRING", "fields": [] }, { "name": "parentDocumentId", "mode": "NULLABLE", "type": "STRING", "fields": [] }, { "name": "jsonData", "mode": "NULLABLE", "type": "STRING", "fields": [] } ]
Schema personalizzato
Se i dati sono già formattati in uno schema, potresti decidere di non utilizzare lo schema predefinito di Google descritto sopra. Puoi invece utilizzare il tuo schema e mappare i campi dello schema sulle proprietà chiave dei contenuti multimediali. Per mappare lo schema quando crei il datastore dei media, utilizza la consoleGoogle Cloud .
Se utilizzi il tuo schema, devi disporre di campi che possono essere mappati alle seguenti cinque proprietà chiave per i contenuti multimediali:
Nome della proprietà principale richiesta | Note |
---|---|
title
|
Stringa - obbligatorio Il titolo del documento dal tuo database. Una stringa codificata UTF-8. Limite di 1000 caratteri. |
uri
|
Stringa - obbligatorio URI del documento. Limite di lunghezza di 5000 caratteri. |
category
|
Stringa - obbligatorio Categorie di documenti. Questa proprietà viene ripetuta per supportare un documento appartenente a diverse categorie parallele. Utilizza il percorso completo della categoria per risultati di qualità superiore.
Per rappresentare il percorso completo di una categoria, utilizza il simbolo Ad esempio:
Un documento può contenere al massimo 250 categorie. Ogni categoria è una stringa codificata UTF-8 con un limite di lunghezza di 5000 caratteri. |
media_available_time
|
Data/ora - obbligatorio Il periodo di tempo durante il quale i contenuti sono disponibili per gli utenti finali. Questo campo identifica l'aggiornamento di un contenuto per gli utenti finali. Il timestamp deve essere conforme allo standard RFC 3339. Ad esempio:
Per filtrare in base alla disponibilità, consulta Filtrare i consigli e Filtrare in base ai documenti disponibili. |
media_duration
|
Stringa: obbligatoria per le app di suggerimenti sui contenuti multimediali in cui l'obiettivo commerciale è il tasso di conversione (CVR) o la durata di visualizzazione per sessione.
Durata dei contenuti multimediali. La durata deve essere codificata come stringa.
La codifica deve essere la stessa della codifica della stringa JSON. Questo campo è importante per le app di consigli sui contenuti multimediali in cui l'obiettivo dell'attività è massimizzare il tasso di conversione (CVR) o la durata di visualizzazione per visitatore. |
Inoltre, esistono proprietà chiave non obbligatorie, ma per ottenere risultati di qualità, mappa il maggior numero possibile di queste proprietà allo schema.
Queste proprietà chiave sono le seguenti:
Nome della proprietà chiave | Note |
---|---|
description
|
Stringa (altamente consigliato) Descrizione del documento. Limite di lunghezza di 5000 caratteri. |
image
|
Oggetto - facoltativo - ripetuto Proprietà chiave principale per l'incapsulamento delle proprietà correlate alle immagini. |
image_name
|
Stringa (facoltativo) Nome dell'immagine. Limite di lunghezza di 128 caratteri. |
image_uri
|
Stringa (facoltativo) L'URI dell'immagine. Limite di lunghezza di 5000 caratteri. |
language-code
|
Stringa (facoltativo) Lingua del titolo/della descrizione e di altri attributi stringa. Utilizza i tag lingua definiti da BCP 47. Per i suggerimenti di documenti, questo campo viene ignorato e la lingua del testo viene rilevata automaticamente. Il documento può includere testo in lingue diverse, ma la duplicazione dei documenti per fornire testo in più lingue può comportare un peggioramento delle prestazioni.
Per la ricerca di documenti, questo campo è in uso. Se non viene impostato, il valore predefinito è "en-US".
Ad esempio, |
media_aggregated_rating
|
Oggetto - facoltativo - ripetuto
Proprietà della chiave principale per incapsulare le
proprietà correlate |
media_aggregated_rating_count
|
Numero intero - facoltativo Il numero di recensioni individuali. Deve essere un valore non negativo. |
media_aggregated_rating_score
|
Doppio - obbligatorio La valutazione aggregata. La valutazione deve essere normalizzata nell'intervallo [1, 5]. |
media_aggregated_rating_source
|
Stringa - obbligatorio
L'origine della classificazione. Ad esempio, |
media_content_index
|
Numero intero - facoltativo Indice dei contenuti del documento multimediale. Il campo Indice dei contenuti può essere utilizzato per ordinare i documenti rispetto agli altri. Ad esempio, il numero dell'episodio può essere utilizzato come indice dei contenuti. L'indice dei contenuti deve essere un numero intero non negativo.
Ad esempio: |
media_content_rating
|
Stringa - facoltativa - ripetuta La classificazione dei contenuti, utilizzata per i sistemi di avviso sui contenuti e il filtro dei contenuti in base al pubblico. Sono consentiti al massimo 100 valori per documento con un limite di lunghezza di 128 caratteri.
Questo tag può essere utilizzato per filtrare i risultati dei consigli passando il
tag come parte di
Ad esempio: |
media_country_of_origin
|
Stringa (facoltativo) Paese di origine del documento multimediale. Limite di lunghezza di 128 caratteri.
Ad esempio: |
media_expire_time
|
Data/ora - facoltativo L'ora in cui i contenuti scadranno per gli utenti finali. Questo campo identifica l'aggiornamento di un contenuto per gli utenti finali. Il timestamp deve essere conforme allo standard RFC 3339. Ad esempio:
Per escludere i documenti scaduti dai risultati, vedi Filtrare i suggerimenti e Filtrare la ricerca di contenuti multimediali. |
live_event_start_time
|
Data/ora - facoltativo L'ora in cui inizia l'evento live. Il timestamp deve essere conforme allo standard RFC 3339. Ad esempio:
|
live_event_end_time
|
Data/ora - facoltativo L'ora in cui termina l'evento live. Il timestamp deve essere conforme allo standard RFC 3339. Ad esempio:
|
media_filter_tag
|
Stringa - facoltativa - ripetuta Filtra i tag per il documento. Sono consentiti al massimo 250 valori per documento con un limite di lunghezza di 1000 caratteri. In caso contrario, viene restituito un errore INVALID_ARGUMENT.
Questo tag può essere utilizzato per filtrare i risultati dei consigli passando il
tag come parte di
Ad esempio: |
media_hash_tag
|
Stringa - facoltativa - ripetuta Hashtag per il documento. Sono consentiti al massimo 100 valori per documento, con un limite di lunghezza di 5000 caratteri.
Ad esempio: |
media_in_language
|
Stringa - facoltativa - ripetuta La lingua dei contenuti multimediali. Utilizza i tag di lingua definiti da BCP 47.
Ad esempio: |
media_organization
|
Oggetto - facoltativo - ripetuto
Proprietà della chiave principale per l'incapsulamento delle proprietà
relative a
Ad esempio:
|
media_organization_custom_role
|
Stringa (facoltativo)
|
media_organization_name
|
Stringa - obbligatorio Nome dell'organizzazione. |
media_organization_rank
|
Stringa (facoltativo)
Utilizzato per la classificazione dei ruoli. Ad esempio, per il primo editore:
|
media_organization_role
|
Stringa - obbligatorio Il ruolo dell'organizzazione nell'elemento multimediale. Valori supportati: director, actor, player, team, league, editor, author, character, contributor, creator, editor, funder, producer, provider, publisher, sponsor, translator, music-by, channel, custom-role
Se a |
media_organization_uri
|
Stringa (facoltativo) URI dell'organizzazione. |
media_person
|
Oggetto - facoltativo - ripetuto Proprietà chiave principale per l'incapsulamento delle proprietà correlate alla persona.
Ad esempio:
|
media_person_custom_role
|
Stringa (facoltativo)
|
media_person_name
|
Stringa - obbligatorio Nome della persona. |
media_person_rank
|
Numero intero - facoltativo
Utilizzato per la classificazione dei ruoli. Ad esempio, per il primo attore,
|
media_person_role
|
Stringa - obbligatorio Il ruolo della persona nell'elemento multimediale. Valori supportati: director, actor, player, team, league, editor, author, character, contributor, creator, editor, funder, producer, provider, publisher, sponsor, translator, music-by, channel, custom-role
Se a |
media_person_uri
|
Stringa (facoltativo) URI della persona. |
media_production_year
|
Numero intero - facoltativo L'anno in cui è stato prodotto il contenuto multimediale. |
media_transcript
|
Stringa (facoltativo) Trascrizione del documento multimediale. |
media_type
|
Stringa: questo campo è obbligatorio per film e programmi Categoria di primo livello.
Tipi supportati:
I valori |
Se utilizzi il tuo schema anziché quello predefinito di Google, consulta Fornire o rilevare automaticamente uno schema per informazioni su formattazione e importazione del tuo schema.