Vertex AI Agent Builder è stato rinominato in Applicazioni IA. Stiamo aggiornando i contenuti in base al nuovo branding.

Questa pagina è stata tradotta dall'API Cloud Translation.

Informazioni sui documenti multimediali e sui datastore
Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Questa pagina fornisce informazioni su documenti e data store 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 caricato in un datastore di Vertex AI Agent Builder. 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, specifica 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 generica 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ù precise e specifiche sono le informazioni che fornisci, più alta sarà la qualità dei risultati.

I dati caricati nell'archivio dati devono essere formattati in uno schema JSON specifico. I dati organizzati in questo schema devono trovarsi in una tabella BigQuery, in un file o in un insieme di file in Cloud Storage o in un oggetto JSON che puoi caricare direttamente utilizzando la console Google Cloud.

Schema predefinito di Google e schema personalizzato

Per lo schema dei dati multimediali sono disponibili due opzioni:

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 tuoi 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 di campi di dati devono corrispondere esattamente a quelli nelle tabelle Document Fields.

Proprietà chiave

Le proprietà vengono utilizzate per addestrare i modelli per la ricerca e i consigli. I campi della proprietà rappresentano tutti i campi dello schema.

Le proprietà chiave sono un insieme speciale di proprietà fisse nello schema di 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 tuoi campi al maggior numero possibile di proprietà chiave. Esegui la mappatura nella console Google Cloud dopo l'importazione dei dati; consulta Creare un data store di contenuti multimediali.

Schema JSON predefinito di Google per `Document`

Quando utilizzi i 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 documento JSON o lo struct sia conforme allo schema JSON seguente. Lo schema JSON utilizza JSON Schema 2020-12 per la convalida. Per saperne di più su JSON Schema, consulta anche la documentazione della specifica 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",
    },
    "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 di campo che fornisci quando crei i documenti per il tuo data store. I valori devono corrispondere a quelli utilizzati nel database di documenti interno e devono rispecchiare con precisione l'elemento rappresentato.

Campi oggetto `Document`

I seguenti campi sono campi di primo livello per l'oggetto Document. Consulta inoltre questi campi nella pagina di riferimento Document.

Nome campo	Note
`name`	Il nome completo e univoco della risorsa del documento. Obbligatorio per tutti metodi `Document`, ad eccezione di `create` e `import`. Durante l'importazione, il nome viene generato automaticamente e non è necessario fornirlo manualmente.
`id`	L'ID documento utilizzato dal tuo database interno. Il campo ID deve essere univoco nell'intero data store. 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 nello stesso data store. Deve essere impostato su "default_schema", che viene creato automaticamente quando viene creato l'archivio dati predefinito.
`parentDocumentId`	L'ID del documento principale. Per i documenti di primo livello (radice), `parent_document_id` può essere vuoto o può fare riferimento a se stesso. Per i documenti secondari, `parent_document_id` deve fare riferimento a un documento principale valido.

Campi 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 relativa alla comprensione di JSON Schema per le proprietà su json-schema.org.

La tabella seguente definisce i campi piatti

Nome campo	Note
`title`	Stringa - obbligatoria Titolo del documento del tuo database. Una stringa codificata UTF-8. Sono consentiti massimo 1000 caratteri.
`categories`	Stringa - obbligatoria Categorie di documenti. Questa proprietà viene ripetuta per supportare un documento appartenente a più categorie parallele. Utilizza il percorso completo della categoria per risultati di qualità superiore. Per rappresentare il percorso completo di una categoria, utilizza il simbolo `>` per separare le gerarchie. Se `>` fa parte del nome della categoria, sostituiscilo con altri caratteri. Ad esempio: `"categories": [ "sports > highlight" ]` 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 - obbligatoria URI del documento. Lunghezza massima di 5000 caratteri.
`description`	Stringa: vivamente consigliata Descrizione del documento. Il limite di caratteri è 5000.
`media_type`	Stringa: questo campo è obbligatorio per film e programmi Categoria di primo livello. Tipi supportati: `movie`, `show`, `concert`, `event`, `live-event`, `broadcast`, `tv-series`, `episode`, `video-game`, `clip`, `vlog`, `audio`, `audio-book`, `music`, `album`, `articles`, `news`, `radio`, `podcast`, `book` e `sports-game`. I valori `movie` e `show` hanno un significato speciale. Consentono di arricchire i documenti in modo da migliorare il ranking e aiutare gli utenti che effettuano ricerche per titolo a trovare contenuti alternativi che potrebbero interessare loro.
`language_code`	Stringa (facoltativa) Lingua del titolo/della descrizione e di altri attributi di stringa. Utilizza i tag lingua definiti da BCP 47. Per il consiglio sui 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 calo del rendimento. Per la ricerca di documenti, questo campo è in uso. Se non viene impostato, il valore predefinito è "en-US". Ad esempio, `"language_code": "en-US"`.
`duration`	Stringa: obbligatoria per le app per suggerimenti sui contenuti multimediali in cui l'obiettivo commerciale è la percentuale di clic (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 `google::protobuf::Duration` codifica della stringa JSON. Ad esempio: "5s", "1m"
`available_time`	Data/ora - obbligatorio Il momento in cui i contenuti sono disponibili per gli utenti finali. Questo campo identifica l'aggiornamento dei contenuti per gli utenti finali. Il timestamp deve essere conforme allo standard RFC 3339. Ad esempio: `"2022-08-26T23:00:17Z"`
`expire_time`	Data/ora (facoltativo) La data di scadenza dei contenuti per gli utenti finali. Questo campo identifica l'aggiornamento dei contenuti per gli utenti finali. Il timestamp deve essere conforme allo standard RFC 3339. Ad esempio: `"2032-12-31T23:00:17Z"`
`in_languages`	Stringa - facoltativa - ripetuta Lingua dei contenuti multimediali. Utilizza i tag lingua definiti da BCP 47. Ad esempio: `"in_languages": [ "en-US"]`
`country_of_origin`	Stringa (facoltativa) Paese di origine del documento multimediale. Lunghezza massima di 128 caratteri. Ad esempio: `"country_of_origin": "US"`
`transcript`	Stringa (facoltativo) Trascrizione del documento multimediale.
`content_index`	Numero intero (facoltativo) Indice dei contenuti del documento multimediale. Il campo dell'indice dei contenuti può essere utilizzato per ordinare i documenti rispetto ad altri. Ad esempio, il numero di puntata può essere utilizzato come indice dei contenuti. L'indice dei contenuti deve essere un numero intero non negativo. Ad esempio: `"content_index": 0`
`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. Questo tag può essere utilizzato per filtrare i risultati dei consigli passando il tag come parte del `RecommendRequest.filter`. Ad esempio: `"filter_tags": [ "filter_tag"]`
`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: `"hash_tags": [ "soccer", "world cup"]`
`production_year`	Numero intero (facoltativo) L'anno di produzione dei contenuti multimediali.
`content_rating`	Stringa - facoltativa - ripetuta La classificazione dei contenuti, utilizzata per i sistemi di consulenza sui contenuti e per 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 del `RecommendRequest.filter`. Ad esempio: `content_rating: ["PG-13"]`

La tabella seguente definisce i campi gerarchici.

Nome campo	Note
`images`	Oggetto (facoltativo) - ripetuto Proprietà della chiave principale per l'incapsulamento delle proprietà relative alle immagini.
`images.uri`	Stringa (facoltativa) URI dell'immagine. Lunghezza massima di 5000 caratteri.
`images.name`	Stringa (facoltativo) Nome dell'immagine. Lunghezza massima di 128 caratteri.
`persons`	Oggetto (facoltativo) - ripetuto Proprietà della chiave principale per incapsulare le proprietà correlate alla persona. Ad esempio: `"persons":[{"name":"sports person","role":"player","rank":0,"uri":"http://example.com/person"}]`
`persons.name`	Stringa - obbligatoria Nome della persona.
`persons.role`	Stringa - obbligatoria 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 `role` non viene applicato nessuno dei valori supportati, imposta `role` su `custom-role` e fornisci il valore nel campo `custom_role`.
`persons.custom_role`	Stringa (facoltativa) `custom_role` è impostato se e solo se `role` è impostato su `custom-role`. Deve essere una stringa codificata in UTF-8 con un limite di lunghezza di 128 caratteri. Deve corrispondere al pattern: `[a-zA-Z0-9][a-zA-Z0-9_]*`.
`persons.rank`	Numero intero (facoltativo) Utilizzato per il ranking dei ruoli. Ad esempio, per il primo attore, `role = "actor", rank = 1`
`persons.uri`	Stringa (facoltativa) URI della persona.
`organizations`	Oggetto (facoltativo) - ripetuto Proprietà chiave principale per l'incapsulamento delle proprietà correlate a `organization`. Ad esempio: `"organizations ":[{"name":"sports team","role":"team","rank":0,"uri":"http://example.com/team"}]`
`organizations.name`	Stringa - obbligatoria Nome dell'organizzazione.
`organizations.role`	Stringa - obbligatoria 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 `role` non viene applicato nessuno dei valori supportati, imposta `role` su `custom-role` e fornisci il valore nel campo `custom_role`.
`organizations.custom_role`	Stringa (facoltativa) `custom_role` è impostato se e solo se `role` è impostato su `custom-role`. Deve essere una stringa codificata in UTF-8 con un limite di lunghezza di 128 caratteri. Deve corrispondere al pattern: `[a-zA-Z0-9][a-zA-Z0-9_]*`.
`organizations.rank`	Stringa (facoltativa) Utilizzato per il ranking dei ruoli. Ad esempio, per il primo editore: `role = "publisher", rank = 1`.
`organizations.uri`	Stringa (facoltativa) URI dell'organizzazione.
`aggregate_ratings`	Oggetto (facoltativo) - ripetuto Proprietà chiave principale per incapsulare le proprietà correlate a `aggregate_rating`.
`aggregate_ratings.rating_source`	Stringa - obbligatoria La fonte della classificazione. Ad esempio, `imdb` o `rotten_tomatoes`. Deve essere una stringa codificata in UTF-8 con un limite di lunghezza di 128 caratteri. Deve corrispondere al pattern: `[a-zA-Z0-9][a-zA-Z0-9_]*`.
`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 singole. Deve essere un valore non negativo.

Livelli di documento

I livelli dei documenti determinano la gerarchia nel tuo datastore. In genere, dovresti avere un datastore a un livello o a due livelli. Sono supportati solo due livelli.

Ad esempio, puoi avere un data store a un livello in cui ogni documento è un singolo elemento. In alternativa, puoi scegliere un data store a due livelli che contenga sia gruppi di elementi sia singoli elementi.

Tipi a livello di documento

Esistono due tipi a livello di documento:

Genitore. I documenti principali sono quelli restituiti da Vertex AI Search nei consigli e nelle ricerche. I documenti principali 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 bambini possono essere solo singoli documenti. Ad esempio, se il documento principale è "Programma TV di esempio", i documenti secondari potrebbero essere "Puntata 1" e "Puntata 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 tuo datastore, decidi se deve contenere solo elementi principali o elementi principali e secondari. Il punto chiave da ricordare è che i consigli e le ricerche restituiscono solo i documenti principali.

Ad esempio, un data store riservato ai genitori potrebbe essere adatto per gli audiolibri, in cui un riquadro dei consigli restituisce una selezione di singoli audiolibri. D'altra parte, se hai caricato gli episodi di un programma TV come documenti principali in un data store solo per i documenti principali, nello stesso riquadro potrebbero essere consigliati diversi episodi fuori sequenza.

Un data store di programmi TV potrebbe funzionare sia con i documenti principali che con quelli secondari, in cui ogni documento principale rappresenta un programma TV con documenti secondari che rappresentano le puntate del programma TV. Questo datastore a due livelli consente al riquadro di consigli di mostrare una serie di programmi TV simili. L'utente finale può fare clic su un determinato programma per selezionare una puntata da guardare.

Poiché le gerarchie padre-figlio possono essere difficili da configurare e gestire, è consigliabile utilizzare datastore solo per i dati principali.

Ad esempio, un data store di programmi TV può funzionare bene come data store solo per i documenti principali, dove ogni documento principale rappresenta un programma TV che può essere consigliato e le singole puntate non sono incluse (e quindi non consigliate).

Se stabilisci che il tuo data store deve avere sia elementi principali che elementi secondari, ovvero gruppi e articoli singoli, ma al momento hai solo articoli singoli, devi creare elementi principali per i gruppi. Le informazioni minime che devi fornire per un genitore sono id, title e categories. Per ulteriori informazioni, consulta la sezione Campi dei documenti.

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 caricarla 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 tuoi dati sono già formattati in uno schema, puoi decidere di non utilizzare lo schema predefinito di Google descritto sopra. In alternativa, puoi utilizzare il tuo schema e mappare i campi dello schema alle proprietà chiave dei media. Per mappare lo schema quando crei il data media store, utilizza la console Google Cloud.

Se utilizzi il tuo schema, devi includere campi che possono essere mappati alle seguenti cinque proprietà chiave per i contenuti multimediali:

Nome della proprietà chiave obbligatoria	Note
`title`	Stringa - obbligatoria Titolo del documento del tuo database. Una stringa codificata UTF-8. Sono consentiti massimo 1000 caratteri.
`uri`	Stringa - obbligatoria URI del documento. Lunghezza massima di 5000 caratteri.
`category`	Stringa - obbligatoria Categorie di documenti. Questa proprietà viene ripetuta per supportare un documento appartenente a più categorie parallele. Utilizza il percorso completo della categoria per risultati di qualità superiore. Per rappresentare il percorso completo di una categoria, utilizza il simbolo `>` per separare le gerarchie. Se `>` fa parte del nome della categoria, sostituiscilo con altri caratteri. Ad esempio: `"categories": [ "sports > highlight" ]` 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 momento in cui i contenuti sono disponibili per gli utenti finali. Questo campo identifica l'aggiornamento dei contenuti per gli utenti finali. Il timestamp deve essere conforme allo standard RFC 3339. Ad esempio: `"2022-08-26T23:00:17Z"`
`media_duration`	Stringa: obbligatoria per le app per suggerimenti sui contenuti multimediali in cui l'obiettivo commerciale è la percentuale di clic (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 `google::protobuf::Duration` codifica della stringa JSON. Ad esempio: "5s", "1m" Questo campo è importante per le app di consigli sui contenuti multimediali in cui scopo commerciale è massimizzare il tasso di conversione (CVR) o la durata di visualizzazione per visitatore.

Inoltre, ci sono proprietà chiave che non sono obbligatorie, ma per risultati di qualità, mappane il maggior numero possibile allo schema.

Queste proprietà chiave sono le seguenti:

Nome della proprietà chiave	Note
`description`	Stringa: vivamente consigliata Descrizione del documento. Lunghezza massima di 5000 caratteri.
`image`	Oggetto (facoltativo) - ripetuto Proprietà della chiave principale per l'incapsulamento delle proprietà relative alle immagini.
`image_name`	Stringa (facoltativo) Nome dell'immagine. Lunghezza massima di 128 caratteri.
`image_uri`	Stringa (facoltativa) URI dell'immagine. Lunghezza massima di 5000 caratteri.
`language-code`	Stringa (facoltativa) Lingua del titolo/della descrizione e di altri attributi di stringa. Utilizza i tag lingua definiti da BCP 47. Per il consiglio sui 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 calo del rendimento. Per la ricerca di documenti, questo campo è in uso. Se non viene impostato, il valore predefinito è "en-US". Ad esempio, `"language_code": "en-US"`.
`media_aggregated_rating`	Oggetto (facoltativo) - ripetuto Proprietà chiave principale per incapsulare le proprietà correlate a `aggregate_rating`.
`media_aggregated_rating_count`	Numero intero (facoltativo) Il numero di recensioni singole. 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 - obbligatoria La fonte della classificazione. Ad esempio, `imdb` o `rotten_tomatoes`. Deve essere una stringa codificata in UTF-8 con un limite di lunghezza di 128 caratteri. Deve corrispondere al pattern: `[a-zA-Z0-9][a-zA-Z0-9_]*`.
`media_content_index`	Numero intero (facoltativo) Indice dei contenuti del documento multimediale. Il campo dell'indice dei contenuti può essere utilizzato per ordinare i documenti rispetto ad altri. Ad esempio, il numero di puntata può essere utilizzato come indice dei contenuti. L'indice dei contenuti deve essere un numero intero non negativo. Ad esempio: `"content_index": 0`
`media_content_rating`	Stringa - facoltativa - ripetuta La classificazione dei contenuti, utilizzata per i sistemi di consulenza sui contenuti e per 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 del `RecommendRequest.filter`. Ad esempio: `content_rating: ["PG-13"]`
`media_country_of_origin`	Stringa (facoltativa) Paese di origine del documento multimediale. Lunghezza massima di 128 caratteri. Ad esempio: `"country_of_origin": "US"`
`media_expire_time`	Data/ora (facoltativo) La data di scadenza dei contenuti per gli utenti finali. Questo campo identifica l'aggiornamento dei contenuti per gli utenti finali. Il timestamp deve essere conforme allo standard RFC 3339. Ad esempio: `"2032-12-31T23:00:17Z"`
`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 del `RecommendRequest.filter`. Ad esempio: `"filter_tags": [ "filter_tag"]`
`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: `"hash_tags": [ "soccer", "world cup"]`
`media_in_language`	Stringa - facoltativa - ripetuta Lingua dei contenuti multimediali. Utilizza i tag lingua definiti da BCP 47. Ad esempio: `"in_languages": [ "en-US"]`
`media_organization`	Oggetto (facoltativo) - ripetuto Proprietà chiave principale per l'incapsulamento delle proprietà correlate a `organization`. Ad esempio: `"organizations ":[{"name":"sports team","role":"team","rank":0,"uri":"http://example.com/team"}]`
`media_organization_custom_role`	Stringa (facoltativa) `custom_role` è impostato se e solo se `role` è impostato su `custom-role`. Deve essere una stringa codificata in UTF-8 con un limite di lunghezza di 128 caratteri. Deve corrispondere al pattern: `[a-zA-Z0-9][a-zA-Z0-9_]*`.
`media_organization_name`	Stringa - obbligatoria Nome dell'organizzazione.
`media_organization_rank`	Stringa (facoltativa) Utilizzato per il ranking dei ruoli. Ad esempio, per il primo editore: `role = "publisher", rank = 1`.
`media_organization_role`	Stringa - obbligatoria 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 `role` non viene applicato nessuno dei valori supportati, imposta `role` su `custom-role` e fornisci il valore nel campo `custom_role`.
`media_organization_uri`	Stringa (facoltativo) URI dell'organizzazione.
`media_person`	Oggetto (facoltativo) - ripetuto Proprietà della chiave principale per incapsulare le proprietà correlate alla persona. Ad esempio: `"persons":[{"name":"sports person","role":"player","rank":0,"uri":"http://example.com/person"}]`
`media_person_custom_role`	Stringa (facoltativo) `custom_role` è impostato se e solo se `role` è impostato su `custom-role`. Deve essere una stringa codificata in UTF-8 con un limite di lunghezza di 128 caratteri. Deve corrispondere al pattern: `[a-zA-Z0-9][a-zA-Z0-9_]*`.
`media_person_name`	Stringa - obbligatoria Nome della persona.
`media_person_rank`	Numero intero (facoltativo) Utilizzato per il ranking dei ruoli. Ad esempio, per il primo attore, `role = "actor", rank = 1`
`media_person_role`	Stringa - obbligatoria 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 `role` non viene applicato nessuno dei valori supportati, imposta `role` su `custom-role` e fornisci il valore nel campo `custom_role`.
`media_person_uri`	Stringa (facoltativa) URI della persona.
`media_production_year`	Numero intero (facoltativo) L'anno di produzione dei contenuti multimediali.
`media_transcript`	Stringa (facoltativa) Trascrizione del documento multimediale.
`media_type`	Stringa: questo campo è obbligatorio per film e programmi Categoria di primo livello. Tipi supportati: `movie`, `show`, `concert`, `event`, `live-event`, `broadcast`, `tv-series`, `episode`, `video-game`, `clip`, `vlog`, `audio`, `audio-book`, `music`, `album`, `articles`, `news`, `radio`, `podcast`, `book` e `sports-game`. I valori `movie` e `show` hanno un significato speciale. Consentono di arricchire i documenti in modo da migliorare il ranking e aiutare gli utenti che effettuano ricerche per titolo a trovare contenuti alternativi che potrebbero interessare loro.

Se utilizzi il tuo schema anziché quello predefinito di Google, consulta Fornire o rilevare automaticamente uno schema per informazioni sulla formattazione e sull'importazione del tuo schema.

Informazioni sui documenti multimediali e sui datastore Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.