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
danExportAnnotationsResponse
, yang dimuat dalam kolomOperation.response
dari operasi impor atau ekspor yang berjalan lama, tidak lagi menyertakan kolomannotationStore
atau kolomsuccessCount
. Sebagai gantinya, Anda dapat melihat jumlah keberhasilan dan kegagalan di kolomOperation.metadata
yang ditampilkan dalam operasi yang berjalan lama yang ditampilkan.EvaluateAnnotationStoreResponse
, yang dimuat dalam kolomOperation.response
dari operasi evaluasi yang berjalan lama, tidak lagi menyertakan kolomevalStore
,goldenStore
,goldenCount
, ataumatchedCount
. Sebagai gantinya, untuk menemukan nilaimatchedCount
, lihat kolomsuccess
diOperation.metadata
. Untuk menemukan nilaigoldenCount
, tambahkan nilai kolomsuccess
dan nilai kolomfailure
diOperation.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:
projects.locations.datasets.dicomStores.studies.delete
projects.locations.datasets.dicomStores.studies.series.delete
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 sepertiLOSSLESS
.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.