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
{// 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:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-03-04 UTC."],[],[],null,["# Method: projects.locations.corpora.assets.upload\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [AssetSource](#AssetSource)\n - [JSON representation](#AssetSource.SCHEMA_REPRESENTATION)\n- [AssetContentData](#AssetContentData)\n - [JSON representation](#AssetContentData.SCHEMA_REPRESENTATION)\n\nUpload asset by specifing the asset Cloud Storage uri. For video warehouse, it requires users who call this API have read access to the cloud storage file. Once it is uploaded, it can be retrieved by assets.generateRetrievalUrl API which by default, only can retrieve cloud storage files from the same project of the warehouse. To allow retrieval cloud storage files that are in a separate project, it requires to find the vision ai service account (Go to IAM, check checkbox to show \"Include Google-provided role grants\", search for \"Cloud Vision AI Service Agent\") and grant the read access of the cloud storage files to that service account.\n\n### HTTP request\n\n`POST https://visionai.googleapis.com/v1/{name=projects/*/locations/*/corpora/*/assets/*}:upload`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/vision-ai/docs/reference/rest/Shared.Types/ListOperationsResponse#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](https://cloud.google.com/docs/authentication/).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource:\n\n- `visionai.assets.upload`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs).\n\nAssetSource\n-----------\n\nThe source of the asset.\n\nAssetContentData\n----------------\n\nThe content of the asset."]]
