Method: projects.locations.corpora.assets.upload

Upload aset dengan menentukan URI Cloud Storage aset. Untuk video warehouse, pengguna yang memanggil API ini harus memiliki akses baca ke file cloud storage. Setelah diupload, file tersebut dapat diambil oleh assets.generateRetrievalUrl API yang secara default hanya dapat mengambil file cloud storage dari project warehouse yang sama. Untuk mengizinkan pengambilan file cloud storage yang berada dalam project terpisah, Anda harus menemukan akun layanan Cloud Vision AI (Buka IAM, centang kotak untuk menampilkan "Sertakan pemberian peran yang disediakan Google", telusuri "Cloud Vision AI Service Agent") dan berikan akses baca file cloud storage ke akun layanan tersebut.

Permintaan HTTP

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

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib. Nama resource aset yang akan diupload. Format: projects/{project_number}/locations/{locationId}/corpora/{corpus_id}/assets/{assetId}

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "assetSource": {
    object (AssetSource)
  }
}
Kolom
assetSource

object (AssetSource)

Sumber aset.

Isi respons

Jika berhasil, isi respons akan berisi instance Operation.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

Izin IAM

Memerlukan izin IAM berikut pada resource name:

  • visionai.assets.upload

Untuk mengetahui informasi selengkapnya, lihat dokumentasi IAM.

AssetSource

Sumber aset.

Representasi 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.
}
Kolom

Kolom union source_form.

source_form hanya dapat berupa salah satu dari hal berikut:
assetGcsSource

object (AssetGcsSource)

Sumber aset berasal dari Cloud Storage.
assetContentData

object (AssetContentData)

Sumber aset berasal dari byte konten.

AssetContentData

Konten aset.

Representasi JSON 
{
  "assetContentData": string
}
Kolom
assetContentData

string (bytes format)

String berenkode base64.