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 サービス エージェント] を検索）、そのサービス アカウントに Cloud Storage ファイルの読み取りアクセス権を付与する必要があります。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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 でエンコードされた文字列。