Method: projects.locations.corpora.assets.upload

Para subir un recurso, especifica el URI de Cloud Storage del recurso. En el caso del almacén de videos, se requiere que los usuarios que llamen a esta API tengan acceso de lectura al archivo de almacenamiento en la nube. Una vez que se sube, la API de assets.generateRetrievalUrl puede recuperarlo, que, de forma predeterminada, solo puede recuperar archivos de almacenamiento en la nube del mismo proyecto del almacén. Para permitir la recuperación de archivos de almacenamiento en la nube que se encuentran en un proyecto independiente, se debe encontrar la cuenta de servicio de Cloud Vision AI (ve a IAM, marca la casilla de verificación para mostrar "Incluir asignaciones de roles proporcionadas por Google", busca "Agente de servicio de Cloud Vision AI") y otorgarle acceso de lectura a los archivos de almacenamiento en la nube a esa cuenta de servicio.

Solicitud HTTP

POST https://visionai.googleapis.com/v1/{name=projects/*/locations/*/corpora/*/assets/*}:upload

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

Parámetros de ruta de acceso

Parámetros
name

string

Obligatorio. Es el nombre del recurso del activo que se subirá. Formato: projects/{project_number}/locations/{locationId}/corpora/{corpus_id}/assets/{assetId}

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON
{
  "assetSource": {
    object (AssetSource)
  }
}
Campos
assetSource

object (AssetSource)

Es la fuente del activo.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Descripción general de la autenticación.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • visionai.assets.upload

Para obtener más información, consulta la documentación de IAM.

AssetSource

Es la fuente del activo.

Representación JSON
{

  // Union field source_form can be only one of the following:
  "assetGcsSource": {
    object (AssetGcsSource)
  },
  "assetContentData": {
    object (AssetContentData)
  }
  // End of list of possible types for union field source_form.
}
Campos

Campo de unión source_form.

source_form puede ser una de las siguientes opciones:

assetGcsSource

object (AssetGcsSource)

La fuente del activo es de Cloud Storage.

assetContentData

object (AssetContentData)

La fuente del activo proviene de bytes de contenido.

AssetContentData

Es el contenido del activo.

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

string (bytes format)

String codificada en base64.