Method: media.upload

Sube contenido multimedia para indexarlo.

El extremo de carga admite protocolos de carga directa y reanudable, y está diseñado para elementos grandes que no se pueden incorporar durante las solicitudes de indexación. Para indexar contenido de gran tamaño, sigue estos pasos:

  1. Llama a indexing.datasources.items.upload con el nombre del elemento para iniciar 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 de UploadItemRef del paso 1.
  3. Llama a indexing.datasources.items.index para indexar el elemento. Completa el ItemContent con el 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 las solicitudes de carga de medios:
    POST https://cloudsearch.googleapis.com/upload/v1/media/{resourceName=**}
  • URI de metadatos para las solicitudes de metadatos únicamente:
    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 está descargando. Consulta los ReadRequest.resource_name.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de Media.

Cuerpo de la respuesta

Es un recurso multimedia.

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

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

string

Es el nombre del recurso multimedia.

Permisos de 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.