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 contenuti multimediali:

  • 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à multimediali per lo schema personalizzato: title, url, category e così via.

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

• Consulta Informazioni sugli eventi utente relativi ai contenuti multimediali e prepara gli eventi utente per l'importazione. Gli eventi utente sono obbligatori per tutte le app 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 su una riga separata.

• 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 Google Cloud progetto.
   • 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"

   Sostituisci quanto segue:

   • 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 sola riga. Ogni documento deve essere su una riga distinta.

Campi minimi obbligatori:

{
   "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

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 recenti 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.