Method: projects.locations.corpora.assets.upload

Faça upload do recurso especificando o URI do Cloud Storage. Para o depósito de vídeo, os usuários que chamam essa API precisam ter acesso de leitura ao arquivo de armazenamento em nuvem. Depois do upload, ele pode ser recuperado pela API assets.generateRetrievalUrl, que, por padrão, só pode recuperar arquivos do Cloud Storage do mesmo projeto do repositório. Para permitir a recuperação de arquivos do Cloud Storage em um projeto separado, é necessário encontrar a conta de serviço da visão computacional (acesse o IAM, marque a caixa de seleção para mostrar "Incluir concessões de função fornecidas pelo Google", pesquise "Agente de serviço de IA do Cloud Vision") e conceda o acesso de leitura dos arquivos do Cloud Storage a essa conta de serviço.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. O nome do recurso a ser enviado. Formato: projects/{project_number}/locations/{locationId}/corpora/{corpus_id}/assets/{assetId}

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "assetSource": {
    object (AssetSource)
  }
}
Campos
assetSource

object (AssetSource)

A origem do recurso.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • visionai.assets.upload

Para mais informações, consulte a documentação do IAM.

AssetSource

A origem do recurso.

Representação 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ão source_form.

source_form pode ser apenas de um dos tipos a seguir:

assetGcsSource

object (AssetGcsSource)

A origem do recurso é do Cloud Storage.

assetContentData

object (AssetContentData)

A origem do recurso é de bytes de conteúdo.

AssetContentData

O conteúdo do recurso.

Representação JSON
{
  "assetContentData": string
}
Campos
assetContentData

string (bytes format)

Uma string codificada em base64.