Membuat dan mengelola catatan anotasi

Halaman ini menjelaskan cara membuat, melihat, mencantumkan, dan menghapus catatan anotasi. Contoh data anotasi mencakup label dan tag untuk teks, gambar, dan audio perawatan kesehatan. Untuk ringkasan penyimpanan anotasi dan catatan anotasi, lihat Anotasi.

Membuat catatan anotasi

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

Contoh berikut menunjukkan cara membuat catatan anotasi. Untuk mengetahui informasi selengkapnya, lihat projects.locations.datasets.annotationStores.annotations.create.

curl

Untuk membuat data anotasi, buat permintaan POST dan berikan informasi berikut:

  • Nama set data induk
  • Nama penyimpanan anotasi induk
  • Sumber catatan anotasi
  • Jenis catatan anotasi
  • Token akses

Contoh berikut menunjukkan permintaan POST menggunakan curl yang membuat data anotasi untuk gambar DICOM. Anotasi ini menggunakan kotak pembatas untuk menandai dimensi bagian gambar dan melabeli area yang dibatasi dengan nama "kotak pembatas". Contoh ini mengasumsikan bahwa Anda telah menyimpan instance DICOM di penyimpanan DICOM. Instance DICOM ini dirujuk dalam kolom name pada cloudHealthcareSource.

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    --data "{
      'annotationSource': {
        'cloudHealthcareSource': {
          'name': 'projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID'
        }
      },
      'imageAnnotation': {
        'boundingPolys': [
          {
            'vertices': [
              {
                'x': 100,
                'y': 100
              },
              {
                'x': 100,
                'y': 400
              },
              {
                'x': 400,
                'y': 100
              },
              {
                'x': 400,
                'y': 400
              }
            ],
            'label': 'bounding-box'
          }
        ]
      }
    }" \
    "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID/annotations"

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

{
  "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID/annotations/ANNOTATION_ID",
  "annotationSource": {
    "cloudHealthcareSource": {
      "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID"
    }
  },
  "imageAnnotation": {
    "boundingPolys": [
      {
        "vertices": [
          {
            "x": 100,
            "y": 100
          },
          {
            "x": 100,
            "y": 400
          },
          {
            "x": 400,
            "y": 100
          },
          {
            "x": 400,
            "y": 400
          }
        ],
        "label": "bounding-box"
      }
    ]
  }
}

PowerShell

Untuk membuat data anotasi, buat permintaan POST dan berikan informasi berikut:

  • Nama set data induk
  • Nama penyimpanan anotasi induk
  • Sumber catatan anotasi
  • Jenis catatan anotasi
  • Token akses

Contoh berikut menunjukkan permintaan POST menggunakan Windows PowerShell yang membuat data anotasi untuk gambar DICOM. Anotasi ini menggunakan kotak pembatas untuk menandai dimensi bagian gambar dan melabeli area yang dibatasi dengan nama "kotak pembatas". Contoh ini mengasumsikan bahwa Anda telah menyimpan instance DICOM di penyimpanan DICOM. Instance DICOM ini dirujuk dalam kolom name pada cloudHealthcareSource.

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

Invoke-WebRequest `
  -Method Post `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -Body "{
    'annotationSource': {
      'cloudHealthcareSource': {
        'name': 'projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID'
      }
    },
    'imageAnnotation': {
      'boundingPolys': [
        {
          'vertices': [
            {
              'x': 100,
              'y': 100
            },
            {
              'x': 100,
              'y': 400
            },
            {
              'x': 400,
              'y': 100
            },
            {
              'x': 400,
              'y': 400
            }
          ],
          'label': 'bounding-box'
        }
      ]
    }
  }" `
  -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID/annotations" | 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/annotations/ANNOTATION_ID",
  "annotationSource": {
    "cloudHealthcareSource": {
      "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID"
    }
  },
  "imageAnnotation": {
    "boundingPolys": [
      {
        "vertices": [
          {
            "x": 100,
            "y": 100
          },
          {
            "x": 100,
            "y": 400
          },
          {
            "x": 400,
            "y": 100
          },
          {
            "x": 400,
            "y": 400
          }
        ],
        "label": "bounding-box"
      }
    ]
  }
}

Mengedit catatan anotasi

Contoh berikut menunjukkan cara mengedit data anotasi dari Membuat data anotasi sehingga memiliki label jenis resource. Untuk informasi selengkapnya, lihat projects.locations.datasets.annotationStores.annotations.patch.

curl

Untuk mengedit data anotasi, buat permintaan PATCH dan berikan informasi berikut:

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

Contoh berikut menunjukkan permintaan PATCH yang menggunakan curl pada data anotasi untuk instance DICOM.

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

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

{
  "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID/annotations/ANNOTATION_ID",
  "annotationSource": {
    "cloudHealthcareSource": {
      "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID"
    }
  },
  "resourceAnnotation": {
    "label": "VALUE"
  }
}

PowerShell

Untuk mengedit data anotasi, buat permintaan PATCH dan berikan informasi berikut:

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

Contoh berikut menunjukkan permintaan PATCH menggunakan Windows PowerShell pada data anotasi untuk instance DICOM.

$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 "{
    'resourceAnnotation': {
      'label': 'VALUE'
    }
  }" `
  -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID/annotations/ANNOTATION_ID?updateMask=resourceAnnotation" | 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/annotations/ANNOTATION_ID",
  "annotationSource": {
    "cloudHealthcareSource": {
      "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID"
    }
  },
  "resourceAnnotation": {
    "label": "VALUE"
  }
}

Mendapatkan detail rekaman anotasi

Contoh berikut menunjukkan cara mendapatkan detail tentang catatan anotasi. Untuk mengetahui informasi selengkapnya, lihat projects.locations.datasets.annotationStores.annotations.get.

curl

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

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

Contoh berikut menunjukkan permintaan GET yang menggunakan curl guna melihat data anotasi untuk instance DICOM.

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

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

{
  "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID/annotations/ANNOTATION_ID",
  "annotationSource": {
    "cloudHealthcareSource": {
      "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID"
    }
  }
}

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

PowerShell

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

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

Contoh berikut menunjukkan permintaan GET menggunakan Windows PowerShell untuk melihat data anotasi untuk instance DICOM.

$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/annotations/ANNOTATION_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/annotations/ANNOTATION_ID",
  "annotationSource": {
    "cloudHealthcareSource": {
      "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID"
    }
  }
}

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

Mencantumkan catatan anotasi di penyimpanan anotasi

Contoh berikut menunjukkan cara mencantumkan catatan anotasi di penyimpanan anotasi. Untuk informasi selengkapnya, lihat projects.locations.datasets.annotationStores.annotations.list.

curl

Untuk mencantumkan catatan anotasi di 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 di penyimpanan anotasi yang berisi data anotasi untuk instance DICOM.

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

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

{
  "annotations": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID/annotations/ANNOTATION_ID",
      "annotationSource": {
        "cloudHealthcareSource": {
          "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID"
        }
      }
    }
  ]
}

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

PowerShell

Untuk mencantumkan catatan anotasi di 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 Windows PowerShell di penyimpanan anotasi yang berisi data anotasi untuk instance DICOM.

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

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

{
  "annotations": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID/annotations/ANNOTATION_ID",
      "annotationSource": {
        "cloudHealthcareSource": {
          "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID"
        }
      }
    }
  ]
}

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

Menghapus catatan anotasi

Contoh berikut menunjukkan cara menghapus data anotasi. Untuk mengetahui informasi selengkapnya, lihat projects.locations.datasets.annotationStores.annotations.delete.

curl

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

  • Nama set data induk
  • Nama penyimpanan anotasi induk
  • ID pencatatan 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/annotations/ANNOTATION_ID"

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

{}

PowerShell

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

  • Nama set data induk
  • Nama penyimpanan anotasi induk
  • ID pencatatan 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/annotations/ANNOTATION_ID" | Select-Object -Expand Content

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

{}