Vision Warehouse API memungkinkan Anda mengelola resource Vision Warehouse menggunakan command line.
Warehouse yang terhubung (corpus
) di aplikasi yang di-deploy dan menyerap data memiliki satu atau beberapa objek media (misalnya, resource video). Objek media ini (resource asset
) berisi metadata dan anotasi resource. Gunakan perintah berikut untuk mengelola objek media ini.
Membuat resource aset
REST
Untuk membuat resource aset, kirim permintaan POST menggunakan
metode
projects.locations.corpora.assets.create
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI 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
Isi JSON permintaan:
{ }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
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
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" }
Memperbarui resource aset
Aset update hanya tersedia untuk aset video streaming.
REST
Untuk memperbarui resource aset, kirim permintaan PATCH menggunakan
metode projects.locations.corpora.assets.patch
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI 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 terapkanupdateMask
. Kolom yang tersedia:- Time-to-live (TTL):
?updateMask=ttl
- Perbarui semua kolom:
?updateMask=*
- Time-to-live (TTL):
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
Isi JSON permintaan:
{ "ttl": { "seconds": "1" } }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
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
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" }
Mencantumkan aset di gudang
REST
Untuk mencantumkan aset dalam korpus, kirim permintaan GET menggunakan metode projects.locations.corpora.assets.list.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - CORPUS_ID: ID korpus target Anda.
Metode HTTP dan URL:
GET https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets"
PowerShell
Jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-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:
{ "assets": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID1", "ttl": "86400s" }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID2", "ttl": "86400s" } ] }
Mendapatkan aset
REST
Untuk mendapatkan detail tentang aset, kirim permintaan GET menggunakan metode projects.locations.corpora.assets.get.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - CORPUS_ID: ID korpus target Anda.
- ASSET_ID: ID aset target Anda.
Metode HTTP dan URL:
GET https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID"
PowerShell
Jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID" | 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": "86400s" }
Menghapus aset media
Contoh berikut menghapus aset gudang, sehingga anotasi apa pun yang terkait dengannya tidak dapat diakses dan dihapus dari hasil penelusuran.
REST & CMD LINE
Contoh kode berikut menghapus aset di gudang menggunakan metode
projects.locations.corpora.assets.delete
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - CORPUS_ID: ID korpus target Anda.
- ASSET_ID: ID aset target Anda.
Metode HTTP dan URL:
DELETE https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID"
PowerShell
Jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID" | Select-Object -Expand Content
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID/operations/OPERATION_ID" }
Mendapatkan status operasi
Untuk mendapatkan status operasi yang berjalan lama, panggil metode
projects.locations.operations.get
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - OPERATION_ID: ID operasi yang ditampilkan saat Anda memulai operasi yang berjalan lama. Contoh:
- projects/123456/locations/us-central1/[...]/operations/OPERATION_ID
Metode HTTP dan URL:
GET https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/warehouseoperations/OPERATION_ID
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/warehouseoperations/OPERATION_ID"
PowerShell
Jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/warehouseoperations/OPERATION_ID" | Select-Object -Expand Content
GetAsset
atau ListAssets
.
Pengelolaan data media aset
Konten media untuk aset dapat di-ingest ke Vision Warehouse melalui berbagai API.
Aset video streaming
Untuk mengelola konten media untuk aset video streaming, lihat petunjuk berikut.
Mendapatkan aset klip video menggunakan partisi temporal
Setelah membuat gudang dan menyimpan sumber daya video asset
di
gudang, Anda dapat mengambil klip video tertentu. Anda dapat mengirim
ClipAssetRequest
untuk mendapatkan data media
selama rentang waktu yang Anda tentukan.
Saat mengirim ClipAssetRequest
, Anda harus menentukan hal berikut:
temporal_partition
- Rentang tanggal untuk klip yang diinginkan.
Contoh berikut mempertimbangkan gudang yang berisi aset dengan rekaman kamera keamanan untuk awal September 2021 yang belum melampaui waktu aktif (TTL).
Untuk mendapatkan klip periode yang dimulai dari 1/9/2021 02.51.59 GMT hingga 1/9/2021 02.52.30 GMT, Anda harus mengonversi waktu mulai dan berakhir ke google.protobuf.Timestamp, yang dinyatakan dalam durasi sejak epoch Unix. Setelah mengonversi waktu mulai dan selesai, Anda dapat mengirim permintaan yang mirip dengan berikut ini:
REST
Untuk mendapatkan detail tentang klip video, kirim permintaan GET menggunakan metode projects.locations.corpora.assets.clip.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - CORPUS_ID: ID korpus target Anda.
- ASSET_ID: ID aset target Anda.
- START_TIME: Waktu mulai partisi, dinyatakan dalam durasi sejak epoch Unix (misalnya,
1630464719
). - END_TIME: Waktu berakhir partisi, dinyatakan dalam durasi sejak epoch Unix (misalnya,
1630464750
).
Metode HTTP dan URL:
POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID:clip
Isi JSON permintaan:
{ "temporal_partition": { "start_time": { "seconds": START_TIME }, "end_time": { "seconds": END_TIME } } }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
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/ASSET_ID:clip"
PowerShell
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/ASSET_ID:clip" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{ "time_indexed_uris" : { "temporal_partition" : { "start_time" : { "seconds": 1630464719 }, "end_time" : { "seconds": 1630464729 } }, "uri": "[...]" } }
time_indexed_uris
mencakup URI dengan link ke klip yang diambil dan
temporal_partition
yang memerinci waktu mulai dan waktu berakhir klip.
Anda dapat mengakses
link yang diberikan di kolom uri
hingga 12 jam.
Klip yang ditampilkan hanya akan menampilkan klip singkat dari konten pertama yang tersedia setelah start_time
, tetapi sebelum end_time
. Konten ini mungkin
melampaui batas temporal dalam permintaan. Misalnya, dalam contoh permintaan, klip yang ditampilkan hanya mencakup klip 10 detik yang terjadi setelah
1630464719
, meskipun mungkin masih ada konten lain yang terjadi setelah
1630464729
, dan sebelum end_time
(1630464750
).
Klip yang ditampilkan mungkin tidak memiliki durasi yang sama persis dengan yang Anda minta. Perilaku ini diharapkan dan dapat disebabkan oleh beberapa alasan:
- Rentang waktu yang diminta melebihi batas ukuran data 100 MB.
- Rentang waktu yang diminta berisi data yang telah melampaui time-to-live (TTL).
- Rentang waktu yang diminta tidak memiliki data.
Mendapatkan aset klip video menggunakan live streaming HTTP
Setelah membuat gudang dan menyerap data video (gudang assets
) di gudang, Anda dapat meminta URI ke manifes streaming video HTTP Live Streaming (HLS) untuk serangkaian segmen waktu tertentu. Anda dapat mengirim GenerateHlsUriRequest
untuk mendapatkan data media selama serangkaian rentang waktu yang Anda tentukan.
Saat mengirim GenerateHlsUriRequest
, Anda harus menentukan hal berikut:
temporal_partitions
- Kumpulan rentang tanggal untuk konten yang diinginkan yang ingin Anda streaming. Total durasi harus kurang dari 24 jam.
Contoh berikut menggunakan aset gudang dengan rekaman kamera keamanan untuk September 2021 yang belum melampaui time-to-live (TTL). Isi permintaan contoh menentukan dua periode waktu video:
- 1/9/2021 2.51.59 GMT hingga 1/9/2021 2.52.30 GMT
- 1/9/2021 4.59.00 GMT hingga 1/9/2021 5.05.30 GMT
Pertama-tama, Anda perlu mengonversi waktu mulai dan berakhir ke format google.protobuf.Timestamp, yang dinyatakan dalam durasi sejak epoch Unix. Setelah mengonversi waktu ini ke waktu Unix, Anda dapat mengirim permintaan yang mirip dengan berikut:
REST & CMD LINE
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - CORPUS_ID: ID korpus target Anda.
- ASSET_ID: ID aset target Anda.
- START_TIME: Waktu mulai partisi, dinyatakan dalam durasi sejak epoch Unix (misalnya,
1630464719
). - END_TIME: Waktu berakhir partisi, dinyatakan dalam durasi sejak epoch Unix (misalnya,
1630464750
).
Metode HTTP dan URL:
POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID:generateHlsUri
Isi JSON permintaan:
{ "temporal_partitions": { "start_time": { "seconds": 1630464719 }, "end_time": { "seconds": 1630464750 } }, "temporal_partitions": { "start_time": { "seconds": 1630472340 }, "end_time": { "seconds": 1630472730 } } }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
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/ASSET_ID:generateHlsUri"
PowerShell
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/ASSET_ID:generateHlsUri" | Select-Object -Expand Content
uri
dalam respons memiliki link untuk mendownload manifes HLS yang sesuai dengan
waktu yang diminta dan setiap temporal_partitions
menjelaskan waktu mulai dan berakhir
klip yang disertakan dalam streaming. Link yang diberikan di kolom uri
dapat diakses
hingga 12 jam.
Respons dapat mencakup beberapa objek temporal_partitions
. Setiap
objek temporal_partitions
mewakili klip individual dalam rentang
waktu yang diminta. Klip akan dipecah jika media sumber tidak berisi data untuk jangka waktu dalam rentang yang diminta, atau jika permintaan menyertakan rentang tanggal yang tidak berurutan. Dalam contoh ini, beberapa
temporal_partitions
ditampilkan karena permintaan meminta data pada dua
waktu yang berbeda pada 1/9/2021.
Streaming yang ditampilkan mungkin tidak memiliki durasi yang sama persis dengan yang Anda minta. Hal ini wajar dan dapat disebabkan oleh alasan berikut:
- Rentang waktu yang diminta berisi data yang telah melampaui waktu aktifnya
- Rentang waktu yang diminta tidak memiliki data
{ "uri": "[...]", "temporal_partitions": { "start_time": { "seconds": 1630464719 }, "end_time": { "seconds": 1630464750 } }, "temporal_partitions": { "start_time": { "seconds": 1630472340 }, "end_time": { "seconds": 1630472730 } } }
Melihat livestream dengan HLS
Anda dapat mengakses live stream HTTP (HLS) konten yang saat ini sedang di-ingest.
Kirim GenerateHlsUriRequest
untuk mendapatkan URI ke manifes streaming video HLS ini, yang diperbarui saat konten baru diserap. Livestream memiliki tiga menit konten yang ditampilkan sebelumnya, berhenti saat penyerapan berhenti, dan dimulai ulang untuk konten baru. Saat Anda mengirim GenerateHlsUriRequest
, tentukan live_view_enabled
. Ini adalah opsi untuk menampilkan livestream aset secara eksklusif,
dengan data backlog hingga tiga menit. Setel ke benar (true).
Anda dapat mengirim permintaan yang mirip dengan berikut ini:
REST & CMD LINE
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - CORPUS_ID: ID korpus target Anda.
- ASSET_ID: ID aset target Anda.
Metode HTTP dan URL:
POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID:generateHlsUri
Isi JSON permintaan:
{ "live_view_enabled": true }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
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/ASSET_ID:generateHlsUri"
PowerShell
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/ASSET_ID:generateHlsUri" | Select-Object -Expand Content
uri
dalam respons memiliki link ke manifes HLS yang sesuai dengan daftar konten yang terus diperbarui saat data video baru diserap. Link yang diberikan di kolom
uri
dapat diakses hingga 12 jam.
{ "uri": "[...]" }
Aset gambar
Anda dapat menggunakan UploadAsset API untuk mengupload gambar ke aset untuk diproses nanti.
REST & CMD LINE
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - CORPUS_ID: ID korpus target Anda.
- ASSET_ID: ID aset target Anda.
Metode HTTP dan URL:
POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID:upload
Isi JSON permintaan:
{ "asset_source": { "asset_gcs_source": { "gcs_uri": "GCS_URI" } } }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
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/ASSET_ID:upload"
PowerShell
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/ASSET_ID:upload" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID/operations/OPERATION_ID", }
Anda dapat menggunakan ImportAssets API untuk mengimpor batch gambar dan anotasinya ke korpus.
File Cloud Storage untuk permintaan ImportAsset harus dalam format JSONL. Dalam file, setiap baris sesuai dengan satu aset dan akan dikonversi menjadi proto InputImageAsset
. Misalnya,
{"gcsUri":"gs://test/test1.png","assetId":"asset1","annotations":[{"key":"title","value":{"strValue":"cat"}}]}
{"gcsUri":"gs://test/test2.png","assetId":"asset2","annotations":[{"key":"title","value":{"strValue":"dog"}}]}
{"gcsUri":"gs://test/test3.png","assetId":"asset3","annotations":[{"key":"title","value":{"strValue":"rabbit"}}]}
Hanya satu operasi ImportAsset yang dapat terjadi pada korpus dalam satu waktu. Hanya lima operasi ImportAsset yang dapat terjadi dalam project yang sama pada waktu yang sama.
REST & CMD LINE
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - CORPUS_ID: ID korpus target Anda.
Metode HTTP dan URL:
POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets:import
Isi JSON permintaan:
{ "parent": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID, "assets_gcs_uri": GCS_URI }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
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:import"
PowerShell
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:import" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/operations/OPERATION_ID", }
Setelah aset diupload dengan gambar atau diimpor dengan gambar dan anotasi, Anda dapat menganalisis seluruh korpus sehingga Anda dapat menelusuri semua konten gambar nanti.
REST & CMD LINE
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - CORPUS_ID: ID korpus target Anda.
Metode HTTP dan URL:
POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID:analyze
Isi JSON permintaan:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
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:analyze"
PowerShell
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:analyze" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/operations/OPERATION_ID", }
Aset video batch
Anda dapat menggunakan UploadAsset API untuk mengupload video ke aset untuk diproses nanti. UploadAsset API mendukung format video umum, termasuk MP4, AVI, FLV, MKV, MOV, MXF, WMV, dan format yang dapat didekodekan oleh FFmpeg.
REST & CMD LINE
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - CORPUS_ID: ID korpus target Anda.
- ASSET_ID: ID aset target Anda.
Metode HTTP dan URL:
POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID:upload
Isi JSON permintaan:
{ "asset_source": { "asset_gcs_source": { "gcs_uri": "GCS_URI" } } }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
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/ASSET_ID:upload"
PowerShell
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/ASSET_ID:upload" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID/operations/OPERATION_ID", }
Setelah aset diupload dengan video, Anda dapat mengambil URI dengan memanggil API GenerateRetrievalUrl. Jika video yang diupload berada dalam project terpisah, Anda perlu memberikan izin ke akun layanan Vertex AI Vision. (buka IAM, centang kotak untuk menampilkan Sertakan pemberian peran yang disediakan Google, cari "Cloud Vision AI Service Agent") untuk mengaksesnya.
REST & CMD LINE
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - CORPUS_ID: ID korpus target Anda.
- ASSET_ID: ID aset target Anda.
Metode HTTP dan URL:
POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID:generateHlsUri
Isi JSON permintaan:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
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/ASSET_ID:generateHlsUri"
PowerShell
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/ASSET_ID:generateHlsUri" | Select-Object -Expand Content
uri
dalam respons memiliki link ke manifes HLS yang sesuai dengan daftar konten yang terus diperbarui saat data video baru diserap. Link yang diberikan di kolom
uri
dapat diakses hingga 12 jam.
{ "uri": "[...]" }
Setelah aset diupload dengan video, Anda dapat menganalisis aset tersebut sehingga Anda dapat menelusuri konten video nanti.
REST & CMD LINE
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - CORPUS_ID: ID korpus target Anda.
- ASSET_ID: ID aset target Anda.
Metode HTTP dan URL:
POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID:analyze
Isi JSON permintaan:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID" }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
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/ASSET_ID:analyze"
PowerShell
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/ASSET_ID:analyze" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID/operations/OPERATION_ID" }
Pengelolaan koleksi aset
Koleksi adalah penampung referensi (CollectionItems) ke resource asli. Anda dapat menambahkan aset ke koleksi dan dapat menelusuri dalam koleksi.
Membuat resource koleksi
REST
Untuk membuat resource aset, kirim permintaan POST menggunakan
metode
projects.locations.corpora.collections.create
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - CORPUS_ID: ID korpus target Anda.
- COLLECTION_ID: ID koleksi target Anda.
Metode HTTP dan URL:
POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections
Isi JSON permintaan:
{ "collection": { "display_name": "DISPLAY_NAME", "description": "COLLECTION_DESCRIPTION" } }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
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/collections"
PowerShell
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/collections" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.visionai.v1.CreateCollectionMetadata" }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.visionai.v1.Collection", "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID", "displayName": "DISPLAY_NAME", "description": "COLLECTION_DESCRIPTION" } }
Memperbarui resource koleksi
REST
Untuk memperbarui resource aset, kirim permintaan PATCH menggunakan
metode projects.locations.corpora.collections.patch
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - CORPUS_ID: ID korpus target Anda.
- COLLECTION_ID: ID koleksi target Anda.
?updateMask=fieldToUpdate
: Salah satu kolom yang tersedia yang dapat Anda terapkanupdateMask
. Kolom yang tersedia:- Nama tampilan:
?updateMask=display_name
- Deskripsi:
?updateMask=description
- Perbarui semua kolom:
?updateMask=*
- Nama tampilan:
- UPDATED_FIELD_VALUE: Nilai baru untuk kolom yang ditentukan. Dalam contoh ini, nama tampilan baru yang diberikan pengguna untuk resource koleksi.
Metode HTTP dan URL:
PATCH https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID?update_mask=display_name
Isi JSON permintaan:
{ "displayName": "UPDATED_FIELD_VALUE", "description": "Original description" }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
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/collections/COLLECTION_ID?update_mask=display_name"
PowerShell
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/collections/COLLECTION_ID?update_mask=display_name" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{ "name": "projects/PROJECT_ID/locations/LOCATION_ID/corpora/CORPORA_ID/collections/COLLECTION_ID", "displayName": "UPDATED_FIELD_VALUE", "description": "Original description" }
Mencantumkan koleksi di warehouse
REST
Untuk mencantumkan koleksi dalam korpus, kirim permintaan GET menggunakan
metode projects.locations.corpora.collections.list
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - COLLECTION_ID: ID koleksi target Anda.
Metode HTTP dan URL:
GET https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections"
PowerShell
Jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{ "corpora": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID1", "displayName": "COLLECTION_DISPLAYNAME1", "description": "COLLECTION_DESCRIPTION1" }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID2", "displayName": "COLLECTION_DISPLAYNAME2", "description": "COLLECTION_DESCRIPTION2" }, ], "nextPageToken": "ChM3MDk3NTk3Nzc2OTk3NDA3OTkzEAo" }
Mendapatkan koleksi
REST
Untuk mendapatkan detail tentang koleksi, kirim permintaan GET menggunakan
metode
projects.locations.corpora.collections.get
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - CORPUS_ID: ID korpus target Anda.
- COLLECTION_ID: ID koleksi target Anda.
Metode HTTP dan URL:
GET https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID"
PowerShell
Jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID", "displayName": "CCOLLECTION_DISPLAYNAME", "description": "CCOLLECTION__DESCRIPTION" }
Menghapus koleksi
Menghapus koleksi menggunakan contoh kode berikut. Untuk menghapus koleksi, semua item di dalamnya harus dihapus terlebih dahulu.
REST & CMD LINE
Contoh kode berikut menghapus resource collection
menggunakan metode
projects.locations.corpora.collections.delete
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - CORPUS_ID: ID korpus target Anda.
- COLLECTION_ID: ID koleksi target Anda.
Metode HTTP dan URL:
DELETE https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID"
PowerShell
Jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID" | Select-Object -Expand Content
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID/operations/OPERATION_ID" }
Menambahkan item ke koleksi
Anda dapat menambahkan item aset ke koleksi.
REST & CMD LINE
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - CORPUS_ID: ID korpus target Anda.
- ASSET_ID: ID aset target Anda.
- COLLECTION_ID: ID koleksi target Anda.
Metode HTTP dan URL:
POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID:addCollectionItem
Isi JSON permintaan:
{ "item": { "collection": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID, "type": "ASSET", "item_resource": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID" } }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
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/collections/COLLECTION_ID:addCollectionItem"
PowerShell
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/collections/COLLECTION_ID:addCollectionItem" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{ "item": { "collection": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID, "type": "ASSET", "item_resource": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID" } }
Menghapus item dari koleksi
Anda dapat menghapus item aset dari koleksi.
REST & CMD LINE
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - CORPUS_ID: ID korpus target Anda.
- COLLECTION_ID: ID koleksi target Anda.
- ASSET_ID: ID aset target Anda.
Metode HTTP dan URL:
POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID:removeCollectionItem
Isi JSON permintaan:
{ "item": { "collection": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID, "type": "ASSET", "item_resource": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID" } }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
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/collections/COLLECTION_ID:removeCollectionItem"
PowerShell
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/collections/COLLECTION_ID:removeCollectionItem" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{ "item": { "collection": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID, "type": "ASSET", "item_resource": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID" } }
Melihat semua item dalam koleksi
Anda dapat melihat semua item dalam koleksi.
REST & CMD LINE
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- REGIONALIZED_ENDPOINT: Endpoint dapat menyertakan awalan yang cocok dengan
LOCATION_ID
sepertieurope-west4-
. Lihat informasi selengkapnya tentang endpoint yang diregionalkan. - PROJECT_NUMBER: Google Cloud Nomor project Anda.
- LOCATION_ID: Region tempat Anda menggunakan
Vertex AI Vision. Misalnya:
us-central1
,europe-west4
. Lihat wilayah yang tersedia. - CORPUS_ID: ID korpus target Anda.
- COLLECTION_ID: ID koleksi target Anda.
- ASSET_ID: ID aset target Anda.
Metode HTTP dan URL:
POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID:viewCollectionItems
Isi JSON permintaan:
{ "collection": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID, "page_size": "50" }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
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/collections/COLLECTION_ID:viewCollectionItems"
PowerShell
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/collections/COLLECTION_ID:viewCollectionItems" | Select-Object -Expand Content
Anda akan menerima respons JSON yang mirip dengan yang berikut ini:
{ "next_page_token": "jfyq45", "items": { "collection": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID, "type": "ASSET", "item_resource": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID" }, "items": { "collection": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/collections/COLLECTION_ID, "type": "ASSET", "item_resource": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID" } }