Method: media.upload

Carica contenuti multimediali per l'indicizzazione.

L'endpoint di caricamento supporta i protocolli di caricamento diretto e ripristinabile ed è destinato agli elementi di grandi dimensioni che non possono essere incorporati durante le richieste di indice. Per indicizzare contenuti di grandi dimensioni:

  1. Chiama indexing.datasources.items.upload con il nome dell'elemento per iniziare una sessione di caricamento e recuperare UploadItemRef.
  2. Chiama media.upload per caricare i contenuti come una richiesta di streaming utilizzando lo stesso nome di risorsa di UploadItemRef del passaggio 1.
  3. Chiama indexing.datasources.items.index per indicizzare l'elemento. Completa il campo ItemContent con il valore UploadItemRef del passaggio 1.

Per ulteriori informazioni, consulta Creare un connettore di contenuti utilizzando l'API REST.

Nota:l'esecuzione di questa API richiede un account di servizio.

Richiesta HTTP

  • URI di caricamento, per le richieste di caricamento di contenuti multimediali:
    POST https://cloudsearch.googleapis.com/upload/v1/media/{resourceName=**}
  • URI metadati, per richieste di soli metadati:
    POST https://cloudsearch.googleapis.com/v1/media/{resourceName=**}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
resourceName

string

Nome dell'elemento multimediale scaricato. Leggi i ReadRequest.resource_name.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Media.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Risorsa multimediale.

Rappresentazione JSON 
{
  "resourceName": string
}
Campi
resourceName

string

Nome della risorsa multimediale.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud_search.indexing
  • https://www.googleapis.com/auth/cloud_search

Per ulteriori informazioni, consulta la Guida alle autorizzazioni.