Method: projects.locations.corpora.assets.upload

通过指定资产的 Cloud Storage URI 上传资产。对于视频仓库，调用此 API 的用户需要对 Cloud Storage 文件拥有读取权限。上传后，您可以通过 assets.generateRetrievalUrl API 检索该文件。默认情况下，该 API 只能检索仓库同一项目中的 Cloud Storage 文件。如需允许检索位于其他项目中的 Cloud Storage 文件，您需要找到 Vision AI 服务账号（前往 IAM，选中复选框以显示“包括 Google 提供的角色授权”，搜索“Cloud Vision AI Service Agent”），并向该服务账号授予对 Cloud Storage 文件的读取权限。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。要上传的素材资源的资源名称。格式：projects/{project_number}/locations/{locationId}/corpora/{corpus_id}/assets/{assetId}

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "assetSource": {
    object (AssetSource)
  }
}
字段
assetSource

object (AssetSource)

资产的来源。

响应正文

如果成功，则响应正文包含一个 Operation 实例。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • visionai.assets.upload

如需了解详情，请参阅 IAM 文档。

AssetSource

资产的来源。

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.
}
字段

联合字段 source_form。

source_form 只能是下列其中一项：
assetGcsSource

object (AssetGcsSource)

资产的来源是 Cloud Storage。
assetContentData

object (AssetContentData)

资产的来源来自内容字节。

AssetContentData

资源的内容。

JSON 表示法 
{
  "assetContentData": string
}
字段
assetContentData

string (bytes format)

使用 base64 编码的字符串。