Membuat dan mengelola penyimpanan anotasi

Halaman ini menjelaskan cara membuat, memberi label, melihat, mencantumkan, dan menghapus penyimpanan anotasi. Penyimpanan Annotation menyimpan data anotasi, yang merupakan label yang dapat Anda tambahkan ke resource layanan kesehatan.

Untuk ringkasan penyimpanan anotasi dan catatan anotasi, lihat Anotasi.

Membuat penyimpanan anotasi

Sebelum dapat membuat penyimpanan anotasi, Anda perlu membuat set data.

Contoh berikut menunjukkan cara membuat penyimpanan anotasi.

gcloud

Untuk membuat penyimpanan anotasi, jalankan perintah gcloud beta healthcare annotation-stores create:

  • ANNOTATION_STORE_ID harus unik di dalam wilayah. String ini dapat berupa string Unicode yang terdiri dari 1 hingga 256 karakter yang terdiri dari angka, huruf, garis bawah, tanda hubung, dan titik.
gcloud beta healthcare annotation-stores create ANNOTATION_STORE_ID \
  --dataset=DATASET_ID \
  --location=LOCATION

Jika permintaan berhasil, command prompt akan menampilkan pesan berikut:

Created annotationStore [ANNOTATION_STORE_ID].

API

Untuk membuat penyimpanan anotasi, gunakan metode projects.locations.datasets.annotationStores.create.

curl

Untuk membuat penyimpanan anotasi, buat permintaan POST dan tentukan informasi berikut:

  • {i>Dataset<i} induk
  • Nama untuk penyimpanan anotasi. ID penyimpanan anotasi harus unik dalam set data induknya. Bisa berupa string Unicode apa pun dari 1 hingga 256 karakter yang terdiri dari angka, huruf, garis bawah, tanda hubung, dan titik.
  • Token akses

Contoh berikut menunjukkan permintaan POST menggunakan curl:

curl -X POST \
    --data "" \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores?annotationStoreId=ANNOTATION_STORE_ID"

Jika permintaan berhasil, server akan menampilkan respons dalam format JSON:

{
  "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID"
}

PowerShell

Untuk membuat penyimpanan anotasi, buat permintaan POST dan tentukan informasi berikut:

  • {i>Dataset<i} induk
  • Nama untuk penyimpanan anotasi. ID penyimpanan anotasi harus unik dalam set data induknya. Bisa berupa string Unicode apa pun dari 1 hingga 256 karakter yang terdiri dari angka, huruf, garis bawah, tanda hubung, dan titik.
  • Token akses

Contoh berikut menunjukkan permintaan POST menggunakan Windows PowerShell:

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

Invoke-WebRequest `
  -Method Post `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores?annotationStoreId=ANNOTATION_STORE_ID" | Select-Object -Expand Content

Jika permintaan berhasil, server akan menampilkan respons dalam format JSON:

{
  "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID"
}

Memberi label pada penyimpanan anotasi

Anda dapat menambahkan satu atau beberapa label nilai kunci ke penyimpanan anotasi. Salah satu kasus penggunaan untuk menambahkan label adalah menambahkan label dan tag untuk catatan anotasi yang terkait dengan teks atau gambar.

Contoh berikut menunjukkan cara menambahkan label ke penyimpanan anotasi.

gcloud

Gcloud CLI tidak mendukung pengeditan label penyimpanan anotasi. Sebagai gantinya, gunakan curl, Windows PowerShell, atau bahasa pilihan Anda.

API

Untuk menambahkan label ke penyimpanan anotasi, gunakan perintah projects.locations.datasets.annotationStores.patch.

curl

Untuk memberi label penyimpanan anotasi, buat permintaan PATCH dan berikan informasi berikut:

  • Nama set data induk
  • Nama penyimpanan anotasi
  • Data label yang akan diperbarui
  • Mask pembaruan
  • Token akses

Contoh berikut menunjukkan permintaan PATCH yang menggunakan curl.

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    --data "{
      'labels': {
        'KEY': 'VALUE'
      }
    }" \
    "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID?updateMask=labels"

Jika permintaan berhasil, server akan menampilkan respons dalam format JSON:

{
  "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID",
  "labels": {
    "KEY": "VALUE"
  }
}

PowerShell

Untuk memberi label penyimpanan anotasi, buat permintaan PATCH dan berikan informasi berikut:

  • Nama set data induk
  • Nama penyimpanan anotasi
  • Data label yang akan diperbarui
  • Mask pembaruan
  • Token akses

Contoh berikut menunjukkan permintaan PATCH menggunakan Windows PowerShell.

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

Invoke-WebRequest `
  -Method Patch `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -Body "{
      'labels': {
        'KEY': 'VALUE'
      }
  }" `
  -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID?updateMask=labels" | Select-Object -Expand Content

Jika permintaan berhasil, server akan menampilkan respons dalam format JSON:

{
  "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID",
  "labels": {
    "KEY": "VALUE"
  }
}

Mendapatkan detail penyimpanan anotasi

Contoh berikut menunjukkan cara mendapatkan detail tentang penyimpanan anotasi.

gcloud

Untuk mendapatkan detail tentang penyimpanan anotasi, jalankan perintah gcloud beta healthcare annotation-stores describe:

gcloud beta healthcare annotation-stores describe ANNOTATION_STORE_ID \
  --dataset=DATASET_ID \
  --location=LOCATION

Jika permintaan berhasil, command prompt akan menampilkan detail penyimpanan anotasi:

name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/annotation-stores/ANNOTATION_STORE_ID

API

Untuk mendapatkan detail tentang penyimpanan anotasi, gunakan metode projects.locations.datasets.annotationStores.get.

curl

Untuk mendapatkan detail tentang penyimpanan anotasi, buat permintaan GET dan berikan informasi berikut:

  • Nama set data induk
  • Nama penyimpanan anotasi
  • Token akses

Contoh berikut menunjukkan permintaan GET yang menggunakan curl.

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID"

Jika permintaan berhasil, server akan menampilkan respons dalam format JSON:

{
  "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID"
}

Jika Anda mengonfigurasi kolom apa pun dalam resource AnnotationStore, kolom tersebut juga akan muncul dalam respons.

PowerShell

Untuk mendapatkan detail tentang penyimpanan anotasi, buat permintaan GET dan berikan informasi berikut:

  • Nama set data induk
  • Nama penyimpanan anotasi
  • Token akses

Contoh berikut menunjukkan permintaan GET menggunakan Windows PowerShell.

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

Invoke-WebRequest `
  -Method Get `
  -Headers $headers `
  -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID" | Select-Object -Expand Content

Jika permintaan berhasil, server akan menampilkan respons dalam format JSON:

{
  "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID"
}

Jika Anda mengonfigurasi kolom apa pun dalam resource AnnotationStore, kolom tersebut juga akan muncul dalam respons.

Anotasi listingan disimpan dalam set data

Contoh berikut menunjukkan cara mencantumkan anotasi yang disimpan dalam set data.

gcloud

Untuk menampilkan daftar yang disimpan anotasi dalam set data, jalankan perintah gcloud beta healthcare annotation-stores list:

gcloud beta healthcare annotation-stores list \
  --dataset=DATASET_ID \
  --location=LOCATION

Jika permintaan berhasil, command prompt akan mencantumkan penyimpanan anotasi:

ID                   LOCATION
ANNOTATION_STORE_ID  LOCATION

API

Untuk mencantumkan anotasi yang disimpan dalam set data, gunakan metode projects.locations.datasets.annotationStores.list.

curl

Untuk mencantumkan penyimpanan anotasi dalam set data, buat permintaan GET dan berikan informasi berikut:

  • Nama set data induk
  • Token akses

Contoh berikut menunjukkan permintaan GET yang menggunakan curl.

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores"

Jika permintaan berhasil, server akan menampilkan respons dalam format JSON:

{
  "annotationStores": [
    {
      "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID"
    },
    {
      ...
    }
  ]
}

Jika Anda mengonfigurasi kolom apa pun dalam resource AnnotationStore, kolom tersebut juga akan muncul dalam respons.

PowerShell

Untuk mencantumkan penyimpanan anotasi dalam set data, buat permintaan GET dan berikan informasi berikut:

  • Nama set data induk
  • Token akses

Contoh berikut menunjukkan permintaan GET menggunakan Windows PowerShell.

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

Invoke-WebRequest `
  -Method Get `
  -Headers $headers `
  -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores" | Select-Object -Expand Content

Jika permintaan berhasil, server akan menampilkan respons dalam format JSON:

{
  "annotationStores": [
    {
      "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID"
    },
    {
      ...
    }
  ]
}

Jika Anda mengonfigurasi kolom apa pun dalam resource AnnotationStore, kolom tersebut juga akan muncul dalam respons.

Menghapus penyimpanan anotasi

Contoh berikut menunjukkan cara menghapus penyimpanan anotasi.

gcloud

Untuk menghapus penyimpanan anotasi, jalankan perintah gcloud beta healthcare annotation-stores delete:

  1. Jalankan perintah delete.

    gcloud beta healthcare annotation-stores delete ANNOTATION_STORE_ID \
      --dataset=DATASET_ID \
      --location=LOCATION
  2. Untuk mengonfirmasi, ketik Y.

Jika permintaan berhasil, command prompt akan menampilkan hal berikut:

Deleted annotationStore [ANNOTATION_STORE_ID].

API

Untuk menghapus penyimpanan anotasi, gunakan perintah projects.locations.datasets.annotationStores.delete.

curl

Untuk menghapus penyimpanan anotasi, buat permintaan DELETE dan berikan informasi berikut:

  • Nama set data induk
  • Nama penyimpanan anotasi
  • Token akses

Contoh berikut menunjukkan permintaan DELETE yang menggunakan curl.

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID"

Jika permintaan berhasil, server akan menampilkan isi respons kosong dalam format JSON:

{}

PowerShell

Untuk menghapus penyimpanan anotasi, buat permintaan DELETE dan berikan informasi berikut:

  • Nama set data induk
  • Nama penyimpanan anotasi
  • Token akses

Contoh berikut menunjukkan permintaan DELETE menggunakan Windows PowerShell.

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

Invoke-WebRequest `
  -Method Delete `
  -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID" | Select-Object -Expand Content

Jika permintaan berhasil, server akan menampilkan isi respons kosong dalam format JSON:

{}