本頁說明如何使用 v1 DicomConfig 設定,在下列層級去識別化 DICOM 執行個體中的機密資料:
- 使用
datasets.deidentify在資料集層級 - 使用
dicomStores.deidentify,在 DICOM 儲存庫層級設定
此外,本頁也說明如何在 DICOM 儲存庫層級去識別化資料時套用篩選器。
去識別化總覽
資料集層級去識別化
如要在資料集層級去識別化 DICOM 資料,請呼叫 datasets.deidentify 作業。去識別化 API 呼叫包含下列元件:
- 來源資料集:包含 DICOM 儲存庫的資料集,其中有一或多個執行個體含有機密資料。呼叫
deidentify作業時,資料集中所有 DICOM 儲存庫的所有執行個體都會去識別化。 - 目的地資料集:去識別化不會影響原始資料集或其資料。而是將原始資料的去識別化副本寫入新的資料集,稱為「目的地資料集」。
- 去識別化內容:指定資料集處理方式的設定參數。您可以設定 DICOM 去識別化,對 DICOM 執行個體中繼資料 (使用標記關鍵字) 或 DICOM 圖片中的烙印文字進行去識別化,方法是在
DeidentifyConfig物件中指定這些參數,並執行下列操作:- 設定要求主體的
config欄位 - 以 JSON 格式儲存在 Cloud Storage 中,並使用要求主體的
gcsConfigUri欄位指定檔案在 bucket 中的位置
- 設定要求主體的
本指南中的大部分範例,都說明如何在資料集層級對 DICOM 資料進行去識別化。
DICOM 儲存庫層級去識別化
在 DICOM 儲存庫層級對 DICOM 資料進行去識別化,可進一步控管要對哪些資料進行去識別化。舉例來說,如果資料集有多個 DICOM 儲存庫,您可以根據儲存庫中的資料類型,對每個 DICOM 儲存庫進行去識別化。
如要對 DICOM 儲存庫中的 DICOM 資料進行去識別化,請呼叫 dicomStores.deidentify 方法。去識別化 API 呼叫包含下列元件:
- 來源 DICOM 儲存庫:包含一或多個機密資料執行個體的 DICOM 儲存庫。呼叫
deidentify作業時,DICOM 儲存庫中的所有執行個體都會去識別化。 - 目的地 DICOM 儲存庫:去識別化不會影響原始 DICOM 儲存庫或其資料。而是將原始資料的去識別化副本寫入目的地 DICOM 儲存庫。目的地 DICOM 儲存庫必須已存在。
- 要進行去識別化的內容:指定 DICOM 儲存庫處理方式的設定參數。您可以設定 DICOM 去識別化,對 DICOM 執行個體中繼資料 (使用標記關鍵字) 或 DICOM 圖片中的烙印文字進行去識別化。方法是在
DeidentifyConfig物件中指定這些參數,並透過下列任一方式傳遞:- 設定要求主體的
config欄位 - 以 JSON 格式儲存在 Cloud Storage 中,並使用要求主體的
gcsConfigUri欄位指定檔案在 bucket 中的位置
- 設定要求主體的
如需在 DICOM 儲存庫層級去識別化 DICOM 資料的範例,請參閱「在 DICOM 儲存庫層級去識別化資料」。
篩選器
您可以設定篩選器檔案,並在 dicomStores.deidentify 要求中指定該檔案,對 DICOM 儲存庫中的資料子集進行去識別化。如需範例,請參閱「對 DICOM 儲存庫的部分內容進行去識別化」。
範例總覽
本指南中的範例使用單一 DICOM 執行個體,但您也可以對多個執行個體進行去識別化。
以下各節提供範例,說明如何使用各種方法對 DICOM 資料進行去識別化。每個範例都會提供去識別化圖片的輸出內容。每個範例都使用下列原始圖片做為輸入內容:

您可以將每項去識別化作業的輸出圖片與這張原始圖片進行比較,查看作業的效果。
將 DICOM 標記去識別化
您可以根據 DICOM 中繼資料中的標記關鍵字,對 DICOM 執行個體進行去識別化。DicomConfig 物件提供下列標記篩選方法:
keepList:要保留的標記清單。移除所有其他代碼。removeList:要移除的標記清單。保留所有其他標記。filterProfile:用來決定要保留或移除哪些標記的標記篩選設定檔。
本節中的每個範例都會提供 DICOM 執行個體變更後的中繼資料輸出內容。以下是執行個體的原始中繼資料,用做每個範例的輸入內容:
[
{
"00020002":{"vr":"UI","Value":["1.2.840.10008.5.1.4.1.1.7"]},
"00020003":{"vr":"UI","Value":["1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695"]},
"00020010":{"vr":"UI","Value":["1.2.840.10008.1.2.4.50"]},
"00020012":{"vr":"UI","Value":["1.2.276.0.7230010.3.0.3.6.1"]},
"00020013":{"vr":"SH","Value":["OFFIS_DCMTK_361"]},
"00080005":{"vr":"CS","Value":["ISO_IR 100"]},
"00080016":{"vr":"UI","Value":["1.2.840.10008.5.1.4.1.1.7"]},
"00080018":{"vr":"UI","Value":["1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695"]},
"00080020":{"vr":"DA","Value":["20110909"]},
"00080030":{"vr":"TM","Value":["110032"]},
"00080050":{"vr":"SH"},
"00080064":{"vr":"CS","Value":["WSD"]},
"00080070":{"vr":"LO","Value":["Manufacturer"]},
"00080090":{"vr":"PN","Value":[{"Alphabetic":"John Doe"}]},
"00081090":{"vr":"LO","Value":["ABC1"]},
"00100010":{"vr":"PN","Value":[{"Alphabetic":"Ann Johnson"}]},
"00100020":{"vr":"LO","Value":["S1214223-1"]},
"00100030":{"vr":"DA","Value":["19880812"]},
"00100040":{"vr":"CS","Value":["F"]},
"0020000D":{"vr":"UI","Value":["2.25.70541616638819138568043293671559322355"]},
"0020000E":{"vr":"UI","Value":["1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694"]},
"00200010":{"vr":"SH"},
"00200011":{"vr":"IS"},
"00200013":{"vr":"IS"},
"00200020":{"vr":"CS"},
"00280002":{"vr":"US","Value":[3]},
"00280004":{"vr":"CS","Value":["YBR_FULL_422"]},
"00280006":{"vr":"US","Value":[0]},
"00280010":{"vr":"US","Value":[1024]},
"00280011":{"vr":"US","Value":[1024]},
"00280100":{"vr":"US","Value":[8]},
"00280101":{"vr":"US","Value":[8]},
"00280102":{"vr":"US","Value":[7]},
"00280103":{"vr":"US","Value":[0]},
"00282110":{"vr":"CS","Value":["01"]},
"00282114":{"vr":"CS","Value":["ISO_10918_1"]}
}
]
使用保留清單標記去識別化
在 DicomConfig 物件中指定保留清單標記時,系統預設會新增下列標記:
StudyInstanceUIDSeriesInstanceUIDSOPInstanceUIDTransferSyntaxUIDMediaStorageSOPInstanceUIDMediaStorageSOPClassUIDPixelDataRowsColumnsSamplesPerPixelBitsAllocatedBitsStoredHighbitPhotometricInterpretationPixelRepresentationNumberOfFramesPlanarConfigurationPixelAspectRatioSmallestImagePixelValueLargestImagePixelValueRedPaletteColorLookupTableDescriptorGreenPaletteColorLookupTableDescriptorBluePaletteColorLookupTableDescriptorRedPaletteColorLookupTableDataGreenPaletteColorLookupTableDataBluePaletteColorLookupTableDataICCProfileColorSpaceWindowCenterWindowWidthVOILUTFunction
deidentify 作業不會遮蓋上述標記。不過,部分標記的值會重新產生,也就是說,這些值會透過確定性轉換,替換成其他值。詳情請參閱 DICOM 標準中的「保留 UID 選項」。如要保留上述標記的原始值,請使用 SkipIdRedaction 選項。
如果未提供保留清單標記,則不會遮蓋資料集中的任何 DICOM 標記。
下列範例說明如何對含有 DICOM 儲存庫和 DICOM 資料的資料集進行去識別化,同時保留部分標記。
將圖片提交至 Cloud Healthcare API 後,圖片會顯示如下。雖然圖片頂端角落顯示的中繼資料已遮蓋,但圖片底部的燒錄受保護健康資訊 (PHI) 仍保留。如要一併移除燒錄文字,請參閱「遮蓋圖片中的燒錄文字」。

REST
將資料集去識別化。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- SOURCE_DATASET_ID:資料集的 ID,其中包含要進行去識別化處理的資料
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
JSON 要求內文:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "keepList": { "tags": [ "PatientID" ] } } } }如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:回應會包含長時間執行的作業的 ID。如果方法呼叫可能需要相當長的時間才能完成,系統會傳回長時間執行的作業。請記下 OPERATION_ID 的值。您會在下一個步驟中用到這個值。curl
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "keepList": { "tags": [ "PatientID" ] } } } } EOF接著,執行下列指令來傳送 REST 要求:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:@' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "keepList": { "tags": [ "PatientID" ] } } } } '@ | Out-File -FilePath request.json -Encoding utf8接著,執行下列指令來傳送 REST 要求:
$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://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content- 使用
projects.locations.datasets.operations.get方法,取得長時間執行的作業狀態。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- DATASET_ID:資料集 ID
- LOCATION:資料集位置
- OPERATION_ID:長時間執行的作業傳回的 ID
如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:當回應包含curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
"done": true時,表示長時間執行的作業已完成。 - 去識別化成功後,您可以擷取去識別化執行個體的中繼資料,查看其變化。去識別化執行個體具有新的檢查 UID、系列 UID 和執行個體 UID,因此您必須先在新資料集中搜尋去識別化執行個體。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- SOURCE_DATASET_LOCATION:來源資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
您應該會收到如下的 JSON 回覆:
下表顯示研究 UID、系列 UID 和執行個體 UID 的變更方式:原始執行個體中繼資料 去識別化執行個體中繼資料 研究 UID ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763系列 UID ( 0020000E)1.2.276.0.7230010.3.1.3.8323329.78.1531234558.5236941.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710執行個體 UID ( 00080018)1.2.276.0.7230010.3.1.4.8323329.78.1539083058.5236951.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029 使用新值擷取執行個體的中繼資料。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
輸出內容會包含新的中繼資料。您可以比較新中繼資料與原始中繼資料,瞭解轉換效果。curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
Go
Java
Node.js
Python
使用移除清單標記去識別化
您可以在 DicomConfig 物件中指定移除清單。deidentify 作業只會遮蓋清單中指定的標記。如果未提供 removelist 標記,去識別化作業會正常進行,但目的地資料集中的 DICOM 標記不會遭到遮蓋。
指定移除清單時,系統預設會新增 OverlayData 標記,因為疊加層資料可能含有受保護的健康資訊。
預設加入保留清單的標記無法加入移除清單。
下列範例說明如何移除移除清單中的所有標記,對含有 DICOM 儲存庫和 DICOM 資料的資料集進行去識別化。不在移除清單中的標記則維持不變。
將圖片提交至 Cloud Healthcare API 後,圖片會顯示如下。在移除清單提供的標記中,只有 PatientBirthDate 會從圖片中移除,因為這是移除清單中唯一對應到圖片中可見中繼資料的標記。
雖然圖片頂角的 PatientBirthDate 已根據移除清單中的設定遮蓋,但圖片底部的燒錄 PHI 仍會保留。如要一併移除燒錄文字,請參閱「遮蓋圖片中的燒錄文字」。

REST
將資料集去識別化。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- SOURCE_DATASET_ID:資料集的 ID,其中包含要進行去識別化處理的資料
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
JSON 要求內文:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "removeList": { "tags": [ "PatientBirthName", "PatientBirthDate", "PatientAge", "PatientSize", "PatientWeight", "PatientAddress", "PatientMotherBirthName" ] } } } }如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:回應會包含長時間執行作業的 ID。如果方法呼叫可能需要相當長的時間才能完成,系統會傳回長時間執行的作業。請記下 OPERATION_ID 的值。您會在下一個步驟中用到這個值。curl
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "removeList": { "tags": [ "PatientBirthName", "PatientBirthDate", "PatientAge", "PatientSize", "PatientWeight", "PatientAddress", "PatientMotherBirthName" ] } } } } EOF接著,執行下列指令來傳送 REST 要求:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:@' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "removeList": { "tags": [ "PatientBirthName", "PatientBirthDate", "PatientAge", "PatientSize", "PatientWeight", "PatientAddress", "PatientMotherBirthName" ] } } } } '@ | Out-File -FilePath request.json -Encoding utf8接著,執行下列指令來傳送 REST 要求:
$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://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content- 使用
projects.locations.datasets.operations.get方法,取得長時間執行的作業狀態。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- DATASET_ID:資料集 ID
- LOCATION:資料集位置
- OPERATION_ID:長時間執行的作業傳回的 ID
如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:當回應包含curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
"done": true時,表示長時間執行的作業已完成。 - 去識別化成功後,您可以擷取去識別化執行個體的中繼資料,查看其變化。去識別化執行個體具有新的檢查 UID、系列 UID 和執行個體 UID,因此您必須先在新資料集中搜尋去識別化執行個體。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- SOURCE_DATASET_LOCATION:來源資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
您應該會收到如下的 JSON 回覆:
下表顯示研究 UID、系列 UID 和執行個體 UID 的變更方式:原始執行個體中繼資料 去識別化執行個體中繼資料 研究 UID ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763系列 UID ( 0020000E)1.2.276.0.7230010.3.1.3.8323329.78.1531234558.5236941.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710執行個體 UID ( 00080018)1.2.276.0.7230010.3.1.4.8323329.78.1539083058.5236951.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029 使用新值擷取執行個體的中繼資料。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
輸出內容會包含新的中繼資料。您可以比較新中繼資料與原始中繼資料,瞭解轉換效果。curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
使用標記篩選器設定檔去識別化
您可以在 DicomConfig 物件中設定 TagFilterProfile,而不必指定要保留或移除哪些標記。標記篩選器設定檔是預先定義的設定檔,可決定要保留、移除或轉換哪些標記。如需可用設定檔,請參閱 TagFilterProfile 說明文件。
下列範例說明如何使用標記篩選器設定檔 ATTRIBUTE_CONFIDENTIALITY_BASIC_PROFILE,對含有 DICOM 儲存庫和 DICOM 資料的資料集進行去識別化。這個標記篩選器設定檔會根據 DICOM 標準的屬性機密性基本設定檔移除標記。Cloud Healthcare API 並未完全符合屬性機密性基本設定檔。舉例來說,為標記選取動作時,Cloud Healthcare API 不會檢查資訊物件定義 (IOD) 限制。
使用 ATTRIBUTE_CONFIDENTIALITY_BASIC_PROFILE 標記篩選器設定檔將圖片提交至 Cloud Healthcare API 後,圖片會顯示如下。雖然圖片頂端角落顯示的中繼資料已遮蓋,但圖片底部的燒錄 PHI 仍保留。如要一併移除燒錄文字,請參閱「遮蓋圖片中的燒錄文字」。

REST
將資料集去識別化。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- SOURCE_DATASET_ID:資料集的 ID,其中包含要進行去識別化處理的資料
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
JSON 要求內文:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "ATTRIBUTE_CONFIDENTIALITY_BASIC_PROFILE" } } }如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:回應會包含長時間執行作業的 ID。如果方法呼叫可能需要相當長的時間才能完成,系統會傳回長時間執行的作業。請記下 OPERATION_ID 的值。您會在下一個步驟中用到這個值。curl
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "ATTRIBUTE_CONFIDENTIALITY_BASIC_PROFILE" } } } EOF接著,執行下列指令來傳送 REST 要求:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:@' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "ATTRIBUTE_CONFIDENTIALITY_BASIC_PROFILE" } } } '@ | Out-File -FilePath request.json -Encoding utf8接著,執行下列指令來傳送 REST 要求:
$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://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content- 使用
projects.locations.datasets.operations.get方法,取得長時間執行的作業狀態。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- DATASET_ID:資料集 ID
- LOCATION:資料集位置
- OPERATION_ID:長時間執行的作業傳回的 ID
如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:當回應包含curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
"done": true時,表示長時間執行的作業已完成。 - 去識別化成功後,您可以擷取去識別化執行個體的中繼資料,查看其變化。去識別化執行個體具有新的檢查 UID、系列 UID 和執行個體 UID,因此您必須先在新資料集中搜尋去識別化執行個體。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- SOURCE_DATASET_LOCATION:來源資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
您應該會收到如下的 JSON 回覆:
下表顯示研究 UID、系列 UID 和執行個體 UID 的變更方式:原始執行個體中繼資料 去識別化執行個體中繼資料 研究 UID ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763系列 UID ( 0020000E)1.2.276.0.7230010.3.1.3.8323329.78.1531234558.5236941.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710執行個體 UID ( 00080018)1.2.276.0.7230010.3.1.4.8323329.78.1539083058.5236951.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029 使用新值擷取執行個體的中繼資料。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
輸出內容會包含新的中繼資料。您可以比較新中繼資料與原始中繼資料,瞭解轉換效果。curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
在 Google Cloud 控制台將資料去識別化
如要在 Google Cloud 控制台去識別化資料,請完成下列步驟:
前往 Google Cloud 控制台的「Datasets」(資料集) 頁面。
在要進行去識別化的資料集「Actions」(動作) 清單中,選擇「De-identify」(去識別化)。
「De-identify Dataset」(去識別化資料集) 頁面隨即顯示。
選取「Set destination dataset」(設定目的地資料集),然後輸入新資料集的名稱,用於儲存去識別化資料。
選取「DICOM tag de-identification」(DICOM 標記去識別化),選取要對哪些資料去識別化的設定檔。資料去識別化的方式如下:
KEEP_ALL_PROFILE:保留所有 DICOM 中繼標記DEIDENTIFY_TAG_CONTENTS- 將中繼標記中的資料去識別化ATTRIBUTE_CONFIDENTIALITY_BASIC_PROFILE:根據 DICOM 標準中的基本設定檔移除中繼標記MINIMAL_KEEP_LIST_PROFILE:僅保留有效 DICOM 物件所需的中繼標記- 略過 ID 遮蓋:按照 DICOM 標準重新產生 UID 欄位
選取「DICOM burnt-in text redaction」(DICOM 烙印文字遮蓋),設定去識別化期間如何遮蓋圖片。您可以按照下列方式設定圖片遮蓋:
REDACT_NO_TEXT- 請勿遮蓋圖片中的文字REDACT_SENSITIVE_TEXT:僅遮蓋圖片中的機密文字。如要一併遮蓋符合自訂規則運算式的文字,請按照下列步驟操作:- 選取「使用自訂設定」。
- 選取「使用自訂規則運算式」。
- 在「Custom Regex」(自訂規則運算式) 欄位中,輸入要比對的規則運算式模式。
- 選用:在「Group Index」(群組索引) 欄位中,輸入最多三個要遮蓋的擷取群組索引 (以半形逗號分隔),例如
1,2。如要遮蓋整個相符項目,請將欄位留空或輸入0。 - 選用:按一下「新增自訂規則運算式」,設定其他自訂規則運算式。
REDACT_ALL_TEXT- 遮蓋圖片中的所有文字
按一下「De-identify」(去識別化),將資料集中的資料去識別化。
遮蓋圖片中的內嵌文字
Cloud Healthcare API 可遮蓋圖片中敏感的內嵌文字。API 會偵測受保護健康資訊等機密資料,然後使用不透明矩形遮蓋。API 會以相同格式傳回您提供的 DICOM 圖片,但會根據您的條件,遮蓋任何含有機密資訊的文字。
您可以在 ImageConfig 物件中指定 TextRedactionMode 選項,遮蓋圖片中的燒錄文字。如要查看可能的值,請參閱 TextRedactionMode 說明文件。
遮蓋圖片中的所有燒錄文字
下列範例說明如何遮蓋資料集中 DICOM 圖片的所有烙印文字。方法是在 TextRedactionMode 欄位中指定 REDACT_ALL_TEXT。
使用 REDACT_ALL_TEXT 選項將圖片提交至 Cloud Healthcare API 後,圖片會顯示如下。雖然圖片底部的燒錄文字已移除,但圖片頂端角落的中繼資料仍保留。如要一併移除中繼資料,請參閱「對 DICOM 標記進行去識別化處理」。

REST
將資料集去識別化。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- SOURCE_DATASET_ID:資料集的 ID,其中包含要進行去識別化處理的資料
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
JSON 要求內文:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": {}, "image": { "textRedactionMode": "REDACT_ALL_TEXT" } } }如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:回應會包含長時間執行的作業的 ID。如果方法呼叫可能需要相當長的時間才能完成,系統會傳回長時間執行的作業。請記下 OPERATION_ID 的值。您會在下一個步驟中用到這個值。curl
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": {}, "image": { "textRedactionMode": "REDACT_ALL_TEXT" } } } EOF接著,執行下列指令來傳送 REST 要求:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:@' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": {}, "image": { "textRedactionMode": "REDACT_ALL_TEXT" } } } '@ | Out-File -FilePath request.json -Encoding utf8接著,執行下列指令來傳送 REST 要求:
$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://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content- 使用
projects.locations.datasets.operations.get方法,取得長時間執行作業的狀態。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- DATASET_ID:資料集 ID
- LOCATION:資料集位置
- OPERATION_ID:長時間執行的作業傳回的 ID
如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:當回應包含curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
"done": true時,表示長時間執行的作業已完成。 - 去識別化成功後,您可以擷取去識別化執行個體的中繼資料,查看其變化。去識別化執行個體具有新的檢查 UID、系列 UID 和執行個體 UID,因此您必須先在新資料集中搜尋去識別化執行個體。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- SOURCE_DATASET_LOCATION:來源資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
您應該會收到如下的 JSON 回覆:
下表顯示研究 UID、系列 UID 和執行個體 UID 的變更方式:原始執行個體中繼資料 去識別化執行個體中繼資料 研究 UID ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763系列 UID ( 0020000E)1.2.276.0.7230010.3.1.3.8323329.78.1531234558.5236941.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710執行個體 UID ( 00080018)1.2.276.0.7230010.3.1.4.8323329.78.1539083058.5236951.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029
僅遮蓋圖片中的敏感燒錄文字
下列範例說明如何從資料集中的 DICOM 圖片,遮蓋機密的烙印文字。方法是在 TextRedactionMode 欄位中指定 REDACT_SENSITIVE_TEXT。
指定 REDACT_SENSITIVE_TEXT 時,系統會遮蓋預設 DICOM infoType 中指定的 infoType。另外,系統也會套用兩個自訂 infoType,用於遮蓋:
- 病患 ID,例如病歷號碼 (MRN)
- 檢查單號
下圖顯示病患未經遮蓋的 X 光片:

使用 REDACT_SENSITIVE_TEXT 選項將圖片提交至 Cloud Healthcare API 後,圖片會顯示如下:

您會看到以下情況:
- 圖片左下方的
PERSON_NAME已遮蓋 - 圖片左下方的
DATE已遮蓋
病患的性別並未遮蓋,因為根據預設 DICOM infoType,這不屬於機密文字。
REST
將資料集去識別化。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- SOURCE_DATASET_ID:資料集的 ID,其中包含要進行去識別化處理的資料
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
JSON 要求內文:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": {}, "image": { "textRedactionMode": "REDACT_SENSITIVE_TEXT" } } }如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:回應會包含長時間執行作業的 ID。如果方法呼叫可能需要相當長的時間才能完成,系統會傳回長時間執行的作業。請記下 OPERATION_ID 的值。您會在下一個步驟中用到這個值。curl
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": {}, "image": { "textRedactionMode": "REDACT_SENSITIVE_TEXT" } } } EOF接著,執行下列指令來傳送 REST 要求:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:@' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": {}, "image": { "textRedactionMode": "REDACT_SENSITIVE_TEXT" } } } '@ | Out-File -FilePath request.json -Encoding utf8接著,執行下列指令來傳送 REST 要求:
$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://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content- 使用
projects.locations.datasets.operations.get方法,取得長時間執行的作業狀態。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- DATASET_ID:資料集 ID
- LOCATION:資料集位置
- OPERATION_ID:長時間執行的作業傳回的 ID
如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:當回應包含curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
"done": true時,表示長時間執行的作業已完成。 - 去識別化成功後,您可以擷取去識別化執行個體的中繼資料,查看其變化。去識別化執行個體具有新的檢查 UID、系列 UID 和執行個體 UID,因此您必須先在新資料集中搜尋去識別化執行個體。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- SOURCE_DATASET_LOCATION:來源資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
您應該會收到如下的 JSON 回覆:
下表顯示研究 UID、系列 UID 和執行個體 UID 的變更方式:原始執行個體中繼資料 去識別化執行個體中繼資料 研究 UID ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763系列 UID ( 0020000E)1.2.276.0.7230010.3.1.3.8323329.78.1531234558.5236941.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710執行個體 UID ( 00080018)1.2.276.0.7230010.3.1.4.8323329.78.1539083058.5236951.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029
使用自訂規則運算式遮蓋燒錄文字
如果 textRedactionMode 設為 REDACT_SENSITIVE_TEXT,您也可以在 ImageConfig 物件的 customRegexes 欄位中指定自訂規則運算式模式,偵測並遮蓋 DICOM 圖片中相符的烙印文字。customRegexes 中的每個項目可包含下列欄位:
pattern:與圖片中偵測到的文字比對的規則運算式模式。模式必須使用 RE2 語法。RE2 不支援某些建構,例如 lookahead 和 lookbehind 斷言。groupIndexes:選用清單,列出模式相符時要遮蓋的擷取群組索引。如果省略,則會遮蓋整個相符項目。規則如下:- 每個自訂規則運算式最多可指定三個群組索引。
- 索引
0會遮蓋整個相符項目,且無法與其他索引合併。 1以上的索引則依序參照pattern中的擷取群組。每個索引不得超過pattern中的擷取群組數量。
如果模式無效,要求就會失敗,並傳回 INVALID_ARGUMENT 錯誤。
下列範例說明如何使用自訂規則運算式,對資料集或 DICOM 儲存庫進行去識別化:
REST
使用自訂規則運算式,對資料集或 DICOM 儲存庫進行去識別化。
如要對資料集 (
datasets.deidentify) 中的所有 DICOM 儲存庫進行去識別化,請按照下列步驟操作:使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- SOURCE_DATASET_ID:資料集的 ID,其中包含要進行去識別化處理的資料
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
JSON 要求內文:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": {}, "image": { "textRedactionMode": "REDACT_SENSITIVE_TEXT", "customRegexes": [ { "pattern": "MRN:\\s*([0-9]{4,10})", "groupIndexes": [1] } ] } } }如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:回應會包含長時間執行的作業的 ID。如果方法呼叫可能需要相當長的時間才能完成,系統會傳回長時間執行的作業。請記下 OPERATION_ID 的值。您會在下一個步驟中用到這個值。curl
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": {}, "image": { "textRedactionMode": "REDACT_SENSITIVE_TEXT", "customRegexes": [ { "pattern": "MRN:\\s*([0-9]{4,10})", "groupIndexes": [1] } ] } } } EOF接著,執行下列指令來傳送 REST 要求:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:@' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": {}, "image": { "textRedactionMode": "REDACT_SENSITIVE_TEXT", "customRegexes": [ { "pattern": "MRN:\\s*([0-9]{4,10})", "groupIndexes": [1] } ] } } } '@ | Out-File -FilePath request.json -Encoding utf8接著,執行下列指令來傳送 REST 要求:
$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://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content如要對單一 DICOM 儲存庫 (
datasets.dicomStores.deidentify) 進行去識別化,請按照下列步驟操作:使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- SOURCE_DATASET_ID:資料集的 ID,其中包含要進行去識別化處理的資料
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- SOURCE_DICOM_STORE_ID:DICOM 儲存庫的 ID,其中包含要進行去識別化處理的資料
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID
JSON 要求內文:
{ "destinationStore": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID", "config": { "dicom": {}, "image": { "textRedactionMode": "REDACT_SENSITIVE_TEXT", "customRegexes": [ { "pattern": "MRN:\\s*([0-9]{4,10})", "groupIndexes": [1] } ] } } }如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:回應會包含長時間執行的作業的 ID。如果方法呼叫可能需要相當長的時間才能完成,系統會傳回長時間執行的作業。請記下 OPERATION_ID 的值。您會在下一個步驟中用到這個值。curl
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:cat > request.json << 'EOF' { "destinationStore": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID", "config": { "dicom": {}, "image": { "textRedactionMode": "REDACT_SENSITIVE_TEXT", "customRegexes": [ { "pattern": "MRN:\\s*([0-9]{4,10})", "groupIndexes": [1] } ] } } } EOF接著,執行下列指令來傳送 REST 要求:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/SOURCE_DICOM_STORE_ID:deidentify"PowerShell
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:@' { "destinationStore": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID", "config": { "dicom": {}, "image": { "textRedactionMode": "REDACT_SENSITIVE_TEXT", "customRegexes": [ { "pattern": "MRN:\\s*([0-9]{4,10})", "groupIndexes": [1] } ] } } } '@ | Out-File -FilePath request.json -Encoding utf8接著,執行下列指令來傳送 REST 要求:
$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://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/SOURCE_DICOM_STORE_ID:deidentify" | Select-Object -Expand Content- 使用
projects.locations.datasets.operations.get方法,取得長時間執行的作業狀態。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- DATASET_ID:資料集 ID
- LOCATION:資料集位置
- OPERATION_ID:長時間執行的作業傳回的 ID
如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:當回應包含curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
"done": true時,表示長時間執行的作業已完成。 - 去識別化成功後,您可以擷取去識別化執行個體的中繼資料,查看其變化。去識別化執行個體具有新的檢查 UID、系列 UID 和執行個體 UID,因此您必須先在新資料集中搜尋去識別化執行個體。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- SOURCE_DATASET_LOCATION:來源資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
您應該會收到如下的 JSON 回覆:
下表顯示研究 UID、系列 UID 和執行個體 UID 的變更方式:原始執行個體中繼資料 去識別化執行個體中繼資料 研究 UID ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763系列 UID ( 0020000E)1.2.276.0.7230010.3.1.3.8323329.78.1531234558.5236941.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710執行個體 UID ( 00080018)1.2.276.0.7230010.3.1.4.8323329.78.1539083058.5236951.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029
結合標記去識別化和烙印文字遮蓋
您可以結合使用標記去識別化和圖片中燒錄文字遮蓋功能,以更精細的方式對 DICOM 執行個體去識別化。舉例來說,只要將 TextRedactionMode 欄位中的 REDACT_ALL_TEXT 與 TagFilterProfile 欄位中的 DEIDENTIFY_TAG_CONTENTS 結合,即可執行下列操作:
REDACT_ALL_TEXT:遮蓋圖片中所有燒錄文字。DEIDENTIFY_TAG_CONTENTS:檢查標記內容並轉換機密文字。如要進一步瞭解DEIDENTIFY_TAG_CONTENTS的行為,請參閱「預設設定」。
使用 REDACT_ALL_TEXT 和 DEIDENTIFY_TAG_CONTENTS 選項將圖片提交至 Cloud Healthcare API 後,圖片會顯示如下。請留意下列異動:
- 圖片左上角和右上角的名稱已使用
CryptoHashConfig轉換 - 圖片左上角和右上角的日期已使用
DateShiftConfig轉換 - 圖片底部的燒錄文字已遮蓋

REST
將資料集去識別化。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- SOURCE_DATASET_ID:資料集的 ID,其中包含要進行去識別化處理的資料
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
JSON 要求內文:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "image": { "textRedactionMode": "REDACT_ALL_TEXT" } } }如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:回應會包含長時間執行的作業的 ID。如果方法呼叫可能需要相當長的時間才能完成,系統會傳回長時間執行的作業。請記下 OPERATION_ID 的值。您會在下一個步驟中用到這個值。curl
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "image": { "textRedactionMode": "REDACT_ALL_TEXT" } } } EOF接著,執行下列指令來傳送 REST 要求:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:@' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "image": { "textRedactionMode": "REDACT_ALL_TEXT" } } } '@ | Out-File -FilePath request.json -Encoding utf8接著,執行下列指令來傳送 REST 要求:
$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://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content- 使用
projects.locations.datasets.operations.get方法,取得長時間執行的作業狀態。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- DATASET_ID:資料集 ID
- LOCATION:資料集位置
- OPERATION_ID:長時間執行的作業傳回的 ID
如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:當回應包含curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
"done": true時,表示長時間執行的作業已完成。 - 去識別化成功後,您可以擷取去識別化執行個體的中繼資料,查看其變化。去識別化執行個體具有新的檢查 UID、系列 UID 和執行個體 UID,因此您必須先在新資料集中搜尋去識別化執行個體。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- SOURCE_DATASET_LOCATION:來源資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
您應該會收到如下的 JSON 回覆:
使用新值擷取執行個體的中繼資料。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
輸出內容會包含新的中繼資料。您可以比較新中繼資料與原始中繼資料,瞭解轉換效果。curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
搭配使用 infoType、原始轉換和 DICOM 標記
Cloud Healthcare API 可使用資訊類型 (infoTypes),定義對標記執行去識別化時要掃描的資料。infoType 是一種機密資料,例如病患姓名、電子郵件地址、電話號碼、身分證號碼或信用卡號碼。
原始轉換是您用來轉換輸入值的規則。您可以對每個標記的 infoType 套用原始轉換,自訂 DICOM 標記的去識別化方式。舉例來說,您可以指定 LAST_NAME infoType,並使用 CharacterMaskConfig 原始轉換,將病患的姓氏去識別化,並以一連串星號取代。
預設 DICOM infoType
對中繼資料進行去識別化時,預設使用的 DICOM infoType 如下:
AGECREDIT_CARD_NUMBERDATEEMAIL_ADDRESSIP_ADDRESSLOCATIONMAC_ADDRESSPASSPORTPERSON_NAMEPHONE_NUMBERSWIFT_CODEUS_DRIVERS_LICENSE_NUMBERUS_SOCIAL_SECURITY_NUMBERUS_VEHICLE_IDENTIFICATION_NUMBERUS_INDIVIDUAL_TAXPAYER_IDENTIFICATION_NUMBER
使用 REDACT_SENSITIVE_TEXT 去識別化圖片中的機密文字時,Cloud Healthcare API 會使用上述 infoType,但也會對圖片中的機密文字套用兩個額外的自訂 infoType,用於:
- 病患 ID,例如病歷號碼 (MRN)
- 檢查單號
原始轉換選項
Cloud Healthcare API 原始轉換選項包括:
RedactConfig:移除值來遮蓋。CharacterMaskConfig:將輸入字元替換為指定的固定字元,藉此遮蓋完整或部分字串。DateShiftConfig:將日期隨機平移幾天,並可選擇在相同情境下保持一致。CryptoHashConfig:使用 SHA-256,將輸入值替換為雜湊輸出字串的 Base64 編碼表示法,該字串是使用指定的資料加密金鑰產生。ReplaceWithInfoTypeConfig:將輸入值替換為其 infoType 的名稱。
在 TextConfig 中指定設定
InfoType 和原始轉換是在 InfoTypeTransformation 中指定,這是 TextConfig 內的物件。InfoType 會以逗號分隔值的形式輸入 infoTypes 陣列。
您可以選擇是否指定 infoType。如未指定至少一個 infoType,轉換作業會套用至 Cloud Healthcare API 中的預設 DICOM infoType。
如果您在 InfoTypeTransformation 中指定任何 infoType,則必須指定至少一項原始轉換。
您只能將 InfoTypeTransformation 套用至 DEIDENTIFY_TAG_CONTENTS 設定檔。InfoTypeTransformation 無法套用至 TagFilterProfile 中列出的其他設定檔。
下列各節說明如何使用 InfoTypeTransformation 中提供的原始轉換和 infoType,自訂 DICOM 標記去識別化的方式。範例會使用「範例總覽」中提供的範例圖片,以及「對 DICOM 標記進行去識別化」中提供的範例中繼資料。
預設設定
根據預設,如果設定 DEIDENTIFY_TAG_CONTENTS 設定檔時未在 TextConfig 物件中提供任何設定,Cloud Healthcare API 會使用預設 DICOM infoType 取代機密資料。不過,DATE 和 PERSON_NAME infoType 的行為不同,如下所示:
DateShiftConfig會套用至歸類為DATEinfoType 的文字。DateShiftConfig採用日期移位技術,差異為 100 天。CryptoHashConfig會套用至歸類為PERSON_NAMEinfoType 的文字。CryptoHashConfig會使用密碼雜湊產生代理值,藉此執行權杖化。
系統也會按照以下方式運作:
- 任何大於或等於 90 的病患年齡值都會轉換為 90。
- 如果因 DICOM 格式限制而無法套用轉換,系統會提供與標記值表示法 (VR) 對應的預留位置值。
- 與 Cloud Healthcare API 中任一預設 DICOM infoType 對應的其他值,都會替換為其 infoType。舉例來說,如果
PatientComments標記包含「Ann Johnson went to Anytown Hospital」字串,則「Anytown」會替換為LOCATIONinfoType。
下列範例顯示在包含 DICOM 儲存庫和 DICOM 資料的資料集上,使用 DEIDENTIFY_TAG_CONTENTS 預設設定檔的輸出內容。您可以將這個預設輸出內容,與使用各種原始轉換和 infoType 組合的輸出內容進行比較。範例使用單一 DICOM 執行個體,但您可以將多個執行個體去識別化。
使用 DEIDENTIFY_TAG_CONTENTS 設定檔將圖片提交至 Cloud Healthcare API 後,圖片會顯示如下。請留意下列異動:
- 圖片左上角和右上角的名稱已使用
CryptoHashConfig轉換 - 圖片左上角和右上角的日期已使用
DateShiftConfig轉換

REST
將資料集去識別化。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- SOURCE_DATASET_ID:資料集的 ID,其中包含要進行去識別化處理的資料
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
JSON 要求內文:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" } } }如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:回應會包含長時間執行的作業的 ID。如果方法呼叫可能需要相當長的時間才能完成,系統會傳回長時間執行的作業。請記下 OPERATION_ID 的值。您會在下一個步驟中用到這個值。curl
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" } } } EOF接著,執行下列指令來傳送 REST 要求:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:@' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" } } } '@ | Out-File -FilePath request.json -Encoding utf8接著,執行下列指令來傳送 REST 要求:
$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://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content- 使用
projects.locations.datasets.operations.get方法,取得長時間執行的作業狀態。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- DATASET_ID:資料集 ID
- LOCATION:資料集位置
- OPERATION_ID:長時間執行的作業傳回的 ID
如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:當回應包含curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
"done": true時,表示長時間執行的作業已完成。 - 去識別化成功後,您可以擷取去識別化執行個體的中繼資料,查看其變化。去識別化執行個體具有新的檢查 UID、系列 UID 和執行個體 UID,因此您必須先在新資料集中搜尋去識別化執行個體。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- SOURCE_DATASET_LOCATION:來源資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
您應該會收到如下的 JSON 回覆:
使用新值擷取執行個體的中繼資料。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
輸出內容會包含新的中繼資料。您可以比較新中繼資料與原始中繼資料,瞭解轉換效果。curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
RedactConfig
指定 redactConfig 會完全移除指定的值,藉此遮蓋該值。redactConfig 訊息沒有引數,指定後即可啟用轉換。
下列範例會展開預設設定,但現在包含使用 redactConfig 轉換設定 PERSON_NAME infoType。傳送這項要求後,系統會遮蓋 DICOM 執行個體中的所有名稱。
使用 redactConfig 轉換將圖片提交至 Cloud Healthcare API 後,圖片會顯示如下:

REST
將資料集去識別化。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- SOURCE_DATASET_ID:資料集的 ID,其中包含要進行去識別化處理的資料
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
JSON 要求內文:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "text": { "transformations": [ { "infoTypes": [ "PERSON_NAME" ], "redactConfig": {} } ] } } }如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:回應會包含長時間執行的作業的 ID。如果方法呼叫可能需要相當長的時間才能完成,系統會傳回長時間執行的作業。請記下 OPERATION_ID 的值。您會在下一個步驟中用到這個值。curl
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "text": { "transformations": [ { "infoTypes": [ "PERSON_NAME" ], "redactConfig": {} } ] } } } EOF接著,執行下列指令來傳送 REST 要求:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:@' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "text": { "transformations": [ { "infoTypes": [ "PERSON_NAME" ], "redactConfig": {} } ] } } } '@ | Out-File -FilePath request.json -Encoding utf8接著,執行下列指令來傳送 REST 要求:
$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://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content- 使用
projects.locations.datasets.operations.get方法,取得長時間執行的作業狀態。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- DATASET_ID:資料集 ID
- LOCATION:資料集位置
- OPERATION_ID:長時間執行的作業傳回的 ID
如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:當回應包含curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
"done": true時,表示長時間執行的作業已完成。 - 去識別化成功後,您可以擷取去識別化執行個體的中繼資料,查看其變化。去識別化執行個體具有新的檢查 UID、系列 UID 和執行個體 UID,因此您必須先在新資料集中搜尋去識別化執行個體。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- SOURCE_DATASET_LOCATION:來源資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
您應該會收到如下的 JSON 回覆:
使用新值擷取執行個體的中繼資料。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
輸出內容會包含新的中繼資料。您可以比較新中繼資料與原始中繼資料,瞭解轉換效果。curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
輸出內容顯示 ReferringPhysicianName (00080090) 和 PatientName (00100010) 中的值已移除。這與預設設定中的範例不同,後者使用密碼雜湊轉換這些值。
CharacterMaskConfig
指定 characterMaskConfig 會將與指定 infoType 對應的字串替換為指定的固定字元。舉例來說,您可以將病患姓名替換為一連串星號 (*),而不是遮蓋姓名或使用密碼編譯雜湊轉換姓名。您可以將固定字元指定為 maskingCharacter 欄位的值。
下列範例會展開預設設定,但現在包含使用 characterMaskConfig 轉換設定 LAST_NAME infoType。未提供固定字元,因此遮罩預設使用星號。
範例使用單一 DICOM 執行個體,但您可以將多個執行個體去識別化。
使用 characterMaskConfig 轉換將圖片提交至 Cloud Healthcare API 後,圖片會顯示如下:

REST
將資料集去識別化。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- SOURCE_DATASET_ID:資料集的 ID,其中包含要進行去識別化處理的資料
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
JSON 要求內文:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "text": { "transformations": [ { "infoTypes": [ "PERSON_NAME" ], "characterMaskConfig": { "maskingCharacter": "" } } ] } } }如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:回應會包含長時間執行的作業的 ID。如果方法呼叫可能需要相當長的時間才能完成,系統會傳回長時間執行的作業。請記下 OPERATION_ID 的值。您會在下一個步驟中用到這個值。curl
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "text": { "transformations": [ { "infoTypes": [ "PERSON_NAME" ], "characterMaskConfig": { "maskingCharacter": "" } } ] } } } EOF接著,執行下列指令來傳送 REST 要求:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:@' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "text": { "transformations": [ { "infoTypes": [ "PERSON_NAME" ], "characterMaskConfig": { "maskingCharacter": "" } } ] } } } '@ | Out-File -FilePath request.json -Encoding utf8接著,執行下列指令來傳送 REST 要求:
$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://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content- 使用
projects.locations.datasets.operations.get方法,取得長時間執行的作業狀態。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- DATASET_ID:資料集 ID
- LOCATION:資料集位置
- OPERATION_ID:長時間執行的作業傳回的 ID
如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:當回應包含curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
"done": true時,表示長時間執行的作業已完成。 - 去識別化成功後,您可以擷取去識別化執行個體的中繼資料,查看其變化。去識別化執行個體具有新的檢查 UID、系列 UID 和執行個體 UID,因此您必須先在新資料集中搜尋去識別化執行個體。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- SOURCE_DATASET_LOCATION:來源資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
您應該會收到如下的 JSON 回覆:
使用新值擷取執行個體的中繼資料。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
輸出內容會包含新的中繼資料。您可以比較新中繼資料與原始中繼資料,瞭解轉換效果。curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
輸出內容顯示 ReferringPhysicianName (00080090) 和 PatientName (00100010) 中的姓氏已替換為星號。這與「預設設定」中的範例相反,在該範例中,這些值是使用密碼雜湊轉換。
DateShiftConfig
Cloud Healthcare API 可在預設範圍內調整日期,藉此轉換日期。如要在去識別化執行作業中保持日期轉換一致,請將 DateShiftConfig 與下列任一項搭配使用:
- (已淘汰):原始 AES 128/192/256 位元 Base64 編碼金鑰。
- (建議):Cloud Key Management Service (Cloud KMS) 包裝金鑰。如需使用 Cloud KMS 封裝金鑰的範例,請參閱「將機密文字去識別化及重新識別」。
您必須將具備 cloudkms.cryptoKeyVersions.useToDecrypt 權限的角色授予 Cloud Healthcare 服務代理服務帳戶,才能解密 Cloud KMS 包裝金鑰。建議使用 Cloud KMS CryptoKey 解密者角色 (roles/cloudkms.cryptoKeyDecrypter)。使用 Cloud KMS 執行加密編譯作業時,系統會收取費用。詳情請參閱「Cloud Key Management Service 定價」。
Cloud Healthcare API 會使用這組金鑰,計算日期 (例如病患的出生日期) 在 100 天差異範圍內的偏移量。
如未提供金鑰,Cloud Healthcare API 會在每次對日期值執行去識別化作業時,自行產生金鑰。這可能會導致每次執行時輸出的日期不一致。
下列範例說明如何使用 DICOM 執行個體上的 DateShiftConfig 轉換,設定 DATE 和 DATE_OF_BIRTH infoType。將去識別化要求傳送至 Cloud Healthcare API 後,執行個體中的日期值會比原始值提前或延後 100 天。
提供的加密金鑰 U2FsdGVkX19bS2oZsdbK9X5zi2utBn22uY+I2Vo0zOU= 是原始 AES 加密 256 位元 Base64 編碼金鑰,使用下列指令產生。系統提示時,請在指令中提供空白密碼:
echo -n "test" | openssl enc -e -aes-256-ofb -a -salt
使用 dateShiftConfig 轉換將圖片提交至 Cloud Healthcare API 後,圖片會顯示如下:

REST
將資料集去識別化。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- SOURCE_DATASET_ID:資料集的 ID,其中包含要進行去識別化處理的資料
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
JSON 要求內文:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "text": { "transformations": [ { "infoTypes": [ "DATE", "DATE_OF_BIRTH" ], "dateShiftConfig": { "cryptoKey": "U2FsdGVkX19bS2oZsdbK9X5zi2utBn22uY+I2Vo0zOU=" } } ] } } }如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:回應會包含長時間執行的作業的 ID。如果方法呼叫可能需要相當長的時間才能完成,系統會傳回長時間執行的作業。請記下 OPERATION_ID 的值。您會在下一個步驟中用到這個值。curl
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "text": { "transformations": [ { "infoTypes": [ "DATE", "DATE_OF_BIRTH" ], "dateShiftConfig": { "cryptoKey": "U2FsdGVkX19bS2oZsdbK9X5zi2utBn22uY+I2Vo0zOU=" } } ] } } } EOF接著,執行下列指令來傳送 REST 要求:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:@' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "text": { "transformations": [ { "infoTypes": [ "DATE", "DATE_OF_BIRTH" ], "dateShiftConfig": { "cryptoKey": "U2FsdGVkX19bS2oZsdbK9X5zi2utBn22uY+I2Vo0zOU=" } } ] } } } '@ | Out-File -FilePath request.json -Encoding utf8接著,執行下列指令來傳送 REST 要求:
$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://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content- 使用
projects.locations.datasets.operations.get方法,取得長時間執行作業的狀態。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- DATASET_ID:資料集 ID
- LOCATION:資料集位置
- OPERATION_ID:長時間執行的作業傳回的 ID
如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:當回應包含curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
"done": true時,表示長時間執行的作業已完成。 - 去識別化成功後,您可以擷取去識別化執行個體的中繼資料,查看其變化。去識別化執行個體具有新的檢查 UID、系列 UID 和執行個體 UID,因此您必須先在新資料集中搜尋去識別化執行個體。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- SOURCE_DATASET_LOCATION:來源資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
您應該會收到如下的 JSON 回覆:
使用新值擷取執行個體的中繼資料。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
輸出內容會包含新的中繼資料。您可以比較新中繼資料與原始中繼資料,瞭解轉換效果。curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
輸出內容會顯示 StudyDate (00080020) 和 PatientBirthDate (00100030) 有新值。這些轉換是將 100 天的差異與提供的 cryptoKey 值結合後的結果。只要提供相同的 cryptoKey,這個執行個體在去識別化執行作業之間的新日期值就會保持一致。
CryptoHashConfig
您可以將 cryptoHashConfig 留空,或提供下列任一值:
- (已淘汰):原始 AES 128/192/256 位元 Base64 編碼金鑰。
- (建議):Cloud Key Management Service (Cloud KMS) 包裝金鑰。如需使用 Cloud KMS 封裝金鑰的範例,請參閱「將機密文字去識別化及重新識別」。
您必須將具備 cloudkms.cryptoKeyVersions.useToDecrypt 權限的角色授予 Cloud Healthcare 服務代理服務帳戶,才能解密 Cloud KMS 包裝金鑰。建議使用 Cloud KMS CryptoKey 解密者角色 (roles/cloudkms.cryptoKeyDecrypter)。使用 Cloud KMS 執行加密編譯作業時,系統會收取費用。詳情請參閱「Cloud Key Management Service 定價」。
Cloud Healthcare API 可將值替換為密碼雜湊 (也稱為代理值),藉此轉換資料。如要這麼做,請指定 cryptoHashConfig 訊息。
如果您未提供金鑰,Cloud Healthcare API 會產生金鑰。Cloud Healthcare API 會使用這組金鑰產生替代值。如果您為每次執行作業提供相同的金鑰,Cloud Healthcare API 會產生一致的替代值。如未提供金鑰,Cloud Healthcare API 會在每次執行作業時產生新的金鑰。使用不同的金鑰會產生不同的代理值。
下列範例說明如何將 cryptoHashConfig 轉換套用至 Cloud Healthcare API 支援的所有預設 DICOM infoType。傳送去識別化要求後,Cloud Healthcare API 中具有對應 DICOM infoType 的值會替換為代理值。
此外,這個範例也說明如何提供加密金鑰,在去識別化執行作業之間產生一致的代理值。
提供的加密金鑰 U2FsdGVkX19bS2oZsdbK9X5zi2utBn22uY+I2Vo0zOU= 是原始 AES 加密 256 位元 Base64 編碼金鑰,使用下列指令產生。系統提示時,請在指令中提供空白密碼:
echo -n "test" | openssl enc -e -aes-256-ofb -a -salt
使用 cryptoHashConfig 轉換將圖片提交至 Cloud Healthcare API 後,圖片會顯示如下:

REST
將資料集去識別化。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- SOURCE_DATASET_ID:資料集的 ID,其中包含要進行去識別化處理的資料
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
JSON 要求內文:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "text": { "transformations": [ { "infoTypes": [], "cryptoHashConfig": { "cryptoKey": "U2FsdGVkX19bS2oZsdbK9X5zi2utBn22uY+I2Vo0zOU=" } } ] } } }如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:回應會包含長時間執行的作業的 ID。如果方法呼叫可能需要相當長的時間才能完成,系統會傳回長時間執行的作業。請記下 OPERATION_ID 的值。您會在下一個步驟中用到這個值。curl
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "text": { "transformations": [ { "infoTypes": [], "cryptoHashConfig": { "cryptoKey": "U2FsdGVkX19bS2oZsdbK9X5zi2utBn22uY+I2Vo0zOU=" } } ] } } } EOF接著,執行下列指令來傳送 REST 要求:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:@' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "text": { "transformations": [ { "infoTypes": [], "cryptoHashConfig": { "cryptoKey": "U2FsdGVkX19bS2oZsdbK9X5zi2utBn22uY+I2Vo0zOU=" } } ] } } } '@ | Out-File -FilePath request.json -Encoding utf8接著,執行下列指令來傳送 REST 要求:
$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://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content- 使用
projects.locations.datasets.operations.get方法,取得長時間執行的作業狀態。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- DATASET_ID:資料集 ID
- LOCATION:資料集位置
- OPERATION_ID:長時間執行的作業傳回的 ID
如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:當回應包含curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
"done": true時,表示長時間執行的作業已完成。 - 去識別化成功後,您可以擷取去識別化執行個體的中繼資料,查看其變化。去識別化執行個體具有新的檢查 UID、系列 UID 和執行個體 UID,因此您必須先在新資料集中搜尋去識別化執行個體。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- SOURCE_DATASET_LOCATION:來源資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
您應該會收到如下的 JSON 回覆:
使用新值擷取執行個體的中繼資料。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
輸出內容會包含新的中繼資料。您可以比較新中繼資料與原始中繼資料,瞭解轉換效果。curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
只要提供相同的 cryptoKey,這個執行個體在去識別化作業之間的輸出內容轉換就會保持一致。
ReplaceWithInfoTypeConfig
指定 replaceWithInfoTypeConfig 會將輸入值替換為該值的 infoType 名稱。
下列範例說明如何將 replaceWithInfoTypeConfig 轉換套用至 Cloud Healthcare API 支援的所有預設 DICOM infoType。replaceWithInfoTypeConfig 訊息沒有引數,指定後即可啟用轉換。
使用 replaceWithInfoTypeConfig 轉換將圖片提交至 Cloud Healthcare API 後,圖片會顯示如下:

REST
將資料集去識別化。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- SOURCE_DATASET_ID:資料集的 ID,其中包含要進行去識別化處理的資料
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
JSON 要求內文:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "text": { "transformations": [ { "infoTypes": [], "replaceWithInfoTypeConfig": {} } ] } } }如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:回應會包含長時間執行的作業的 ID。如果方法呼叫可能需要相當長的時間才能完成,系統會傳回長時間執行的作業。請記下 OPERATION_ID 的值。您會在下一個步驟中用到這個值。curl
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "text": { "transformations": [ { "infoTypes": [], "replaceWithInfoTypeConfig": {} } ] } } } EOF接著,執行下列指令來傳送 REST 要求:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:@' { "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "text": { "transformations": [ { "infoTypes": [], "replaceWithInfoTypeConfig": {} } ] } } } '@ | Out-File -FilePath request.json -Encoding utf8接著,執行下列指令來傳送 REST 要求:
$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://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content- 使用
projects.locations.datasets.operations.get方法,取得長時間執行的作業狀態。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- DATASET_ID:資料集 ID
- LOCATION:資料集位置
- OPERATION_ID:長時間執行的作業傳回的 ID
如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:當回應包含curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
"done": true時,表示長時間執行的作業已完成。 - 去識別化成功後,您可以擷取去識別化執行個體的中繼資料,查看其變化。去識別化執行個體具有新的檢查 UID、系列 UID 和執行個體 UID,因此您必須先在新資料集中搜尋去識別化執行個體。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- SOURCE_DATASET_LOCATION:來源資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
您應該會收到如下的 JSON 回覆:
使用新值擷取執行個體的中繼資料。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID。這與來源資料集中的 DICOM 儲存庫 ID 相同。
如要傳送要求,請選擇以下其中一個選項:
輸出內容會包含新的中繼資料。您可以比較新中繼資料與原始中繼資料,瞭解轉換效果。curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
在 DICOM 儲存庫層級將資料去識別化
上述範例說明如何在資料集層級去識別化 DICOM 資料。本節說明如何在 DICOM 儲存庫層級去識別化資料。
如要將資料集去識別化要求變更為 DICOM 儲存庫去識別化要求,請進行下列變更:
- 將要求主體中的
destinationDataset修改為destinationStore - 指定目的地時,請在
destinationStore的值結尾加上dicomStores/DESTINATION_DICOM_STORE_ID - 指定來源資料的位置時,請新增
dicomStores/SOURCE_DICOM_STORE_ID
例如:
資料集層級去識別化:
"destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID" ... "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"
DICOM 儲存庫層級去識別化:
"destinationStore": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID" ... "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/SOURCE_DICOM_STORE_ID:deidentify"
下列範例會展開合併標記去識別化和烙印文字遮蓋,但去識別化會在單一 DICOM 儲存庫上進行,且去識別化資料會複製到新的 DICOM 儲存庫。執行範例前,DESTINATION_DICOM_STORE_ID 參照的 DICOM 儲存庫必須已存在。
控制台
如要使用 Google Cloud 控制台對 DICOM 儲存庫中的資料進行去識別化,請完成下列步驟。
前往 Google Cloud 控制台的「Datasets」(資料集) 頁面。
按一下包含要進行去識別化資料的資料集。
在 DICOM 儲存庫清單中,從要進行去識別化的 DICOM 儲存庫「Actions」(動作) 清單中選擇「De-identify」(去識別化)。
系統會顯示「De-identify DICOM store」(去識別化 DICOM 儲存庫) 頁面。
選取「Set destination data store」(設定目的地資料儲存庫),然後選擇要儲存去識別化資料的資料集和 DICOM 儲存庫。
選取「DICOM tag de-identification」(DICOM 標記去識別化),設定資料去識別化的方式。資料去識別化的方式如下:
KEEP_ALL_PROFILE:保留所有 DICOM 中繼標記DEIDENTIFY_TAG_CONTENTS:對中繼標記中的資料進行去識別化ATTRIBUTE_CONFIDENTIALITY_BASIC_PROFILE:根據 DICOM 標準中的基本設定檔移除中繼標記MINIMAL_KEEP_LIST_PROFILE:只保留有效 DICOM 物件所需的中繼標記- 略過 ID 遮蓋:根據 DICOM 標準重新產生 UID 欄位
選取「DICOM burnt-in text redaction」(DICOM 烙印文字遮蓋),設定去識別化期間如何遮蓋圖片。您可以按照下列方式設定圖片遮蓋:
REDACT_NO_TEXT:不遮蓋圖片中的文字REDACT_SENSITIVE_TEXT:僅遮蓋圖片中的機密文字。如要一併遮蓋符合自訂規則運算式的文字,請按照下列步驟操作:- 選取「使用自訂設定」。
- 選取「使用自訂規則運算式」。
- 在「Custom Regex」(自訂規則運算式) 欄位中,輸入要比對的規則運算式模式。
- 選用:在「Group Index」(群組索引) 欄位中,輸入最多三個要遮蓋的擷取群組索引 (以半形逗號分隔),例如
1,2。如要遮蓋整個相符項目,請將欄位留空或輸入0。 - 選用:按一下「新增自訂規則運算式」,設定其他自訂規則運算式。
REDACT_ALL_TEXT:遮蓋圖片中的所有文字
按一下「去識別化」,將 DICOM 儲存庫中的資料去識別化。
REST
將資料集去識別化。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- SOURCE_DATASET_ID:資料集的 ID,其中包含要進行去識別化處理的資料
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- SOURCE_DICOM_STORE_ID:DICOM 儲存庫的 ID,其中包含要進行去識別化處理的資料
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID
JSON 要求內文:
{ "destinationStore": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "image": { "textRedactionMode": "REDACT_ALL_TEXT" } } }如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:回應會包含長時間執行的作業的 ID。如果方法呼叫可能需要相當長的時間才能完成,系統會傳回長時間執行的作業。請記下 OPERATION_ID 的值。您會在下一個步驟中用到這個值。curl
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:cat > request.json << 'EOF' { "destinationStore": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "image": { "textRedactionMode": "REDACT_ALL_TEXT" } } } EOF接著,執行下列指令來傳送 REST 要求:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/SOURCE_DICOM_STORE_ID:deidentify"PowerShell
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:@' { "destinationStore": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "image": { "textRedactionMode": "REDACT_ALL_TEXT" } } } '@ | Out-File -FilePath request.json -Encoding utf8接著,執行下列指令來傳送 REST 要求:
$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://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/SOURCE_DICOM_STORE_ID:deidentify" | Select-Object -Expand Content- 使用
projects.locations.datasets.operations.get方法,取得長時間執行的作業狀態。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- DATASET_ID:資料集 ID
- LOCATION:資料集位置
- OPERATION_ID:長時間執行的作業傳回的 ID
如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:當回應包含curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
"done": true時,表示長時間執行的作業已完成。
對 DICOM 儲存庫的部分內容進行去識別化
您可以指定篩選器,對 DICOM 儲存庫中的部分資料進行去識別化。
篩選條件會以篩選檔案的形式呈現,您可以在 DicomFilterConfig 物件中指定為 resourcePathsGcsUri 欄位的值。篩選器檔案必須位於 Cloud Storage bucket,您無法指定本機電腦或任何其他來源中的篩選器檔案。檔案位置必須採用 gs://BUCKET/PATH/TO/FILE 格式。
建立篩選器檔案
篩選器檔案會定義要進行去識別化處理的 DICOM 檔案。您可以在下列層級篩選檔案:
- 研究層級
- 系列層級
- 執行個體層級
篩選器檔案由多行組成,每行代表一個要進行去識別化的研究、系列或例項。每行都使用 /studies/STUDY_UID[/series/SERIES_UID[/instances/INSTANCE_UID]] 格式。每行結尾都有一個換行字元:\n 或 \r\n。
如果在呼叫去識別化作業時傳入的篩選器檔案中,未指定研究、系列或執行個體,則該研究、系列或執行個體不會去識別化,也不會出現在目的地 DICOM 儲存庫中。
只需提供路徑的 /studies/STUDY_UID 部分。也就是說,您可以指定 /studies/STUDY_UID 來對研究進行去識別化,或指定 /studies/STUDY_UID/series/SERIES_UID 來對系列進行去識別化。
請參考下列篩選器檔案。篩選器檔案會導致一項研究、兩個系列和三個個別例項去識別化:
/studies/1.123.456.789
/studies/1.666.333.111/series/123.456\n
/studies/1.666.333.111/series/567.890\n
/studies/1.888.999.222/series/123.456/instances/111\n
/studies/1.888.999.222/series/123.456/instances/222\n
/studies/1.888.999.222/series/123.456/instances/333\n
使用 BigQuery 建立篩選器檔案
建立篩選器檔案時,通常會先將 DICOM 儲存庫中的中繼資料匯出至 BigQuery。這樣一來,您就能使用 BigQuery 查看 DICOM 儲存庫中 DICOM 資料的研究、系列和執行個體 UID。接著就可按下列步驟操作:
查詢您感興趣的研究、系列和執行個體 UID。舉例來說,將中繼資料匯出至 BigQuery 後,您可以執行下列查詢,將研究、序列和執行個體 UID 串連成與篩選器檔案需求相容的格式:
SELECT CONCAT ('/studies/', StudyInstanceUID, '/series/', SeriesInstanceUID, '/instances/', SOPInstanceUID) FROM [PROJECT_ID:BIGQUERY_DATASET.BIGQUERY_TABLE]
如果查詢傳回大型結果集,您可以將查詢結果儲存至 BigQuery 的目的地資料表,具體化新資料表。
將查詢結果儲存至目的地資料表後,您可以將目的地資料表的內容儲存至檔案,並匯出至 Cloud Storage。如需操作步驟,請參閱「匯出資料表資料」。匯出的檔案就是篩選器檔案。在匯出作業中指定篩選器時,您會使用篩選器檔案在 Cloud Storage 中的位置。
手動建立篩選器檔案
您可以建立含有自訂內容的篩選器檔案,並上傳至 Cloud Storage bucket。在去識別化作業中指定篩選器時,您會使用 Cloud Storage 中的篩選器檔案位置。下列範例說明如何使用 gcloud storage cp 指令,將篩選器檔案上傳至 Cloud Storage bucket:
gcloud storage cp PATH/TO/FILTER_FILE gs://BUCKET/DIRECTORY
例如:
gcloud storage cp /home/user/Desktop/filters.txt gs://my-bucket/my-directory
使用篩選器
設定篩選器檔案後,您可以將其做為值傳遞至 filterConfig 物件中的 resourcePathsGcsUri 欄位。
下列範例會展開在 DICOM 儲存庫層級去識別化資料,但 Cloud Storage 中提供的篩選器檔案會決定哪些 DICOM 資源會去識別化。
REST
將資料集去識別化。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- LOCATION:資料集位置
- SOURCE_DATASET_ID:資料集的 ID,其中包含要進行去識別化處理的資料
- DESTINATION_DATASET_ID:寫入去識別化資料的目的地資料集 ID
- SOURCE_DICOM_STORE_ID:DICOM 儲存庫 ID,其中包含要進行去識別化處理的資料
- DESTINATION_DICOM_STORE_ID:目的地資料集中的 DICOM 儲存庫 ID
- BUCKET/PATH/TO/FILE:篩選器檔案在 Cloud Storage bucket 中的位置
JSON 要求內文:
{ "destinationStore": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "image": { "textRedactionMode": "REDACT_ALL_TEXT" } }, "filterConfig": { "resourcePathGcsUri": "gs://BUCKET/PATH/TO/FILE" } }如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:回應會包含長時間執行的作業的 ID。如果方法呼叫可能需要相當長的時間才能完成,系統會傳回長時間執行的作業。請記下 OPERATION_ID 的值。您會在下一個步驟中用到這個值。curl
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:cat > request.json << 'EOF' { "destinationStore": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "image": { "textRedactionMode": "REDACT_ALL_TEXT" } }, "filterConfig": { "resourcePathGcsUri": "gs://BUCKET/PATH/TO/FILE" } } EOF接著,執行下列指令來傳送 REST 要求:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/SOURCE_DICOM_STORE_ID:deidentify"PowerShell
將要求主體儲存在名為
request.json的檔案中。 在終端機中執行下列指令,在目前目錄中建立或覆寫這個檔案:@' { "destinationStore": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "image": { "textRedactionMode": "REDACT_ALL_TEXT" } }, "filterConfig": { "resourcePathGcsUri": "gs://BUCKET/PATH/TO/FILE" } } '@ | Out-File -FilePath request.json -Encoding utf8接著,執行下列指令來傳送 REST 要求:
$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://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/SOURCE_DICOM_STORE_ID:deidentify" | Select-Object -Expand Content- 使用
projects.locations.datasets.operations.get方法,取得長時間執行的作業狀態。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案的 ID
- DATASET_ID:資料集 ID
- LOCATION:資料集位置
- OPERATION_ID:長時間執行的作業傳回的 ID
如要傳送要求,請選擇以下其中一個選項:
輸出內容如下:當回應包含curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。APIs Explorer 面板會在頁面右側開啟。 您可以與這項工具互動,傳送要求。 填寫所有必填欄位,然後按一下「Execute」(執行)。
"done": true時,表示長時間執行的作業已完成。
排解 DICOM 去識別化作業問題
如果 DICOM 去識別化作業期間發生錯誤,系統會將錯誤記錄到 Cloud Logging。詳情請參閱「在 Cloud Logging 中查看錯誤記錄」。
如果整項作業傳回錯誤,請參閱「排解長時間執行的作業」。