Method: media.upload

Sube contenido multimedia para indexar.

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 indexación. Para indexar contenido de gran tamaño, 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 el ItemContent con el UploadItemRef del paso 1.

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

Nota: Para ejecutarse esta API requiere una cuenta de servicio.

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

El nombre del contenido multimedia que se está descargando. Consulta los ReadRequest.resource_name.

Cuerpo de la solicitud

El cuerpo de la solicitud incluye 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

Es el nombre del recurso multimedia.

Alcances de la autorización

Se necesita uno de los siguientes alcances 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.