Method: media.upload

Importe des contenus multimédias à indexer.

Le point de terminaison d'importation est compatible avec les protocoles d'importation directe et avec reprise. Il est destiné aux éléments volumineux qui ne peuvent pas être inlinés lors des requêtes d'index. Pour indexer un contenu volumineux:

  1. Appelez indexing.datasources.items.upload avec le nom de l'élément pour démarrer une session d'importation et récupérer UploadItemRef.
  2. Appelez media.upload pour importer le contenu en tant que requête de streaming, en utilisant le même nom de ressource que celui de l'élément UploadItemRef de l'étape 1.
  3. Appelez indexing.datasources.items.index pour indexer l'élément. Renseignez ItemContent avec l'attribut UploadItemRef de l'étape 1.

Pour en savoir plus, consultez Créer un connecteur de contenu à l'aide de l'API REST.

Remarque:Cette API nécessite un compte de service pour s'exécuter.

Requête HTTP

  • URI d'importation, pour les demandes d'importation de médias:
    POST https://cloudsearch.googleapis.com/upload/v1/media/{resourceName=**}
  • URI de métadonnées, pour les requêtes de métadonnées uniquement:
    POST https://cloudsearch.googleapis.com/v1/media/{resourceName=**}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
resourceName

string

Nom du contenu multimédia téléchargé. Consultez les ReadRequest.resource_name.

Corps de la requête

Le corps de la requête contient une instance de Media.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Ressource multimédia.

Représentation JSON 
{
  "resourceName": string
}
Champs
resourceName

string

Nom de la ressource multimédia.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez le guide d'autorisation.