Informazioni sui documenti multimediali e sui datastore

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&#39datastorei 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 > per separare le gerarchie. Se > fa parte del nome della categoria, sostituiscilo con un altro carattere o 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 - 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: 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 eseguono ricerche di titoli a trovare contenuti alternativi che potrebbero interessarli.

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, "language_code": "en-US".

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.google::protobuf::Duration Ad esempio: "5s", "1m"

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:

"2022-08-26T23:00:17Z"

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:

"2032-12-31T23:00:17Z"

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:

"2020-12-31T23:00:17Z"

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:

"2024-01-28T23:00:17Z"

in_languages

Stringa - facoltativa - ripetuta

La lingua dei contenuti multimediali. Utilizza i tag di lingua definiti da BCP 47.

Ad esempio: "in_languages": [ "en-US"]

country_of_origin

Stringa (facoltativo)

Paese di origine del documento multimediale. Limite di lunghezza 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 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: "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.

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 RecommendRequest.filter. I tag vengono utilizzati solo per filtrare i risultati restituiti; i valori dei tag non influiscono sui risultati restituiti dai modelli di ricerca e consigli.

Ad esempio: "filter_tags": [ "grade_level", "season"]

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 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 RecommendRequest.filter.

Ad esempio: content_rating: ["PG-13"]

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":"sports person","role":"player","rank":0,"uri":"http://example.com/person"}]

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 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 (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_]*.

persons.rank

Numero intero - facoltativo

Utilizzato per la classificazione dei ruoli. Ad esempio, per il primo attore, role = "actor", rank = 1

persons.uri

Stringa (facoltativo)

URI della persona.

organizations

Oggetto - facoltativo - ripetuto

Proprietà della chiave principale per l'incapsulamento delle proprietà relative a organization.

Ad esempio: "organizations ":[{"name":"sports team","role":"team","rank":0,"uri":"http://example.com/team"}]

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 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 (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_]*.

organizations.rank

Stringa (facoltativo)

Utilizzato per la classificazione dei ruoli. Ad esempio, per il primo editore: role = "publisher", rank = 1

organizations.uri

Stringa (facoltativo)

URI dell'organizzazione.

aggregate_ratings

Oggetto - facoltativo - ripetuto

Proprietà della chiave principale per incapsulare le proprietà correlate aggregate_rating.

aggregate_ratings.rating_source

Stringa - obbligatorio

L'origine 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 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 > per separare le gerarchie. Se > fa parte del nome della categoria, sostituiscilo con un altro carattere o 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 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:

"2022-08-26T23:00:17Z"

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.google::protobuf::Duration Ad esempio: "5s", "1m"

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, "language_code": "en-US"

media_aggregated_rating

Oggetto - facoltativo - ripetuto

Proprietà della chiave principale per incapsulare le proprietà correlate aggregate_rating.

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, 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 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: "content_index": 0

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 RecommendRequest.filter.

Ad esempio: content_rating: ["PG-13"]

media_country_of_origin

Stringa (facoltativo)

Paese di origine del documento multimediale. Limite di lunghezza di 128 caratteri.

Ad esempio: "country_of_origin": "US"

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:

"2032-12-31T23:00:17Z"

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:

"2020-12-31T23:00:17Z"

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:

"2024-01-28T23: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 di 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

La lingua dei contenuti multimediali. Utilizza i tag di lingua definiti da BCP 47.

Ad esempio: "in_languages": [ "en-US"]

media_organization

Oggetto - facoltativo - ripetuto

Proprietà della chiave principale per l'incapsulamento delle proprietà relative a organization.

Ad esempio: "organizations ":[{"name":"sports team","role":"team","rank":0,"uri":"http://example.com/team"}]

media_organization_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_organization_name

Stringa - obbligatorio

Nome dell'organizzazione.

media_organization_rank

Stringa (facoltativo)

Utilizzato per la classificazione dei ruoli. Ad esempio, per il primo editore: role = "publisher", rank = 1.

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 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à chiave principale per l'incapsulamento delle 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 - obbligatorio

Nome della persona.

media_person_rank

Numero intero - facoltativo

Utilizzato per la classificazione dei ruoli. Ad esempio, per il primo attore, role = "actor", rank = 1

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 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 (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: 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 eseguono ricerche di titoli a trovare contenuti alternativi che potrebbero interessarli.

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.