Method: media.upload

Sube contenido multimedia para indexarlo.

El extremo de carga admite protocolos de carga directos y reanudables, y está diseñado para elementos grandes que no se pueden intercalar durante las solicitudes de índice. Para indexar contenido grande, haz lo siguiente:

  1. Llama a indexing.datasources.items.upload con el nombre del elemento para comenzar una sesión de carga y recuperar el UploadItemRef.
  2. Llama a media.upload para subir el contenido, como una solicitud de transmisión, con el mismo nombre de recurso del UploadItemRef del paso 1.
  3. Llama a indexing.datasources.items.index para indexar el elemento. Propaga ItemContent con UploadItemRef del paso 1.

Para obtener más información, consulta Crea un conector de contenido con la API de REST.

Nota: Esta API requiere una cuenta de servicio para ejecutarse.

Solicitud HTTP

  • URI de carga para solicitudes de carga de contenido multimedia:
    POST https://cloudsearch.googleapis.com/upload/v1/media/{resourceName=**}
  • URI de metadatos, para solicitudes solo de metadatos:
    POST https://cloudsearch.googleapis.com/v1/media/{resourceName=**}

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
resourceName

string

Es el nombre del contenido multimedia que se descarga. Consulta los ReadRequest.resource_name.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de Media.

Cuerpo de la respuesta

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Recurso multimedia.

Representación JSON
{
  "resourceName": string
}
Campos
resourceName

string

Nombre del recurso multimedia.

Alcances de la autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta la Guía de autorización.