Method: projects.locations.corpora.assets.upload

指定資產的 Cloud Storage URI 來上傳資產。對於影片倉儲，呼叫此 API 的使用者必須具備雲端儲存空間檔案的讀取權限。上傳後，系統會透過 assets.generateRetrievalUrl API 擷取檔案，該 API 預設只會從資料倉儲的相同專案擷取雲端儲存空間檔案。如要擷取位於其他專案中的雲端儲存空間檔案，您必須找到 Vision AI 服務帳戶 (前往 IAM，勾選「Include Google-provided role grants」方塊，搜尋「Cloud Vision AI Service Agent」)，並將雲端儲存空間檔案的讀取權限授予該服務帳戶。

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

詳情請參閱 身分與存取權管理說明文件。

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 編碼字串。