Method: media.upload

Importe des supports pour indexation.

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 intégré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 pour l'élément "UploadItemRef" de l'étape 1.
  3. Appelez indexing.datasources.items.index pour indexer l'élément. Dans ItemContent, renseignez la valeur UploadItemRef de l'étape 1.

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

Remarque:L'exécution de cette API nécessite un compte de service.

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 ne contenant que des métadonnées:
    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 support en cours de téléchargement. 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 relatif aux autorisations.