Membuat dan memperbarui aset warehouse

Vision Warehouse yang terhubung (corpus) dalam aplikasi yang di-deploy untuk penyerapan data memiliki satu atau beberapa resource objek media (misalnya, resource video). Objek media ini (resource asset) berisi metadata dan anotasi resource. Gunakan perintah berikut untuk membuat dan memperbarui objek media ini.

Membuat aset warehouse video streaming

Setelah membuat gudang (resource corpus), Anda dapat menambahkan satu atau beberapa resource video asset ke gudang.

REST & CMD LINE

Kode berikut membuat aset baru di gudang tertentu (corpus) dengan opsi untuk menentukan ID aset dan TTL.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan LOCATION_ID seperti europe-west4-. Lihat informasi selengkapnya tentang endpoint yang diregionalkan.
• PROJECT_NUMBER: Nomor project Google CloudAnda.
• LOCATION_ID: Region tempat Anda menggunakan Agent Platform Vision. Misalnya: us-central1, europe-west4. Lihat wilayah yang tersedia.
• CORPUS_ID: ID korpus target Anda.
• ASSET_ID: (Opsional) Nilai yang diberikan pengguna untuk ID aset. Dalam permintaan ini, nilai ditambahkan ke URL permintaan dalam bentuk:
  • https://ENDPOINT/v1/[...]/corpora/CORPUS_ID/assets?asset_id=ASSET_ID
• TIME_TO_LIVE: Jumlah waktu aktif (TTL) untuk semua aset dalam korpus, atau TTL aset tertentu. Misalnya, untuk korpus dengan aset yang memiliki TTL 100 hari, berikan nilai 8640000 (detik).

Metode HTTP dan URL:

POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets

Meminta isi JSON:

{
  "ttl": {
    "seconds": TIME_TO_LIVE
  }
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets"

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID",
  "ttl": "TIME_TO_LIVEs"
}

SDK Visi Platform Agen Gemini Enterprise

Untuk mengirim permintaan guna membaca aliran output model, Anda harus menginstal Gemini Enterprise Agent Platform Vision SDK.

Saat menggunakan alat command line vaictl untuk membuat aset, Anda tidak dapat menentukan ID atau TTL aset.

Lakukan penggantian variabel berikut:

• PROJECT_NUMBER: Nomor project Google Cloud Anda.
• LOCATION_ID: ID lokasi Anda. Contoh, us-central1. Wilayah yang didukung. Informasi selengkapnya.
• CORPUS_ID: ID gudang target (resource corpus).

vaictl --project-id=PROJECT_NUMBER \
--location-id=LOCATION_ID \
--service-endpoint=warehouse-visionai.googleapis.com \
create asset CORPUS_ID

Setelah aset dibuat, Anda dapat memasukkan data video langsung ke dalam warehouse untuk aset tersebut menggunakan alat command line vaictl.

Memperbarui aset warehouse video streaming

Gunakan contoh kode berikut untuk memperbarui masa aktif (TTL) aset. Anda hanya dapat memperbarui kolom TTL.

Gunakan parameter kueri updateMask dalam contoh kode berikut untuk memperbarui TTL aset. Anda dapat menggunakan parameter kueri untuk memperbarui kolom TTL saja. updateMask berfungsi sebagai berikut:

• Jika ditentukan, hanya kolom di updateMask yang diperbarui.
• Jika nilai mask update adalah *, permintaan akan memperbarui semua kolom.

• Jika mask update tidak ditentukan, hanya kolom di URL permintaan dengan nilai yang diberikan dalam isi permintaan yang diperbarui.

REST & CMD LINE

Contoh kode berikut mengubah TTL aset menggunakan metode projects.locations.corpora.assets.patch.

Mengubah nilai TTL

Contoh ini menggunakan ?updateMask=ttl di URL permintaan, dan menyertakan nilai ttl.seconds baru di isi permintaan untuk memperbarui aset.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan LOCATION_ID seperti europe-west4-. Lihat informasi selengkapnya tentang endpoint yang diregionalkan.
• PROJECT_NUMBER: Nomor project Google CloudAnda.
• LOCATION_ID: Region tempat Anda menggunakan Agent Platform Vision. Misalnya: us-central1, europe-west4. Lihat wilayah yang tersedia.
• CORPUS_ID: ID korpus target Anda.
• ASSET_ID: ID aset target Anda.
• ?updateMask=fieldToUpdate: Salah satu kolom yang tersedia yang dapat Anda terapkan updateMask. Kolom yang tersedia:
  • Time-to-live (TTL): ?updateMask=ttl
  • Perbarui semua kolom: ?updateMask=*

Metode HTTP dan URL:

PATCH https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl

Meminta isi JSON:

{
  "ttl": {
    "seconds": "1"
  }
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl"

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID"
}

Menghapus nilai TTL

Contoh ini menggunakan ?updateMask=ttl di URL permintaan, dan menyertakan isi permintaan kosong untuk menghapus nilai TTL aset.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan LOCATION_ID seperti europe-west4-. Lihat informasi selengkapnya tentang endpoint yang diregionalkan.
• PROJECT_NUMBER: Nomor project Google CloudAnda.
• LOCATION_ID: Region tempat Anda menggunakan Agent Platform Vision. Misalnya: us-central1, europe-west4. Lihat wilayah yang tersedia.
• CORPUS_ID: ID korpus target Anda.
• ASSET_ID: ID aset target Anda.
• ?updateMask=fieldToUpdate: Salah satu kolom yang tersedia yang dapat Anda terapkan updateMask. Kolom yang tersedia:
  • Time-to-live (TTL): ?updateMask=ttl
  • Perbarui semua kolom: ?updateMask=*

Metode HTTP dan URL:

PATCH https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl

Meminta isi JSON:

{}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl"

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID"
}