Update untuk v1beta1 API

Mulai 26 Agustus 2020, v1beta1 mulai diupdate ke versi yang direvisi. Di halaman ini, versi v1beta1 sebelum tanggal tersebut disebut sebagai "v1beta1 sebelumnya". Versi setelah tanggal tersebut disebut sebagai "v1beta1 baru". Tanggal penyelesaian yang dijadwalkan saat perilaku v1beta1 sebelumnya tidak lagi diterima adalah 22 September 2020.

Halaman ini menjelaskan update yang dilakukan pada v1beta1, yang terutama menyangkut penghentian dan penambahan kolom dalam permintaan dan respons ke dan dari Cloud Healthcare API. Implementasi perubahan ini memastikan bahwa metode, resource, respons, permintaan, dan sebagainya yang umum antara v1beta1 dan v1 selaras. Bagian ini juga memberikan contoh cara bertransisi dari v1beta1 sebelumnya ke v1beta1 baru.

Perubahan anotasi

Mengimpor dan mengekspor anotasi

Pada v1beta1 sebelumnya, annotationStores.import dan annotationStores.export menggunakan parameter annotationStore untuk mengidentifikasi penyimpanan anotasi. Dalam v1beta1 baru, gunakan name, bukan annotationStore, untuk mengidentifikasi penyimpanan anotasi.

Mengevaluasi penyimpanan anotasi

Pada v1beta1 sebelumnya, annotationStores.evaluate menggunakan parameter evalStore untuk mengidentifikasi penyimpanan anotasi yang digunakan untuk dibandingkan dengan toko emas. Di v1beta1 yang baru, gunakan name, bukan evalStore, untuk mengidentifikasi penyimpanan anotasi yang digunakan untuk membandingkan dengan Golden store.

ImportAnnotationsErrorDetails dan ExportAnnotationsErrorDetails

Respons ImportAnnotationsErrorDetails dan ExportAnnotationsErrorDetails telah dihapus di v1beta1 yang baru. Sebagai gantinya, Anda dapat melihat detail tentang error apa pun di Cloud Logging.

ImportAnnotationsResponse, ExportAnnotationsResponse, dan EvaluateAnnotationStoreResponse

  • ImportAnnotationsResponse dan ExportAnnotationsResponse, yang dimuat dalam kolom Operation.response dari operasi impor atau ekspor yang berjalan lama, tidak lagi menyertakan kolom annotationStore atau kolom successCount. Sebagai gantinya, Anda dapat melihat jumlah keberhasilan dan kegagalan di kolom Operation.metadata yang ditampilkan dalam operasi yang berjalan lama yang ditampilkan.
  • EvaluateAnnotationStoreResponse, yang dimuat dalam kolom Operation.response dari operasi evaluasi yang berjalan lama, tidak lagi menyertakan kolom evalStore, goldenStore, goldenCount, atau matchedCount. Sebagai gantinya, untuk menemukan nilai matchedCount, lihat kolom success di Operation.metadata. Untuk menemukan nilai goldenCount, tambahkan nilai kolom success dan nilai kolom failure di Operation.metadata.

Perubahan de-identifikasi data

DeidentifyErrorDetails penghapusan

Respons DeidentifyErrorDetails tidak lagi tersedia di v1beta1 baru. Sebagai gantinya, Anda dapat melihat detail tentang error apa pun di Cloud Logging.

SuccessResourceCount penghapusan

Pada v1beta1 sebelumnya, respons berikut berisi kolom SuccessResourceCount:

Di v1beta1 yang baru, respons ini tidak lagi berisi kolom SuccessResourceCount. Sebagai gantinya, Anda dapat melihat resource yang berhasil dide-identifikasi oleh Cloud Healthcare API di kolom progress_counter.success respons operasi yang berjalan lama.

Penghapusan SuccessStoreCount dan FailureStoreCount

Pada v1beta1 sebelumnya, respons berikut berisi kolom SuccessStoreCount:

DeidentifyErrorDetails juga berisi kolom FailureStoreCount.

Di v1beta1 baru, respons ini tidak lagi berisi kolom SuccessStoreCount atau kolom FailureStoreCount.

FailureResourceCount penghapusan

Pada v1beta1 sebelumnya, respons berikut berisi kolom FailureResourceCount:

Di v1beta1 yang baru, respons ini tidak lagi berisi kolom FailureResourceCount. Sebagai gantinya, Anda dapat melihat resource yang gagal dide-identifikasi oleh Cloud Healthcare API di kolom progress_counter.failure respons operasi yang berjalan lama.

Perubahan DICOM

Telusuri transaksi

Pada v1beta1 sebelumnya, metode Transaksi penelusuran menampilkan kode respons 200 jika penelusuran berhasil, tetapi tidak ada hasil yang cocok dengan kueri tersebut. Isi respons juga berisi array hasil kosong.

Agar selaras dengan standar DICOM PS3.18 - Layanan Web, metode transaksi Penelusuran di v1beta1 baru akan menampilkan kode respons 204, bukan kode respons 200. Tidak ada isi respons yang ditampilkan, bukan menampilkan array hasil kosong.

Metode penghapusan DICOMweb

Pada v1beta1 sebelumnya, metode berikut menampilkan kode respons kosong saat berhasil dijalankan:

Di v1beta1 yang baru, metode ini akan menampilkan operasi yang berjalan lama. Operasi yang berjalan lama akan berisi done: true saat penghapusan selesai.

Mengimpor data DICOM dari respons Cloud Storage

Pada v1beta1 sebelumnya, metode projects.locations.datasets.dicomStores.import menampilkan ImportDicomDataErrorDetails pada objek Operation.error.status.details. Pada v1beta1 baru, metode ini tidak menampilkan respons untuk error ini. Sebagai gantinya, URL akan diisi di Operation.metadata ke Cloud Logging, tempat Anda dapat melihat detail error apa pun.

Perubahan FHIR

Pembuatan toko FHIR

Saat membuat penyimpanan FHIR, Anda harus menentukan versi FHIR (DSTU2, STU3, atau R4) untuk penyimpanan tersebut. Jika versi tidak ditentukan, Cloud Healthcare API akan menampilkan error.

Contoh:

gcloud

Contoh berikut menunjukkan cara membuat penyimpanan FHIR.

gcloud beta healthcare fhir-stores create FHIR_STORE_ID \
  --dataset=DATASET_ID \
  --location=LOCATION \
  --version={DSTU2|STU3|R4}

API

curl

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    --data "{
      'version': 'FHIR_STORE_VERSION'
    }" "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores?fhirStoreId=FHIR_STORE_ID"

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" `
  -Body "{
      'version': 'FHIR_STORE_VERSION'
  }" `
  
  -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores?fhirStoreId=FHIR_STORE_ID" | Select-Object -Expand Content

ImportResourcesResponse, ExportResourcesResponse, ImportResourcesErrorDetails, dan ExportResourcesErrorDetails

Pada v1beta1 sebelumnya, projects.locations.datasets.fhirStores.import dan projects.locations.datasets.fhirStores.export menampilkan operasi yang berjalan lama yang berisi ImportResourcesResponse dan ExportResourcesResponse, di kolom Operation.response. Jika terjadi error, ImportResourcesErrorDetails atau ExportResourcesErrorDetails akan ditampilkan di kolom Operation.error.

Di v1beta1 baru, respons ini ditampilkan sebagai jumlah keberhasilan dan kegagalan di kolom Operation.metadata.

Skema saat mengekspor ke BigQuery

Pada v1beta1 sebelumnya, Anda dapat menentukan jenis skema berikut dalam metode projects.locations.datasets.fhirStores.export saat mengekspor resource FHIR ke BigQuery:

  • SCHEMA_TYPE_UNSPECIFIED: Tidak ada jenis skema yang ditentukan. Sama seperti LOSSLESS.
  • LOSSLESS Skema berbasis data yang dihasilkan dari kolom yang ada dalam data FHIR yang diekspor, tanpa penyederhanaan tambahan.
  • ANALYTICS: Skema analisis yang ditentukan oleh komunitas FHIR. Lihat https://github.com/FHIR/sql-on-fhir/blob/master/sql-on-fhir.md.

Di v1beta1 yang baru, jenis skema SCHEMA_TYPE_UNSPECIFIED tidak lagi tersedia. Jika Anda menentukan SCHEMA_TYPE_UNSPECIFIED atau tidak menyetel kolom schemaType, Cloud Healthcare API akan menampilkan error.

Perubahan lokasi

Metode projects.locations.get dan projects.locations.list kini memerlukan izin berikut:

  • locations.get: healthcare.locations.get pada lokasi yang diminta.
  • locations.list: healthcare.locations.list pada project Google Cloud induk.