Crea un datastore multimediale

Questa pagina spiega come creare un datastore per i contenuti multimediali e importarvi i dati.

Prima di iniziare

Assicurati di svolgere le seguenti operazioni:

• Esamina i concetti relativi ai dati e allo schema dei media:

  • Informazioni sui documenti multimediali e sugli archivi di dati

  • Fornire o rilevare automaticamente uno schema

• Decidi se utilizzare lo schema Google predefinito per i tuoi dati multimediali o il tuo schema.

• Se utilizzi il tuo schema, assicurati che contenga campi che si mappano bene alle proprietà delle chiavi multimediali: title, url, category e così via.

• Inserisci i documenti multimediali nello schema JSON e carica i dati in BigQuery o Cloud Storage.

• Consulta la sezione Informazioni sugli eventi utente e prepara gli eventi utente per l'importazione. Gli eventi utente sono obbligatori per i suggerimenti sui contenuti multimediali e sono consigliati per la ricerca di contenuti multimediali.

Scegli la procedura in base all'origine dati

Per creare un datastore di contenuti multimediali e importare documenti, vai alla sezione relativa all'origine che hai intenzione di utilizzare:

• BigQuery

• Cloud Storage

• Importare documenti utilizzando l'API

Importa da BigQuery

Importa da Cloud Storage

Importare documenti utilizzando l'API

Se utilizzi lo schema predefinito di Google, puoi importare i documenti inviando una richiesta POST al metodo REST Documents:import, utilizzando l'oggetto InlineSource per specificare i dati.

Per un esempio del formato del documento JSON, consulta Formato del documento JSON.

Requisiti di importazione

Di seguito sono riportati i requisiti per l'importazione di documenti multimediali utilizzando l'API:

• Ogni documento deve essere inserito in una riga distinta.

• Il numero massimo di documenti in un'unica importazione è 100.

Procedura

Per importare i documenti multimediali utilizzando l'API:

1. Crea un datastore.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/dataStores?dataStoreId=DATA_STORE_ID" \
   -d '{
     "displayName": "DATA_STORE_DISPLAY_NAME",
     "industryVertical": "MEDIA"
   }'
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del tuo progetto Google Cloud.
   • DATA_STORE_ID: l'ID del datastore di Vertex AI Search che vuoi creare. Questo ID può contenere solo lettere minuscole, cifre, trattini bassi e trattini.
   • DATA_STORE_DISPLAY_NAME: il nome visualizzato del datastore di ricerca Vertex AI che vuoi creare.

2. Crea il file JSON per il documento e chiamalo ./data.json:

   {
   "inlineSource": {
   "documents": [
     { DOCUMENT_1 },
     { DOCUMENT_2 }
   ]
   }
   }
   

3. Chiama il metodo POST:

   curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    --data @./data.json \
   "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/dataStores/DATA_STORE_ID/branches/0/documents:import"

   • PROJECT_ID: l'ID del progetto.
   • DATA_STORE_ID: l'ID del tuo datastore.

Formato del documento JSON

Gli esempi riportati di seguito mostrano le voci Document in formato JSON.

Fornisci un intero documento su una singola riga. Ogni documento deve essere su una riga distinta.

Campi obbligatori minimi:

{
   "id": "sample-01",
   "schemaId": "default_schema",
   "jsonData": "{\"title\":\"Test document title\",\"categories\":[\"sports > clip\",\"sports > highlight\"],\"uri\":\"http://www.example.com\",\"media_type\":\"sports-game\",\"available_time\":\"2022-08-26T23:00:17Z\"}"
}

Oggetto completo:

{
   "id": "child-sample-0",
   "schemaId": "default_schema",
   "jsonData": "{\"title\":\"Test document title\",\"description\":\"Test document description\",\"language_code\":\"en-US\",\"categories\":[\"sports > clip\",\"sports > highlight\"],\"uri\":\"http://www.example.com\",\"images\":[{\"uri\":\"http://example.com/img1\",\"name\":\"image_1\"}],\"media_type\":\"sports-game\",\"in_languages\":[\"en-US\"],\"country_of_origin\":\"US\",\"content_index\":0,\"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\"],\"production_year\":1900,\"duration\":\"100s\",\"content_rating\":[\"PG-13\"],\"aggregate_ratings\":[{\"rating_source\":\"imdb\",\"rating_score\":4.5,\"rating_count\":1250}],\"available_time\":\"2022-08-26T23:00:17Z\"}"
}

Monitorare l'importazione e visualizzare i dati

1. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del datastore per visualizzarne i dettagli nella pagina Dati.

2. Fai clic sulla scheda Attività.

   Quando la colonna dello stato nella scheda Attività passa da In corso a Importazione completata, l'importazione è completata.

   A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

3. Fai clic su Documenti per visualizzare i dati importati.

Importa gli eventi utente

Gli eventi utente sono obbligatori se vuoi utilizzare il tuo datastore con un'app per suggerimenti sui contenuti multimediali.

Sebbene gli eventi utente non siano obbligatori per le app di ricerca di contenuti multimediali, includili per ottenere risultati di ricerca di qualità migliore.

Per importare gli eventi utente nel tuo datastore multimediale:

• Segui le istruzioni riportate in Importare gli eventi utente storici.

Passaggi successivi

• Crea un'app di suggerimenti sui contenuti multimediali o un'app di ricerca di contenuti multimediali.

• Mantieni aggiornati i dati del documento.

  Idealmente, dovresti aggiornare il tuo datastore quotidianamente importando dati aggiornati. La pianificazione delle importazioni periodiche impedisce il degrado della qualità del modello nel tempo. Puoi utilizzare Google Cloud Scheduler per automatizzare le importazioni.

  Puoi aggiornare solo i documenti nuovi o modificati oppure puoi importare l'intero datastore. Se importi documenti già presenti nel tuo datastore, questi non vengono aggiunti di nuovo. Tutti i documenti modificati vengono aggiornati.

• Mantieni aggiornati i dati sugli eventi utente.

  È particolarmente importante mantenere aggiornati gli eventi utente. L'app dei consigli smette di funzionare se non ci sono eventi utente aggiornati sufficienti per soddisfare i requisiti relativi ai dati.

  Per informazioni sull'importazione dei dati sugli eventi utente in tempo reale, consulta Registrare gli eventi utente in tempo reale.

  Per informazioni sul monitoraggio dei requisiti relativi agli eventi utente, vedi Verificare la qualità dei dati per i consigli sui contenuti multimediali.