Halaman ini diterjemahkan oleh Cloud Translation API.

Mengelola anotasi

Vision Warehouse API memungkinkan Anda mengelola resource Vision Warehouse menggunakan command line.

Penyimpanan yang terhubung (corpus) di aplikasi yang di-deploy untuk menyerap data memiliki satu atau beberapa objek media (misalnya, resource video). Objek media ini (resource asset) berisi metadata dan anotasi resource (annotations). Bergantung pada model yang digunakan pada objek media, anotasi ini dapat berisi berbagai jenis informasi seperti label, kotak pembatas, dan stempel waktu.

Gunakan perintah berikut untuk mengelola anotasi ini.

Ada dua jenis anotasi:

Anotasi tingkat aset: Anotasi yang diterapkan ke seluruh aset. Contoh: camera-location.
Anotasi tingkat partisi: Anotasi yang hanya diterapkan ke bagian aset. Anda harus menentukan partisi temporal (waktu mulai dan waktu berakhir) untuk streaming aset video atau partisi temporal relatif (offset awal atau offset akhir) untuk aset video batch guna mendapatkan informasi anotasi tingkat partisi.

Sebelum membuat anotasi, Anda harus membuat skema data yang sesuai dengan kunci yang sama untuk menunjukkan jenis data nilai anotasi. Jika perlu mengubah jenis nilai kunci tertentu, Anda harus menghapus semua anotasi menggunakan kunci ini. Setelah menghapus anotasi ini, Anda dapat memperbarui skema data yang sesuai.

Membuat anotasi aset warehouse

Anda harus menyelesaikan langkah-langkah berikut sebelum dapat membuat anotasi untuk aset:

Buat resource asset di warehouse.
Buat resource dataSchema dengan kunci yang sama untuk menunjukkan jenis data nilai annotation.

Secara opsional, resource annotation dapat memiliki partisi temporal yang terkait dengannya. Misalnya, jika anotasi berlaku untuk seluruh aset, Anda dapat menghapus partisi temporal yang terkait dengannya. Demikian pula, jika anotasi hanya berlaku untuk bagian tertentu dari aset video, Anda dapat memberikan rentang waktu aset saat membuat resource annotation.

Membuat anotasi tanpa partisi temporal

Jika anotasi berlaku untuk seluruh aset video, Anda tidak perlu menyediakan partisi temporal untuknya. Gunakan contoh berikut untuk membuat resource annotation untuk seluruh aset (tidak ada jangka waktu video yang ditentukan).

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti europe-west4-. Lihat selengkapnya tentang endpoint yang diregionalkan.
PROJECT_NUMBER: Nomor project Google CloudAnda.
LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
CORPUS_ID: ID korpus target Anda.
ASSET_ID: ID aset target Anda.
ANNOTATION_ID: (Opsional) Nilai yang diberikan pengguna untuk ID anotasi. Dalam permintaan ini, nilai ditambahkan ke URL permintaan dalam bentuk:
- https://ENDPOINT/v1/[...]/corpora/CORPUS_ID/assets/ASSET_ID/annotations?annotation_id=ANNOTATION_ID

Metode HTTP dan URL:

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

Isi JSON permintaan:

{
  "user_specified_annotation":{
    "key": "camera-location",
    "value": {
      "str_value": "Sunnyvale"
    }
  }
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan 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/ASSET_ID/annotations"

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan 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/ASSET_ID/annotations" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID/annotations/ANNOTATION_ID",
  "userSpecifiedAnnotation": {
    "key": "camera-location",
    "value": {
      "strValue": "Sunnyvale"
    }
  }
}

Membuat anotasi dengan partisi temporal

Jika anotasi hanya berlaku untuk sebagian aset video streaming, Anda dapat memberikan rentang waktu untuk bagian video target. Gunakan contoh berikut untuk membuat resource annotation untuk jangka waktu tertentu dari aset video menggunakan partisi temporal.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti europe-west4-. Lihat selengkapnya tentang endpoint yang diregionalkan.
PROJECT_NUMBER: Nomor project Google CloudAnda.
LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
CORPUS_ID: ID korpus target Anda.
ASSET_ID: ID aset target Anda.
ANNOTATION_ID: (Opsional) Nilai yang diberikan pengguna untuk ID anotasi. Dalam permintaan ini, nilai ditambahkan ke URL permintaan dalam bentuk:
- https://ENDPOINT/v1/[...]/corpora/CORPUS_ID/assets/ASSET_ID/annotations?annotation_id=ANNOTATION_ID

Metode HTTP dan URL:

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

Isi JSON permintaan:

{
  "user_specified_annotation": {
    "key": "object-detected",
    "value": {
      "str_value": "cat"
    },
    "partition": {
      "temporal_partition": {
        "start_time": {
          "seconds": "1630464728"
        },
        "end_time": {
          "seconds": "1630464729"
        }
      }
    }
  }
}

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/annotations"

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/annotations" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID/annotations/ANNOTATION_ID",
  "userSpecifiedAnnotation": {
    "key": "object-detected",
    "value": {
      "strValue": "cat"
    },
    "partition": {
      "temporalPartition": {
        "startTime": "2022-09-14T20:33:09Z",
        "endTime": "2022-09-14T20:33:39Z"
      }
    }
  }
}

Membuat anotasi dengan partisi temporal relatif

Jika anotasi hanya berlaku untuk sebagian aset video batch, Anda dapat memberikan rentang waktu untuk bagian video target. Gunakan contoh berikut untuk membuat resource annotation untuk jangka waktu tertentu dari aset video menggunakan partisi temporal relatif.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti europe-west4-. Lihat selengkapnya tentang endpoint yang diregionalkan.
PROJECT_NUMBER: Nomor project Google CloudAnda.
LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
CORPUS_ID: ID korpus target Anda.
ASSET_ID: ID aset target Anda.
ANNOTATION_ID: (Opsional) Nilai yang diberikan pengguna untuk ID anotasi. Dalam permintaan ini, nilai ditambahkan ke URL permintaan dalam bentuk:
- https://ENDPOINT/v1/[...]/corpora/CORPUS_ID/assets/ASSET_ID/annotations?annotation_id=ANNOTATION_ID

Metode HTTP dan URL:

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

Isi JSON permintaan:

{
  "user_specified_annotation": {
    "key": "object-detected",
    "value": {
      "str_value": "cat"
    },
    "partition": {
      "relative_temporal_partition": {
        "start_offset": {
          "seconds": "60"
        },
        "end_offset": {
          "seconds": "300"
        }
      }
    }
  }
}

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/annotations"

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/annotations" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID/annotations/ANNOTATION_ID",
  "userSpecifiedAnnotation": {
    "key": "object-detected",
    "value": {
      "strValue": "cat"
    },
    "partition": {
      "relative_temporal_partition": {
        "start_offset": "60s",
        "end_offset": "300s"
      }
    }
  }
}

Memperbarui anotasi (tanpa partisi temporal)

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti europe-west4-. Lihat selengkapnya tentang endpoint yang diregionalkan.
PROJECT_NUMBER: Nomor project Google CloudAnda.
LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
CORPUS_ID: ID korpus target Anda.
ASSET_ID: ID aset target Anda.
ANNOTATION_ID: ID anotasi target Anda.

Metode HTTP dan URL:

PATCH https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID/annotations/ANNOTATION_ID

Isi JSON permintaan:

{
 "user_specified_annotation":{
    "key": "camera-location",
    "value": {
      "str_value": "UPDATED_FIELD_VALUE"
    }
  }
}

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/annotations/ANNOTATION_ID"

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/annotations/ANNOTATION_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/annotations/ANNOTATION_ID",
  "userSpecifiedAnnotation": {
    "key": "camera-location",
    "value": {
      "strValue": "UPDATED_FIELD_VALUE"
    }
  }
}

Mencantumkan anotasi aset

Mencantumkan semua Anotasi dalam aset tertentu.

REST

Untuk mencantumkan anotasi aset, kirim permintaan GET menggunakan metode projects.locations.corpora.assets.annotations.list.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti europe-west4-. Lihat selengkapnya tentang endpoint yang diregionalkan.
PROJECT_NUMBER: Nomor project Google CloudAnda.
LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
CORPUS_ID: ID korpus target Anda.
ASSET_ID: ID aset target Anda.
PAGE_SIZE: (Opsional) Jumlah hasil yang akan ditampilkan.

Metode HTTP dan URL:

GET https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID/annotations?page_size=PAGE_SIZE

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/annotations?page_size=PAGE_SIZE"

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/annotations?page_size=PAGE_SIZE" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "annotations": [
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID/annotations/ANNOTATION_ID1",
      "userSpecifiedAnnotation": {
        "key": "object-detected",
        "value": {
          "strValue": "cat"
        },
        "partition": {
          "temporalPartition": {
            "startTime": "2022-09-14T20:33:09Z",
            "endTime": "2022-09-14T20:33:39Z"
          }
        }
      }
    },
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID/annotations/ANNOTATION_ID2",
      "userSpecifiedAnnotation": {
        "key": "object-detected",
        "value": {
          "strValue": "dog"
        },
        "partition": {
          "temporalPartition": {
            "startTime": "2022-09-14T20:33:09Z",
            "endTime": "2022-09-14T20:33:39Z"
          }
        }
      }
    }
  ],
  "nextPageToken": "ChQxMzkzNTQyNzE0MDk3NzU3NDg5MBAC"
}

Mendapatkan informasi halaman berikutnya:

Jika permintaan daftar menampilkan nextPageToken, Anda dapat menggunakan token tersebut untuk mencantumkan lebih banyak resource annotation.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti europe-west4-. Lihat selengkapnya tentang endpoint yang diregionalkan.
PROJECT_NUMBER: Nomor project Google CloudAnda.
LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
CORPUS_ID: ID korpus target Anda.
ASSET_ID: ID aset target Anda.
PAGE_SIZE: (Opsional) Jumlah hasil yang akan ditampilkan.

Metode HTTP dan URL:

GET https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID/annotations?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN

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/annotations?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN"

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/annotations?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN" | Select-Object -Expand Content

Responsnya terlihat sama dengan respons asli dan juga dapat berisi nextPageToken, bergantung pada jumlah anotasi yang tersedia.

{
  "annotations": [
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID/annotations/ANNOTATION_ID1",
      "userSpecifiedAnnotation": {
        [...]
      }
    },
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID/annotations/ANNOTATION_ID2",
      "userSpecifiedAnnotation": {
        [...]
      }
    }
  ],
  "nextPageToken": "IhXxMzkzJLIyNzPQNEk3NzU3NDg5CBIP"
}

Mendapatkan anotasi aset

REST

Untuk mendapatkan detail tentang anotasi aset, kirim permintaan GET menggunakan metode projects.locations.corpora.assets.annotations.get.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti europe-west4-. Lihat selengkapnya tentang endpoint yang diregionalkan.
PROJECT_NUMBER: Nomor project Google CloudAnda.
LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
CORPUS_ID: ID korpus target Anda.
ASSET_ID: ID aset target Anda.
ANNOTATION_ID: ID anotasi 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/annotations/ANNOTATION_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/annotations/ANNOTATION_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/annotations/ANNOTATION_ID" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPORA_ID/assets/ASSET_ID/annotations/ANNOTATIONS_ID",
  "userSpecifiedAnnotation": {
    "key": "object-detected",
    "value": {
      "strValue": "dog"
    },
    "partition": {
      "temporalPartition": {
        "startTime": "2022-09-14T20:33:09Z",
        "endTime": "2022-09-14T20:33:39Z"
      }
    }
  }
}

Mencantumkan anotasi aset dengan filter

Anda dapat menggunakan filter untuk mempersempit hasil yang ditampilkan dari permintaan daftar anotasi.

Filter yang didukung:

partition.temporal_partition.start_time^†
partition.temporal_partition.end_time^†
key

^† Stempel waktu ditentukan dalam format RFC-3339 (misalnya, 2012-04-21T11:30:00-04:00). Filter ini juga menawarkan perbandingan dan operator logika. Contoh:

GET https://warehouse-visionai.googleapis.com/v1/projects/123456789/locations/us-central1/corpora/82403458240/assets/48575742017/annotations'?page_size=5&filter=partition.temporal_partition.start_time>"2022-02-01T17:55:38-00:00"%20AND%20partition.temporal_partition.end_time<"2022-02-01T17:55:48-00:00"'

REST

Untuk mencantumkan dan memfilter anotasi aset, kirim permintaan GET menggunakan metode projects.locations.corpora.assets.annotations.list.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti europe-west4-. Lihat selengkapnya tentang endpoint yang diregionalkan.
PROJECT_NUMBER: Nomor project Google CloudAnda.
LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
CORPUS_ID: ID korpus target Anda.
ASSET_ID: ID aset target Anda.
FILTER_NAME, FILTER_VALUE: Kriteria yang ingin Anda gunakan untuk memfilter daftar yang ditampilkan. Misalnya:
- '?filter=key="KEY_VALUE"'
- '?filter=partition.temporal_partition.start_time="2022-02-01T17:55:38-00:00"'
- '?filter=partition.temporal_partition.end_time="2022-02-01T17:55:48-00:00"'

Metode HTTP dan URL:

GET https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID/annotations'?filter=FILTER_NAME="FILTER_VALUE"'

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/annotations'?filter=FILTER_NAME="FILTER_VALUE"'"

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/annotations'?filter=FILTER_NAME="FILTER_VALUE"'" | Select-Object -Expand Content

Respons bergantung pada filter yang diterapkan dan juga dapat berisi nextPageToken bergantung pada jumlah anotasi yang tersedia.

Anda juga dapat menerapkan beberapa filter dan kolom halaman (pageSize, pageToken) dalam satu permintaan:

https://ENDPOINT/v1/[...]/annotations '?filter=partition.temporal_partition.start_time="START_TIME"%20AND%20 key="KEY_VALUE"&page_token=PAGE_TOKEN'

Menghapus anotasi aset

REST

Untuk menghapus anotasi aset, kirim permintaan DELETE menggunakan metode projects.locations.corpora.assets.annotations.delete.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti europe-west4-. Lihat selengkapnya tentang endpoint yang diregionalkan.
PROJECT_NUMBER: Nomor project Google CloudAnda.
LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
CORPUS_ID: ID korpus target Anda.
ASSET_ID: ID aset target Anda.
ANNOTATION_ID: ID anotasi 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/annotations/ANNOTATION_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/annotations/ANNOTATION_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/annotations/ANNOTATION_ID" | Select-Object -Expand Content

Anda akan melihat respons JSON yang mirip seperti berikut:

{}