Method: media.upload

Carica i contenuti multimediali per l'indicizzazione.

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

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

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

Nota: per l'esecuzione di questa API è necessario 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 solo di metadati:
    POST https://cloudsearch.googleapis.com/v1/media/{resourceName=**}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
resourceName

string

Nome dei contenuti multimediali in fase di download. 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 all'autorizzazione.