בדף הזה מוסבר איך משתמשים בהגדרות של גרסה 1 של DicomConfig כדי להסיר פרטים מזהים מנתונים רגישים במכונות DICOM ברמות הבאות:
- ברמת מערך הנתונים באמצעות
datasets.deidentify - ברמת מאגר ה-DICOM באמצעות
dicomStores.deidentify
בדף הזה מוסבר גם איך להחיל מסננים כשמסירים פרטים מזהים מנתונים ברמת מאגר ה-DICOM.
סקירה כללית על הסרת פרטי הזיהוי
הסרת פרטי הזיהוי ברמת מערך הנתונים
כדי להסיר את פרטי הזיהוי מנתוני DICOM ברמת מערך הנתונים, מפעילים את הפעולה datasets.deidentify. הקריאה ל-API להסרת פרטי הזיהוי כוללת את הרכיבים הבאים:
- קבוצת הנתונים של המקור: קבוצת נתונים שמכילה מאגרי DICOM עם מופע אחד או יותר שמכילים מידע רגיש. כשמפעילים את הפעולה
deidentify, כל המופעים בכל מאגרי ה-DICOM במערך הנתונים עוברים תהליך של הסרת פרטי הזיהוי. - מערך הנתונים של היעד: הסרת פרטי הזיהוי לא משפיעה על מערך הנתונים המקורי או על הנתונים שבו. במקום זאת, עותקים של הנתונים המקוריים ללא פרטים מזהים נכתבים במערך נתונים חדש, שנקרא מערך נתוני היעד.
- מה להסיר פרטי זיהוי: פרמטרים של הגדרה שמציינים איך לעבד את קבוצת הנתונים. כדי להגדיר הסרת פרטים מזהים מ-DICOM, אתם יכולים להסיר פרטים מזהים ממטא-נתונים של מופע DICOM (באמצעות מילות מפתח של תגים) או מטקסט שמוטמע בתמונות DICOM. לשם כך, צריך לציין את הפרמטרים האלה באובייקט
DeidentifyConfigולבצע את הפעולות הבאות:- הגדרת השדה
configבגוף הבקשה - אחסון בקובץ JSON ב-Cloud Storage וציון המיקום של הקובץ בקטגוריה באמצעות השדה
gcsConfigUriבגוף הבקשה.
- הגדרת השדה
רוב הדוגמאות במדריך הזה מראות איך להסיר את פרטי הזיהוי מנתוני DICOM ברמת מערך הנתונים.
הסרת פרטי הזיהוי ברמת מאגר ה-DICOM
הסרת פרטי הזיהוי מנתוני DICOM ברמת מאגר ה-DICOM מאפשרת לכם לשלוט טוב יותר בנתונים שמהם יוסרו פרטי הזיהוי. לדוגמה, אם יש לכם קבוצת נתונים עם כמה מאגרי DICOM, אתם יכולים להסיר פרטי זיהוי מכל מאגר DICOM בהתאם לסוג הנתונים שקיימים במאגר.
כדי להסיר פרטי זיהוי מנתוני DICOM במאגר DICOM, צריך להפעיל את ה-method dicomStores.deidentify. הקריאה ל-API להסרת פרטי הזיהוי כוללת את הרכיבים הבאים:
- מאגר ה-DICOM המקורי: מאגר DICOM שמכיל אירוע אחד או יותר עם מידע רגיש. כשמפעילים את הפעולה
deidentify, כל המופעים במאגר ה-DICOM עוברים הסרת פרטי זיהוי. - מאגר ה-DICOM של היעד: הסרת פרטי הזיהוי לא משפיעה על מאגר ה-DICOM המקורי או על הנתונים שלו. במקום זאת, עותקים של הנתונים המקוריים ללא פרטים מזהים נכתבים במאגר ה-DICOM של היעד. מאגר ה-DICOM של היעד כבר צריך להיות קיים.
- מה להסיר פרטי זיהוי: פרמטרים של הגדרה שמציינים איך לעבד את מאגר ה-DICOM. כדי להגדיר הסרת פרטים מזהים מ-DICOM, אפשר להסיר פרטים מזהים ממטא-נתונים של מופע DICOM (באמצעות מילות מפתח של תגים) או מטקסט שמוטמע בתמונות DICOM. לשם כך, צריך לציין את הפרמטרים האלה באובייקט
DeidentifyConfigולהעביר אותו באחת מהדרכים הבאות:- הגדרת השדה
configבגוף הבקשה - אחסון בקובץ JSON ב-Cloud Storage וציון המיקום של הקובץ בקטגוריה באמצעות השדה
gcsConfigUriבגוף הבקשה.
- הגדרת השדה
דוגמה להסרת פרטי זיהוי מנתוני DICOM ברמת מאגר ה-DICOM מופיעה במאמר הסרת פרטי זיהוי מנתונים ברמת מאגר ה-DICOM.
מסננים
כדי להסיר פרטי זיהוי מקבוצת משנה של נתונים במאגר DICOM, אתם יכולים להגדיר קובץ מסנן ולציין את הקובץ בבקשה dicomStores.deidentify. לדוגמה, ראו הסרת פרטי הזיהוי של קבוצת משנה של מאגר 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"]}
}
]
הסרת פרטי הזיהוי באמצעות תגי רשימת פריטים לשמירה
כשמציינים תג keeplist באובייקט DicomConfig, התגים הבאים מתווספים כברירת מחדל:
StudyInstanceUIDSeriesInstanceUIDSOPInstanceUIDTransferSyntaxUIDMediaStorageSOPInstanceUIDMediaStorageSOPClassUIDPixelDataRowsColumnsSamplesPerPixelBitsAllocatedBitsStoredHighbitPhotometricInterpretationPixelRepresentationNumberOfFramesPlanarConfigurationPixelAspectRatioSmallestImagePixelValueLargestImagePixelValueRedPaletteColorLookupTableDescriptorGreenPaletteColorLookupTableDescriptorBluePaletteColorLookupTableDescriptorRedPaletteColorLookupTableDataGreenPaletteColorLookupTableDataBluePaletteColorLookupTableDataICCProfileColorSpaceWindowCenterWindowWidthVOILUTFunction
הפעולה deidentify לא מצנזרת את התגים הקודמים. עם זאת, הערכים של חלק מהתגים נוצרים מחדש, כלומר הערכים מוחלפים בערך אחר באמצעות טרנספורמציה דטרמיניסטית.
מידע נוסף זמין בקטע Retain UIDs Option בתקן DICOM. כדי לשמור על הערכים המקוריים של התגים הקודמים, משתמשים באפשרות SkipIdRedaction.
אם לא מספקים תגי רשימת היתרים, לא מצנזרים אף תג DICOM במערך הנתונים.
הדוגמאות הבאות ממחישות איך להסיר את פרטי הזיהוי מקבוצת נתונים שמכילה מאגרי DICOM ונתוני DICOM, תוך השארת חלק מהתגים ללא שינוי.
אחרי ששולחים את התמונה ל-Cloud Healthcare API, היא נראית כך: המטא-נתונים שמוצגים בפינות העליונות של התמונה צונזרו, אבל המידע הרפואי המוגן (PHI) שמוטמע בתחתית התמונה נשאר. כדי להסיר גם את הטקסט המוטמע, קראו את המאמר צנזור טקסט מוטמע בתמונות.

REST
הסרת פרטי הזיהוי מקבוצת הנתונים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- SOURCE_DATASET_ID: מזהה מערך הנתונים שמכיל את הנתונים שרוצים להסיר מהם את פרטי הזיהוי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
תוכן בקשת JSON:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "keepList": { "tags": [ "PatientID" ] } } } }כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של 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- כדי לקבל את הסטטוס של הפעולה הממושכת, משתמשים ב-method
projects.locations.datasets.operations.get.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- DATASET_ID: מזהה מערך הנתונים
- LOCATION: המיקום של מערך הנתונים
- OPERATION_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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
"done": true, הפעולה הממושכת הסתיימה. - אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה UID חדש של מחקרים, מזהה UID חדש של סדרות ומזהה UID חדש של מופעים, ולכן קודם צריך לחפש במערך הנתונים החדש את המופע שהוסרו ממנו פרטי הזיהוי.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- SOURCE_DATASET_LOCATION: המיקום של מערך הנתונים המקורי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו:
בטבלה הבאה מוצגים השינויים במזהה הייחודי של המחקרים, במזהה הייחודי של הסדרות ובמזהה הייחודי של המופעים:מטא-נתונים של המכונה המקורית מטא-נתונים של מופע ללא פרטים מזהים מזהה ייחודי של מחקרים ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763מזהה ייחודי של הסדרה ( 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
- LOCATION: המיקום של מערך הנתונים
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
הפלט מכיל את המטא-נתונים החדשים. אתם יכולים להשוות בין המטא-נתונים החדשים לבין המטא-נתונים המקוריים כדי לראות את ההשפעה של הטרנספורמציה.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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
Go
Java
Node.js
Python
הסרת פרטי הזיהוי באמצעות תגי רשימת הסרה
אפשר לציין רשימת הסרה באובייקט DicomConfig. הפעולה deidentify תצנזר רק את התגים שצוינו ברשימה. אם לא מספקים תגי removelist, פעולת הסרת פרטי הזיהוי ממשיכה כרגיל, אבל לא מתבצעת צנזורה של תגי DICOM במערך הנתונים של היעד.
כשמציינים רשימת הסרה, התג OverlayData מתווסף כברירת מחדל כי נתוני השכבה עשויים להכיל מידע בריאותי אישי (PHI).
אי אפשר להוסיף לרשימת ההסרה תגים שמתווספים כברירת מחדל לרשימת ההכללה.
בדוגמאות הבאות מוסבר איך להסיר את פרטי הזיהוי מקבוצת נתונים שמכילה מאגרי DICOM ונתוני DICOM, על ידי הסרת כל התגים שברשימת ההסרה. תגים שלא נמצאים ברשימת ההסרה לא משתנים.
אחרי ששולחים את התמונה ל-Cloud Healthcare API, היא נראית כך: מבין התגים שסופקו ברשימת ההסרה, רק PatientBirthDate הוסר מהתמונה, כי זה התג היחיד מרשימת ההסרה שתואם למטא-נתונים שגלויים בתמונה.
ה-PatientBirthDate בפינה העליונה של התמונה צונזר בהתאם להגדרות ברשימת ההסרה, אבל ה-PHI שמוטמע בתחתית התמונה נשאר. כדי להסיר גם את הטקסט המוטמע, קראו את המאמר צנזור טקסט מוטמע בתמונות.

REST
הסרת פרטי הזיהוי מקבוצת הנתונים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- SOURCE_DATASET_ID: מזהה מערך הנתונים שמכיל את הנתונים שרוצים להסיר מהם את פרטי הזיהוי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
תוכן בקשת JSON:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "removeList": { "tags": [ "PatientBirthName", "PatientBirthDate", "PatientAge", "PatientSize", "PatientWeight", "PatientAddress", "PatientMotherBirthName" ] } } } }כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של 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- משתמשים ב-method
projects.locations.datasets.operations.getכדי לקבל את הסטטוס של הפעולה הממושכת.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- DATASET_ID: מזהה מערך הנתונים
- LOCATION: המיקום של מערך הנתונים
- OPERATION_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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
"done": true, הפעולה הממושכת הסתיימה. - אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה UID חדש של מחקרים, מזהה UID חדש של סדרות ומזהה UID חדש של מופעים, ולכן קודם צריך לחפש במערך הנתונים החדש את המופע שהוסרו ממנו פרטי הזיהוי.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- SOURCE_DATASET_LOCATION: המיקום של מערך הנתונים המקורי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו:
בטבלה הבאה מוצגים השינויים במזהה הייחודי של המחקרים, במזהה הייחודי של הסדרות ובמזהה הייחודי של המופעים:המטא-נתונים של המכונה המקורית מטא-נתונים של מופע ללא פרטים מזהים מזהה ייחודי של מחקרים ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763מזהה ייחודי של הסדרה ( 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
- LOCATION: המיקום של מערך הנתונים
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
הפלט מכיל את המטא-נתונים החדשים. אתם יכולים להשוות בין המטא-נתונים החדשים לבין המטא-נתונים המקוריים כדי לראות את ההשפעה של הטרנספורמציה.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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
הסרת פרטים מזהים באמצעות פרופיל סינון תגים
במקום לציין אילו תגים לשמור או להסיר, אתם יכולים להגדיר TagFilterProfile באובייקט DicomConfig. פרופיל סינון תגים הוא פרופיל מוגדר מראש שקובע אילו תגים לשמור, להסיר או לשנות. בTagFilterProfile מפורטים הפרופילים הזמינים.
הדוגמאות הבאות מראות איך להסיר את פרטי הזיהוי ממערך נתונים שמכיל מאגרי DICOM ונתוני DICOM, באמצעות פרופיל מסנן התגים ATTRIBUTE_CONFIDENTIALITY_BASIC_PROFILE.
הפרופיל הזה של סינון תגים מסיר תגים על סמך פרופיל הבסיס של סודיות המאפיינים בתקן DICOM.
Cloud Healthcare API לא תואם באופן מלא ל-Attribute Confidentiality Basic Profile. לדוגמה, Cloud Healthcare API לא בודק את ההגבלות של Information Object Definition (IOD) כשבוחרים פעולה לתג.
אחרי ששולחים את התמונה ל-Cloud Healthcare API באמצעות פרופיל סינון התגים ATTRIBUTE_CONFIDENTIALITY_BASIC_PROFILE, התמונה נראית ככה: למרות שהמטא-נתונים שמוצגים בפינות העליונות של התמונה צונזרו, המידע הרפואי המוגן שמוטמע בתחתית התמונה נשאר.
כדי להסיר גם את הטקסט המוטמע, קראו את המאמר צנזור טקסט מוטמע בתמונות.

REST
הסרת פרטי הזיהוי מקבוצת הנתונים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- SOURCE_DATASET_ID: מזהה מערך הנתונים שמכיל את הנתונים שרוצים להסיר מהם את פרטי הזיהוי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
תוכן בקשת JSON:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "ATTRIBUTE_CONFIDENTIALITY_BASIC_PROFILE" } } }כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של 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- כדי לקבל את הסטטוס של הפעולה הממושכת, משתמשים ב-method
projects.locations.datasets.operations.get.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- DATASET_ID: מזהה מערך הנתונים
- LOCATION: המיקום של מערך הנתונים
- OPERATION_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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
"done": true, הפעולה הממושכת הסתיימה. - אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה UID חדש של מחקרים, מזהה UID חדש של סדרות ומזהה UID חדש של מופעים, ולכן קודם צריך לחפש במערך הנתונים החדש את המופע שהוסרו ממנו פרטי הזיהוי.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- SOURCE_DATASET_LOCATION: המיקום של מערך הנתונים המקורי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו:
בטבלה הבאה מוצגים השינויים במזהה הייחודי של המחקרים, במזהה הייחודי של הסדרות ובמזהה הייחודי של המופעים:מטא-נתונים של המכונה המקורית מטא-נתונים של מופע ללא פרטים מזהים מזהה ייחודי של מחקרים ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763מזהה ייחודי של הסדרה ( 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
- LOCATION: המיקום של מערך הנתונים
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
הפלט מכיל את המטא-נתונים החדשים. אתם יכולים להשוות בין המטא-נתונים החדשים לבין המטא-נתונים המקוריים כדי לראות את ההשפעה של הטרנספורמציה.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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
הסרת פרטי הזיהוי של נתונים במסוף Google Cloud
כדי להסיר פרטים מזהים מהנתונים במסוף Google Cloud :
נכנסים לדף Datasets במסוף Google Cloud .
ברשימה Actions של מערך הנתונים שרוצים להסיר ממנו את פרטי הזיהוי, בוחרים באפשרות De-identify.
מופיע הדף De-identify Dataset.
בוחרים באפשרות Set destination dataset ומזינים שם למערך הנתונים החדש שבו יישמרו הנתונים ללא פרטים מזהים.
בוחרים באפשרות DICOM tag de-identification כדי לבחור את הפרופיל שבו יוסרו פרטי הזיהוי מהנתונים. אפשר להסיר את פרטי הזיהוי מהנתונים בדרכים הבאות:
-
KEEP_ALL_PROFILE– שמירה של כל המטא תגים של DICOM -
DEIDENTIFY_TAG_CONTENTS– הסרת פרטי הזיהוי מהנתונים במטא תגים ATTRIBUTE_CONFIDENTIALITY_BASIC_PROFILE– הסרת מטא תגים בהתאם לפרופיל הבסיסי בתקן DICOM-
MINIMAL_KEEP_LIST_PROFILE– שמירה רק של המטא-תגים שנדרשים לאובייקט DICOM תקין - דילוג על צנזור מזהים – יצירה מחדש של שדות UID כפי שנקבע בתקן DICOM
-
בוחרים באפשרות DICOM burnt-in text redaction כדי להגדיר איך תתבצע צנזורת התמונות במהלך הסרת פרטי הזיהוי. כך מגדירים צנזור תמונות:
REDACT_NO_TEXT– אל תצנזרו טקסט בתמונות-
REDACT_SENSITIVE_TEXT– צנזור של טקסט רגיש בלבד בתמונות. כדי לצנזר גם טקסט שתואם לביטויים רגולריים בהתאמה אישית:- לוחצים על שימוש בהגדרה מותאמת אישית.
- בוחרים באפשרות שימוש בביטוי רגולרי מותאם אישית.
- בשדה ביטוי רגולרי בהתאמה אישית, מזינים את תבנית הביטוי הרגולרי להתאמה.
- אופציונלי: בשדה Group Index, מזינים עד שלושה אינדקסים של קבוצות לחילוץ שמופרדים בפסיקים כדי לצנזר, לדוגמה
1,2. כדי לצנזר את כל ההתאמה, משאירים את השדה ריק או מזינים0. - אופציונלי: לוחצים על הוספת ביטוי רגולרי מותאם אישית כדי להגדיר ביטויים רגולריים מותאמים אישית נוספים.
REDACT_ALL_TEXT– צנזור כל הטקסט בתמונות
לוחצים על De-identify כדי להסיר את פרטי הזיהוי מהנתונים במערך הנתונים.
צנזור טקסט שמוטמע בתמונות
באמצעות Cloud Healthcare API אפשר לצנזר טקסט רגיש שמוטמע בתמונות. ה-API מזהה מידע רגיש כמו PHI, ומסתיר אותו באמצעות מלבן אטום. ה-API מחזיר את אותן תמונות DICOM שנתתם לו, באותו פורמט, אבל כל טקסט שזוהה כמכיל מידע רגיש לפי הקריטריונים שלכם מצונזר.
כדי לצנזר טקסט שמוטמע בתמונות, מציינים אפשרות של TextRedactionMode בתוך אובייקט ImageConfig. אפשר לעיין במסמכי התיעוד של TextRedactionMode כדי לראות את הערכים האפשריים.
צנזור כל הטקסט שמוטמע בתמונה
בדוגמאות הבאות מוסבר איך לצנזר את כל הטקסט המוטמע בתמונות DICOM במערך נתונים. כדי לעשות את זה, מציינים את הערך REDACT_ALL_TEXT בשדה TextRedactionMode.
אחרי ששולחים את התמונה ל-Cloud Healthcare API באמצעות האפשרות REDACT_ALL_TEXT, התמונה נראית כך: הטקסט הצרוב בתחתית התמונה הוסר, אבל המטא-נתונים בפינות העליונות של התמונה נשארו. כדי להסיר גם את המטא-נתונים, ראו הסרת פרטי הזיהוי של תגי DICOM.

REST
הסרת פרטי הזיהוי מקבוצת הנתונים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- SOURCE_DATASET_ID: מזהה מערך הנתונים שמכיל את הנתונים שרוצים להסיר מהם את פרטי הזיהוי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
תוכן בקשת JSON:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": {}, "image": { "textRedactionMode": "REDACT_ALL_TEXT" } } }כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של 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- משתמשים ב-method
projects.locations.datasets.operations.getכדי לקבל את הסטטוס של הפעולה הממושכת.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- DATASET_ID: מזהה מערך הנתונים
- LOCATION: המיקום של מערך הנתונים
- OPERATION_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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
"done": true, הפעולה הממושכת הסתיימה. - אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה UID חדש של מחקרים, מזהה UID חדש של סדרות ומזהה UID חדש של מופעים, ולכן קודם צריך לחפש במערך הנתונים החדש את המופע שהוסרו ממנו פרטי הזיהוי.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- SOURCE_DATASET_LOCATION: המיקום של מערך הנתונים המקורי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו:
בטבלה הבאה מוצגים השינויים במזהה הייחודי של המחקרים, במזהה הייחודי של הסדרות ובמזהה הייחודי של המופעים:מטא-נתונים של המכונה המקורית מטא-נתונים של מופע ללא פרטים מזהים מזהה ייחודי של מחקרים ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763מזהה ייחודי של הסדרה ( 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 במערך נתונים. כדי לעשות את זה, מציינים את הערך REDACT_SENSITIVE_TEXT בשדה TextRedactionMode.
סוגי המידע שצוינו בסוגי המידע שמוגדרים כברירת מחדל ב-DICOM מצונזרים כשמציינים את REDACT_SENSITIVE_TEXT. שני סוגי מידע מותאמים אישית נוספים מוחלים גם על צנזור של:
- מזהי מטופלים, כמו מספרי תיקים רפואיים (MRN)
- מספרי קטלוג
בתמונה הבאה מוצג צילום רנטגן של מטופל, ללא צנזור:

אחרי ששולחים את התמונה ל-Cloud Healthcare API באמצעות האפשרות REDACT_SENSITIVE_TEXT, התמונה נראית כך:

אפשר לראות שקרה הדבר הבא:
- ה-
PERSON_NAMEבפינה הימנית התחתונה של התמונה צונזר - ה-
DATEבפינה הימנית התחתונה של התמונה צונזר
המין של המטופל לא צונזר כי הוא לא נחשב לטקסט רגיש לפי סוגי המידע שמוגדרים כברירת מחדל ב-DICOM.
REST
הסרת פרטי הזיהוי מקבוצת הנתונים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- SOURCE_DATASET_ID: מזהה מערך הנתונים שמכיל את הנתונים שרוצים להסיר מהם את פרטי הזיהוי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
תוכן בקשת JSON:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": {}, "image": { "textRedactionMode": "REDACT_SENSITIVE_TEXT" } } }כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של 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- משתמשים ב-method
projects.locations.datasets.operations.getכדי לקבל את הסטטוס של הפעולה הממושכת.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- DATASET_ID: מזהה מערך הנתונים
- LOCATION: המיקום של מערך הנתונים
- OPERATION_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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
"done": true, הפעולה הממושכת הסתיימה. - אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה UID חדש של מחקרים, מזהה UID חדש של סדרות ומזהה UID חדש של מופעים, ולכן קודם צריך לחפש במערך הנתונים החדש את המופע שהוסרו ממנו פרטי הזיהוי.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- SOURCE_DATASET_LOCATION: המיקום של מערך הנתונים המקורי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו:
בטבלה הבאה מוצגים השינויים במזהה הייחודי של המחקרים, במזהה הייחודי של הסדרות ובמזהה הייחודי של המופעים:מטא-נתונים של המכונה המקורית מטא-נתונים של מופע ללא פרטים מזהים מזהה ייחודי של מחקרים ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763מזהה ייחודי של הסדרה ( 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, אפשר גם לציין תבניות של ביטויים רגולריים בהתאמה אישית בשדה customRegexes של האובייקט ImageConfig כדי לזהות ולצנזר טקסט תואם שמוטמע בתמונות DICOM. כל פריט במערך customRegexes יכול לכלול את השדות הבאים:
-
pattern: תבנית הביטוי הרגולרי להתאמה לטקסט שזוהה בתמונה. התבנית חייבת להשתמש בתחביר RE2. RE2 לא תומך בחלק מהמבנים, כמו טענות נכונות (assertions) של lookahead ו-lookbehind. -
groupIndexes: רשימה אופציונלית של אינדקסים של קבוצות לחילוץ שצריך לצנזר כשהתבנית תואמת. אם משמיטים את הפרמטר הזה, כל ההתאמה מצונזרת. הכללים הבאים חלים:- אפשר לציין עד שלושה אינדקסים של קבוצות לכל ביטוי רגולרי מותאם אישית.
- האינדקס
0מצנזר את כל ההתאמה ואי אפשר לשלב אותו עם אינדקסים אחרים. - אינדקסים של
1ומעלה מתייחסים לקבוצות לחילוץ ב-pattern, לפי הסדר. כל אינדקס לא יכול לחרוג ממספר הקבוצות לחילוץ ב-pattern.
אם התבנית לא תקינה, הבקשה תיכשל ותוצג השגיאה INVALID_ARGUMENT.
הדוגמאות הבאות מראות איך להסיר את פרטי הזיהוי ממערך נתונים או מחנות DICOM באמצעות ביטוי רגולרי מותאם אישית:
REST
הסרת פרטי הזיהוי של מערך הנתונים או של מאגר ה-DICOM באמצעות ביטוי רגולרי מותאם אישית.
כדי להסיר את פרטי הזיהוי מכל מאגרי ה-DICOM במערך נתונים (
datasets.deidentify):לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- SOURCE_DATASET_ID: מזהה מערך הנתונים שמכיל את הנתונים שרוצים להסיר מהם את פרטי הזיהוי
- DESTINATION_DATASET_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] } ] } } }כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של 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
- LOCATION: המיקום של מערך הנתונים
- SOURCE_DATASET_ID: מזהה מערך הנתונים שמכיל את הנתונים שרוצים להסיר מהם את פרטי הזיהוי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- SOURCE_DICOM_STORE_ID: המזהה של מאגר ה-DICOM שמכיל את הנתונים שרוצים להסיר מהם את פרטי הזיהוי
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד
תוכן בקשת 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] } ] } } }כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של 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- משתמשים ב-method
projects.locations.datasets.operations.getכדי לקבל את הסטטוס של הפעולה הממושכת.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- DATASET_ID: מזהה מערך הנתונים
- LOCATION: המיקום של מערך הנתונים
- OPERATION_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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
"done": true, הפעולה הממושכת הסתיימה. - אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה UID חדש של מחקרים, מזהה UID חדש של סדרות ומזהה UID חדש של מופעים, ולכן קודם צריך לחפש במערך הנתונים החדש את המופע שהוסרו ממנו פרטי הזיהוי.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- SOURCE_DATASET_LOCATION: המיקום של מערך הנתונים המקורי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו:
בטבלה הבאה מוצגים השינויים במזהה הייחודי של המחקרים, במזהה הייחודי של הסדרות ובמזהה הייחודי של המופעים:מטא-נתונים של המכונה המקורית מטא-נתונים של מופע ללא פרטים מזהים מזהה ייחודי של מחקרים ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763מזהה ייחודי של הסדרה ( 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 ברמה מפורטת יותר, אתם יכולים לשלב בין הסרת פרטים מזהים באמצעות תגים לבין צנזור של טקסט שמוטמע בתמונות. לדוגמה, אם משלבים את הערך REDACT_ALL_TEXT בשדה TextRedactionMode עם הערך DEIDENTIFY_TAG_CONTENTS בשדה TagFilterProfile, אפשר לבצע את הפעולות הבאות:
-
REDACT_ALL_TEXT: צנזור כל הטקסט שמוטמע בתמונה. DEIDENTIFY_TAG_CONTENTS: בדיקת תוכן התג ושינוי טקסט רגיש. למידע נוסף על ההתנהגות שלDEIDENTIFY_TAG_CONTENTS, ראו הגדרת ברירת המחדל.
אחרי ששולחים את התמונה ל-Cloud Healthcare API באמצעות האפשרויות REDACT_ALL_TEXT ו-DEIDENTIFY_TAG_CONTENTS, התמונה נראית כך: שימו לב לשינויים הבאים:
- השמות בפינה הימנית העליונה ובפינה השמאלית העליונה של התמונה השתנו באמצעות
CryptoHashConfig - התאריכים בפינה הימנית העליונה ובפינה השמאלית העליונה של התמונה שונו באמצעות
DateShiftConfig - הטקסט המוטמע בתחתית התמונה מצונזר

REST
הסרת פרטי הזיהוי מקבוצת הנתונים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- SOURCE_DATASET_ID: מזהה מערך הנתונים שמכיל את הנתונים שרוצים להסיר מהם את פרטי הזיהוי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
תוכן בקשת JSON:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "image": { "textRedactionMode": "REDACT_ALL_TEXT" } } }כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של 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- משתמשים ב-method
projects.locations.datasets.operations.getכדי לקבל את הסטטוס של הפעולה הממושכת.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- DATASET_ID: מזהה מערך הנתונים
- LOCATION: המיקום של מערך הנתונים
- OPERATION_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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
"done": true, הפעולה הממושכת הסתיימה. - אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה UID חדש של מחקרים, מזהה UID חדש של סדרות ומזהה UID חדש של מופעים, ולכן קודם צריך לחפש במערך הנתונים החדש את המופע שהוסרו ממנו פרטי הזיהוי.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- SOURCE_DATASET_LOCATION: המיקום של מערך הנתונים המקורי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו:
אחזור המטא-נתונים של המכונה באמצעות הערכים החדשים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
הפלט מכיל את המטא-נתונים החדשים. אתם יכולים להשוות בין המטא-נתונים החדשים לבין המטא-נתונים המקוריים כדי לראות את ההשפעה של הטרנספורמציה.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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
שימוש בטיפוסי מידע ובטרנספורמציות פרימיטיביות עם תגי DICOM
ב-Cloud Healthcare API אפשר להשתמש בסוגי מידע (infoTypes) כדי להגדיר אילו נתונים ייסרקו כשמתבצעת הסרת פרטי זיהוי בתגים. infoType הוא סוג של מידע רגיש, כמו שם של מטופל, כתובת אימייל, מספר טלפון, מספר זיהוי או מספר כרטיס אשראי.
טרנספורמציות פרימיטיביות הן כללים שמשמשים לטרנספורמציה של ערך קלט. כדי להתאים אישית את הסרת פרטי הזיהוי של תגי DICOM, אפשר להחיל טרנספורמציה פרימיטיבית על ה-infoType של כל תג. לדוגמה, אפשר להסיר את פרטי הזיהוי של שם המשפחה של מטופל ולהחליף אותו בסדרה של כוכביות, על ידי ציון infoType של LAST_NAME עם הטרנספורמציה הפרימיטיבית CharacterMaskConfig.
סוגי מידע (infoTypes) שמוגדרים כברירת מחדל ב-DICOM
סוגי המידע הרגיש שמוגדרים כברירת מחדל ב-DICOM ומשמשים להסרת פרטים מזהים ממטא-נתונים הם:
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 משתמש בסוגי המידע שלמעלה, אבל גם מחיל שני סוגי מידע מותאמים אישית נוספים על טקסט רגיש בתמונה:
- מזהי מטופלים, כמו מספרי תיקים רפואיים (MRN)
- מספרי קטלוג
אפשרויות טרנספורמציה פרימיטיביות
אפשרויות הטרנספורמציה הפרימיטיביות של Cloud Healthcare API כוללות:
RedactConfig: מצנזר ערך על ידי הסרה שלו.-
CharacterMaskConfig: מסתירה מחרוזת באופן מלא או חלקי על ידי החלפת תווי קלט בתו קבוע שצוין. -
DateShiftConfig: הזזת תאריכים במספר אקראי של ימים, עם אפשרות לשמור על עקביות באותו הקשר. -
CryptoHashConfig: משתמשת ב-SHA-256 כדי להחליף את ערכי הקלט בייצוג בקידוד Base64 של מחרוזת פלט מגובבת שנוצרה באמצעות מפתח נתון להצפנת נתונים. -
ReplaceWithInfoTypeConfig: החלפת ערך קלט בשם של ה-infoType שלו.
הגדרת תצורות ב-TextConfig
סוגי המידע והטרנספורמציות הפרימיטיביות מצוינים בתוך InfoTypeTransformation, שהוא אובייקט בתוך TextConfig.
סוגי המידע מוזנים במערך infoTypes כערכים מופרדים בפסיקים.
לא חובה לציין infoType. אם לא תציינו לפחות infoType אחד, הטרנספורמציה תחול על סוגי ה-infoType שמוגדרים כברירת מחדל ב-DICOM ב-Cloud Healthcare API.
אם מציינים סוגי מידע ב-InfoTypeTransformation, צריך לציין לפחות טרנספורמציה פרימיטיבית אחת.
אפשר להחיל InfoTypeTransformation רק על הפרופיל DEIDENTIFY_TAG_CONTENTS.
אי אפשר להחיל InfoTypeTransformation על הפרופילים האחרים שמופיעים ב-TagFilterProfile.
בקטעים הבאים מוסבר איך להשתמש בטרנספורמציות הפרימיטיביות שזמינות ב-InfoTypeTransformation, יחד עם infoTypes, כדי להתאים אישית את האופן שבו מתבצעת הסרת פרטי הזיהוי מתגי DICOM. הדוגמאות משתמשות בתמונה לדוגמה שמופיעה בסקירה הכללית של הדוגמאות ובמטא-נתונים לדוגמה שמופיעים בהסרת פרטים מזהים מתגי DICOM.
הגדרות ברירת מחדל
כברירת מחדל, כשמגדירים את הפרופיל DEIDENTIFY_TAG_CONTENTS בלי לספק הגדרות באובייקט TextConfig, ה-Cloud Healthcare API מחליף את המידע הרגיש באמצעות סוגי המידע שמוגדרים כברירת מחדל ב-DICOM.
עם זאת, ההתנהגות של סוגי המידע DATE ו-PERSON_NAME שונה, כמו שמוצג בהמשך:
DateShiftConfigמוחל על טקסט שמסווג כ-DATEinfoType. ב-DateShiftConfigנעשה שימוש בטכניקה של הזזת תאריכים עם הפרש של 100 ימים.CryptoHashConfigמוחל על טקסט שמסווג כ-PERSON_NAMEinfoType. CryptoHashConfigמבצע טוקניזציה על ידי יצירת ערך חלופי באמצעות גיבוב קריפטוגרפי.
ההתנהגות הבאה רלוונטית גם:
- כל גיל של מטופל שערכו גדול מ-90 או שווה לו מומר ל-90.
- אם אי אפשר להחיל טרנספורמציה בגלל מגבלות של פורמט DICOM, המערכת מספקת ערך זמני לשמירת מקום (פלייסהולדר) שתואם לייצוג הערך (VR) של התג.
- כל ערך אחר שתואם לאחד מסוגי המידע שמוגדרים כברירת מחדל ב-DICOM ב-Cloud Healthcare API, מוחלף בסוג המידע שלו. לדוגמה, אם התג
PatientCommentsהכיל את המחרוזת "Ann Johnson went to Anytown Hospital", אז "Anytown" יוחלף ב-infoTypeLOCATION.
הדוגמאות הבאות מציגות את הפלט של שימוש בפרופיל ברירת המחדל DEIDENTIFY_TAG_CONTENTS במערך נתונים שמכיל מאגרי DICOM ונתוני DICOM. אתם יכולים להשוות את פלט ברירת המחדל הזה לפלטים שמתקבלים כשמשתמשים בטרנספורמציות פרימיטיביות שונות עם שילובים של infoType. בדוגמאות נעשה שימוש במכונה אחת של DICOM, אבל אפשר להסיר את פרטי הזיהוי מכמה מכונות.
אחרי ששולחים את התמונה ל-Cloud Healthcare API באמצעות הפרופיל DEIDENTIFY_TAG_CONTENTS, התמונה נראית כך:
שימו לב לשינויים הבאים:
- השמות בפינה הימנית העליונה ובפינה השמאלית העליונה של התמונה השתנו באמצעות
CryptoHashConfig - התאריכים בפינה הימנית העליונה ובפינה השמאלית העליונה של התמונה שונו באמצעות
DateShiftConfig

REST
הסרת פרטי הזיהוי מקבוצת הנתונים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- SOURCE_DATASET_ID: מזהה מערך הנתונים שמכיל את הנתונים שרוצים להסיר מהם את פרטי הזיהוי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
תוכן בקשת JSON:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" } } }כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של 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- משתמשים ב-method
projects.locations.datasets.operations.getכדי לקבל את הסטטוס של הפעולה הממושכת.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- DATASET_ID: מזהה מערך הנתונים
- LOCATION: המיקום של מערך הנתונים
- OPERATION_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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
"done": true, הפעולה הממושכת הסתיימה. - אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה UID חדש של מחקרים, מזהה UID חדש של סדרות ומזהה UID חדש של מופעים, ולכן קודם צריך לחפש במערך הנתונים החדש את המופע שהוסרו ממנו פרטי הזיהוי.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- SOURCE_DATASET_LOCATION: המיקום של מערך הנתונים המקורי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו:
אחזור המטא-נתונים של המכונה באמצעות הערכים החדשים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
הפלט מכיל את המטא-נתונים החדשים. אתם יכולים להשוות בין המטא-נתונים החדשים לבין המטא-נתונים המקוריים כדי לראות את ההשפעה של הטרנספורמציה.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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
RedactConfig
ציון הערך redactConfig מצנזר ערך נתון על ידי הסרה מלאה שלו.
להודעה redactConfig אין ארגומנטים. אם מציינים אותה, אפשר לבצע טרנספורמציה.
הדוגמאות הבאות מרחיבות את הגדרת ברירת המחדל, אבל עכשיו הן כוללות הגדרה של infoType PERSON_NAME עם הטרנספורמציה redactConfig. שליחת הבקשה הזו מצנזרת את כל השמות מהמופע של DICOM.
אחרי ששולחים את התמונה ל-Cloud Healthcare API באמצעות הטרנספורמציה redactConfig, התמונה נראית כך:

REST
הסרת פרטי הזיהוי מקבוצת הנתונים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- SOURCE_DATASET_ID: מזהה מערך הנתונים שמכיל את הנתונים שרוצים להסיר מהם את פרטי הזיהוי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
תוכן בקשת JSON:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "text": { "transformations": [ { "infoTypes": [ "PERSON_NAME" ], "redactConfig": {} } ] } } }כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של 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- משתמשים ב-method
projects.locations.datasets.operations.getכדי לקבל את הסטטוס של הפעולה הממושכת.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- DATASET_ID: מזהה מערך הנתונים
- LOCATION: המיקום של מערך הנתונים
- OPERATION_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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
"done": true, הפעולה הממושכת הסתיימה. - אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה UID חדש של מחקרים, מזהה UID חדש של סדרות ומזהה UID חדש של מופעים, ולכן קודם צריך לחפש במערך הנתונים החדש את המופע שהוסרו ממנו פרטי הזיהוי.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- SOURCE_DATASET_LOCATION: המיקום של מערך הנתונים המקורי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו:
אחזור המטא-נתונים של המכונה באמצעות הערכים החדשים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
הפלט מכיל את המטא-נתונים החדשים. אתם יכולים להשוות בין המטא-נתונים החדשים לבין המטא-נתונים המקוריים כדי לראות את ההשפעה של הטרנספורמציה.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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
בפלט אפשר לראות שהערכים ב-ReferringPhysicianName (00080090) וב-PatientName (00100010) הוסרו. זאת בניגוד לדוגמה בהגדרת ברירת המחדל, שבה הערכים האלה עברו טרנספורמציה באמצעות גיבוב קריפטוגרפי.
CharacterMaskConfig
אם מציינים את הערך characterMaskConfig, מחרוזות שתואמות לסוגי המידע הנתונים מוחלפות בתו קבוע שצוין. לדוגמה, במקום לצנזר את שם המטופל או לשנות אותו באמצעות גיבוב קריפטוגרפי, אפשר להחליף את השם בסדרה של כוכביות (*). אפשר לציין את התו הקבוע כערך בשדה maskingCharacter.
הדוגמאות הבאות מרחיבות את הגדרת ברירת המחדל, אבל עכשיו הן כוללות הגדרה של infoType LAST_NAME עם הטרנספורמציה characterMaskConfig. לא צוין תו קבוע, ולכן ברירת המחדל היא שימוש בכוכביות.
בדוגמאות נעשה שימוש במכונה אחת של DICOM, אבל אפשר להסיר את פרטי הזיהוי מכמה מכונות.
אחרי ששולחים את התמונה ל-Cloud Healthcare API באמצעות הטרנספורמציה characterMaskConfig, התמונה נראית כך:

REST
הסרת פרטי הזיהוי מקבוצת הנתונים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- SOURCE_DATASET_ID: מזהה מערך הנתונים שמכיל את הנתונים שרוצים להסיר מהם את פרטי הזיהוי
- DESTINATION_DATASET_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": "" } } ] } } }כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של 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- משתמשים ב-method
projects.locations.datasets.operations.getכדי לקבל את הסטטוס של הפעולה הממושכת.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- DATASET_ID: מזהה מערך הנתונים
- LOCATION: המיקום של מערך הנתונים
- OPERATION_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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
"done": true, הפעולה הממושכת הסתיימה. - אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה UID חדש של מחקרים, מזהה UID חדש של סדרות ומזהה UID חדש של מופעים, ולכן קודם צריך לחפש במערך הנתונים החדש את המופע שהוסרו ממנו פרטי הזיהוי.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- SOURCE_DATASET_LOCATION: המיקום של מערך הנתונים המקורי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו:
אחזור המטא-נתונים של המכונה באמצעות הערכים החדשים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
הפלט מכיל את המטא-נתונים החדשים. אתם יכולים להשוות בין המטא-נתונים החדשים לבין המטא-נתונים המקוריים כדי לראות את ההשפעה של הטרנספורמציה.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
פותחים את דף העזר של ה-method. החלונית של 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.
כדי לפענח את המפתח שעטוף ב-Cloud KMS, צריך להקצות תפקיד עם ההרשאה cloudkms.cryptoKeyVersions.useToDecrypt לחשבון השירות של סוכן השירות של Cloud Healthcare. מומלץ להשתמש בתפקיד Cloud KMS CryptoKey Decrypter (roles/cloudkms.cryptoKeyDecrypter). כשמשתמשים ב-Cloud KMS לפעולות קריפטוגרפיות, חלים חיובים. למידע נוסף, ראו המחירון של Cloud Key Management Service.
Cloud Healthcare API משתמש במפתח הזה כדי לחשב את מספר הימים שבהם התאריכים, כמו תאריך הלידה של המטופל, מוזזים בטווח של 100 ימים.
אם לא תספקו מפתח, Cloud Healthcare API ייצור מפתח משלו בכל פעם שפעולת הסרת פרטי הזיהוי תפעל על ערכי תאריכים. זה עלול לגרום לפלט תאריכים לא עקבי בין הרצות.
בדוגמאות הבאות מוסבר איך להגדיר את סוגי המידע DATE ו-DATE_OF_BIRTH באמצעות הטרנספורמציה DateShiftConfig במופע DICOM. אחרי ששולחים את בקשת הסרת פרטי הזיהוי ל-Cloud Healthcare API, ערכי התאריכים במופע ישתנו בטווח של פלוס או מינוס 100 ימים מהערכים המקוריים שלהם.
מפתח ההצפנה שסופק, U2FsdGVkX19bS2oZsdbK9X5zi2utBn22uY+I2Vo0zOU=, הוא מפתח גולמי מוצפן ב-AES באורך 256 ביט בקידוד Base64, שנוצר באמצעות הפקודה הבאה. כשמוצגת בקשה, מספקים לפקודה סיסמה ריקה:
echo -n "test" | openssl enc -e -aes-256-ofb -a -salt
אחרי ששולחים את התמונה ל-Cloud Healthcare API באמצעות הטרנספורמציה dateShiftConfig, התמונה נראית כך:

REST
הסרת פרטי הזיהוי מקבוצת הנתונים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- SOURCE_DATASET_ID: מזהה מערך הנתונים שמכיל את הנתונים שרוצים להסיר מהם את פרטי הזיהוי
- DESTINATION_DATASET_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=" } } ] } } }כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של 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- משתמשים ב-method
projects.locations.datasets.operations.getכדי לקבל את הסטטוס של הפעולה הממושכת.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- DATASET_ID: מזהה מערך הנתונים
- LOCATION: המיקום של מערך הנתונים
- OPERATION_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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
"done": true, הפעולה הממושכת הסתיימה. - אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה UID חדש של מחקרים, מזהה UID חדש של סדרות ומזהה UID חדש של מופעים, ולכן קודם צריך לחפש במערך הנתונים החדש את המופע שהוסרו ממנו פרטי הזיהוי.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- SOURCE_DATASET_LOCATION: המיקום של מערך הנתונים המקורי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו:
אחזור המטא-נתונים של המכונה באמצעות הערכים החדשים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
הפלט מכיל את המטא-נתונים החדשים. אתם יכולים להשוות בין המטא-נתונים החדשים לבין המטא-נתונים המקוריים כדי לראות את ההשפעה של הטרנספורמציה.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
פותחים את דף העזר של ה-method. החלונית של 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.
כדי לפענח את המפתח שעטוף ב-Cloud KMS, צריך להקצות תפקיד עם ההרשאה cloudkms.cryptoKeyVersions.useToDecrypt לחשבון השירות של סוכן השירות של Cloud Healthcare. מומלץ להשתמש בתפקיד Cloud KMS CryptoKey Decrypter (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 על כל סוגי המידע שמוגדרים כברירת מחדל ב-DICOM ונתמכים ב-Cloud Healthcare API. אחרי ששולחים את הבקשה להסרת פרטי הזיהוי, הערכים עם infoType תואם של DICOM ב-Cloud Healthcare API מוחלפים בערכים חלופיים.
הדוגמה גם מראה איך לספק מפתח קריפטוגרפי כדי ליצור ערכים חלופיים עקביים בין הרצות של הסרת פרטי הזיהוי.
מפתח ההצפנה שסופק, U2FsdGVkX19bS2oZsdbK9X5zi2utBn22uY+I2Vo0zOU=, הוא מפתח גולמי מוצפן ב-AES באורך 256 ביט בקידוד Base64, שנוצר באמצעות הפקודה הבאה. כשמוצגת בקשה, מספקים לפקודה סיסמה ריקה:
echo -n "test" | openssl enc -e -aes-256-ofb -a -salt
אחרי ששולחים את התמונה ל-Cloud Healthcare API באמצעות הטרנספורמציה cryptoHashConfig, התמונה נראית כך:

REST
הסרת פרטי הזיהוי מקבוצת הנתונים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- SOURCE_DATASET_ID: מזהה מערך הנתונים שמכיל את הנתונים שרוצים להסיר מהם את פרטי הזיהוי
- DESTINATION_DATASET_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=" } } ] } } }כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של 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- משתמשים ב-method
projects.locations.datasets.operations.getכדי לקבל את הסטטוס של הפעולה הממושכת.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- DATASET_ID: מזהה מערך הנתונים
- LOCATION: המיקום של מערך הנתונים
- OPERATION_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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
"done": true, הפעולה הממושכת הסתיימה. - אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה UID חדש של מחקרים, מזהה UID חדש של סדרות ומזהה UID חדש של מופעים, ולכן קודם צריך לחפש במערך הנתונים החדש את המופע שהוסרו ממנו פרטי הזיהוי.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- SOURCE_DATASET_LOCATION: המיקום של מערך הנתונים המקורי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו:
אחזור המטא-נתונים של המכונה באמצעות הערכים החדשים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
הפלט מכיל את המטא-נתונים החדשים. אתם יכולים להשוות בין המטא-נתונים החדשים לבין המטא-נתונים המקוריים כדי לראות את ההשפעה של הטרנספורמציה.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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
הטרנספורמציות בפלט עקביות במופע הזה בין הרצות של הסרת פרטי הזיהוי, כל עוד מספקים את אותו cryptoKey.
ReplaceWithInfoTypeConfig
אם מציינים את הערך replaceWithInfoTypeConfig, ערכי הקלט מוחלפים בשם של ה-infoType של הערך.
בדוגמאות הבאות מוסבר איך להחיל טרנספורמציה של replaceWithInfoTypeConfig על כל סוגי המידע שמוגדרים כברירת מחדל ב-DICOM ונתמכים ב-Cloud Healthcare API.
להודעה replaceWithInfoTypeConfig אין ארגומנטים, והציון שלה מאפשר טרנספורמציה.
אחרי ששולחים את התמונה ל-Cloud Healthcare API באמצעות הטרנספורמציה replaceWithInfoTypeConfig, התמונה נראית כך:

REST
הסרת פרטי הזיהוי מקבוצת הנתונים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- SOURCE_DATASET_ID: מזהה מערך הנתונים שמכיל את הנתונים שרוצים להסיר מהם את פרטי הזיהוי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
תוכן בקשת JSON:
{ "destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "text": { "transformations": [ { "infoTypes": [], "replaceWithInfoTypeConfig": {} } ] } } }כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של 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- משתמשים ב-method
projects.locations.datasets.operations.getכדי לקבל את הסטטוס של הפעולה הממושכת.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- DATASET_ID: מזהה מערך הנתונים
- LOCATION: המיקום של מערך הנתונים
- OPERATION_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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
"done": true, הפעולה הממושכת הסתיימה. - אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה UID חדש של מחקרים, מזהה UID חדש של סדרות ומזהה UID חדש של מופעים, ולכן קודם צריך לחפש במערך הנתונים החדש את המופע שהוסרו ממנו פרטי הזיהוי.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- SOURCE_DATASET_LOCATION: המיקום של מערך הנתונים המקורי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו:
אחזור המטא-נתונים של המכונה באמצעות הערכים החדשים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד. המזהה הזה זהה למזהה של מאגר ה-DICOM במערך הנתונים המקורי.
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
הפלט מכיל את המטא-נתונים החדשים. אתם יכולים להשוות בין המטא-נתונים החדשים לבין המטא-נתונים המקוריים כדי לראות את ההשפעה של הטרנספורמציה.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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
הסרת פרטי זיהוי של נתונים ברמת מאגר ה-DICOM
הדוגמאות הקודמות מראות איך להסיר את פרטי הזיהוי מנתוני DICOM ברמת מערך הנתונים. בקטע הזה מוסבר איך להסיר את פרטי הזיהוי מהנתונים ברמת מאגר ה-DICOM.
כדי לשנות בקשה להסרת פרטים מזהים ממערך נתונים לבקשה להסרת פרטים מזהים מחנות DICOM, מבצעים את השינויים הבאים:
- משנים את
destinationDatasetבגוף הבקשה ל-destinationStore - מוסיפים את הערך
dicomStores/DESTINATION_DICOM_STORE_IDבסוף הערך בשדהdestinationStoreכשמציינים את היעד. - מוסיפים את
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 חדש. לפני שמריצים את הדוגמאות, מאגר ה-DICOM שאליו מפנה DESTINATION_DICOM_STORE_ID כבר צריך להיות קיים.
המסוף
כדי להסיר פרטים מזהים מנתונים במאגר DICOM באמצעות מסוף Google Cloud , מבצעים את השלבים הבאים:
נכנסים לדף Datasets במסוף Google Cloud .
לוחצים על קבוצת הנתונים שמכילה את הנתונים שרוצים להסיר מהם את פרטי הזיהוי.
ברשימת מאגרי ה-DICOM, בוחרים באפשרות De-identify מהרשימה Actions של מאגר ה-DICOM שרוצים להסיר ממנו את פרטי הזיהוי.
מופיע הדף De-identify DICOM store.
בוחרים באפשרות Set destination data store ובוחרים את קבוצת הנתונים ואת מאגר ה-DICOM שבהם יישמרו הנתונים שעברו הסרת פרטי זיהוי.
בוחרים באפשרות DICOM tag de-identification כדי להגדיר איך להסיר את פרטי הזיהוי מהנתונים. אפשר להסיר את פרטי הזיהוי מהנתונים בדרכים הבאות:
KEEP_ALL_PROFILE: שמירה של כל המטא תגים של DICOMDEIDENTIFY_TAG_CONTENTS: הסרת פרטי הזיהוי מנתונים במטא תגים-
ATTRIBUTE_CONFIDENTIALITY_BASIC_PROFILE: הסרת מטא תגים בהתאם לפרופיל הבסיסי בתקן DICOM -
MINIMAL_KEEP_LIST_PROFILE: שמירה רק של המטא-תגים שנדרשים לאובייקט DICOM תקין - דילוג על צנזור מזהים: יצירה מחדש של שדות UID כפי שנקבע בתקן DICOM
בוחרים באפשרות DICOM burnt-in text redaction כדי להגדיר איך תתבצע צנזורת התמונות במהלך הסרת פרטי הזיהוי. כך מגדירים צנזור תמונות:
-
REDACT_NO_TEXT: לא לצנזר טקסט בתמונות -
REDACT_SENSITIVE_TEXT: צנזור של טקסט רגיש בלבד בתמונות. כדי לצנזר גם טקסט שתואם לביטויים רגולריים בהתאמה אישית:- לוחצים על שימוש בהגדרה מותאמת אישית.
- בוחרים באפשרות שימוש בביטוי רגולרי מותאם אישית.
- בשדה ביטוי רגולרי בהתאמה אישית, מזינים את תבנית הביטוי הרגולרי להתאמה.
- אופציונלי: בשדה Group Index, מזינים עד שלושה אינדקסים של קבוצות לחילוץ שמופרדים בפסיקים כדי לצנזר, לדוגמה
1,2. כדי לצנזר את כל ההתאמה, משאירים את השדה ריק או מזינים0. - אופציונלי: לוחצים על הוספת ביטוי רגולרי מותאם אישית כדי להגדיר ביטויים רגולריים מותאמים אישית נוספים.
-
REDACT_ALL_TEXT: צנזור כל הטקסט בתמונות
-
לוחצים על De-identify כדי להסיר פרטי זיהוי מהנתונים במאגר ה-DICOM.
REST
הסרת פרטי הזיהוי מקבוצת הנתונים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- SOURCE_DATASET_ID: מזהה מערך הנתונים שמכיל את הנתונים שרוצים להסיר מהם את פרטי הזיהוי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- SOURCE_DICOM_STORE_ID: המזהה של מאגר ה-DICOM שמכיל את הנתונים שרוצים להסיר מהם את פרטי הזיהוי
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד
תוכן בקשת 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" } } }כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של 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- משתמשים ב-method
projects.locations.datasets.operations.getכדי לקבל את הסטטוס של הפעולה הממושכת.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- DATASET_ID: מזהה מערך הנתונים
- LOCATION: המיקום של מערך הנתונים
- OPERATION_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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
"done": true, הפעולה הממושכת הסתיימה.
ביטול הזיהוי של קבוצת משנה של מאגר DICOM
כדי להסיר את פרטי הזיהוי מקבוצת משנה של נתונים במאגר DICOM, צריך לציין מסנן.
המסנן הוא קובץ מסנן שאתם מציינים כערך בשדה resourcePathsGcsUri באובייקט DicomFilterConfig. קובץ המסנן חייב להיות בקטגוריה של Cloud Storage. אי אפשר לציין קובץ מסנן שנמצא במכונה המקומית או בכל מקור אחר. מיקום הקובץ צריך להיות בפורמט 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 כדי לראות את מזהי ה-UID של המחקר, הסדרה והמופע של נתוני ה-DICOM במאגר ה-DICOM. לאחר מכן תוכלו לבצע את הפעולות הבאות:
שולחים שאילתה לגבי מזהי ה-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.
כשתציינו את המסנן בפעולת הסרת פרטי הזיהוי, תשתמשו במיקום של קובץ המסנן ב-Cloud Storage. בדוגמה הבאה מוסבר איך להעלות קובץ מסנן לקטגוריה של Cloud Storage באמצעות הפקודה gcloud storage cp:
gcloud storage cp PATH/TO/FILTER_FILE gs://BUCKET/DIRECTORY
לדוגמה:
gcloud storage cp /home/user/Desktop/filters.txt gs://my-bucket/my-directory
שימוש במסנן
אחרי שמגדירים את קובץ המסנן, אפשר להעביר אותו כערך לשדה resourcePathsGcsUri באובייקט filterConfig.
הדוגמה הבאה מרחיבה את הסרת פרטי הזיהוי של נתונים ברמת מאגר ה-DICOM, אבל מסופק קובץ סינון ב-Cloud Storage שקובע אילו משאבי DICOM יוסרו מהם פרטי הזיהוי.
REST
הסרת פרטי הזיהוי מקבוצת הנתונים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- SOURCE_DATASET_ID: מזהה מערך הנתונים שמכיל את הנתונים שרוצים להסיר מהם את פרטי הזיהוי
- DESTINATION_DATASET_ID: המזהה של מערך הנתונים של היעד שאליו נכתבים הנתונים ללא פרטים מזהים
- SOURCE_DICOM_STORE_ID: המזהה של מאגר ה-DICOM שמכיל את הנתונים שרוצים להסיר מהם את פרטי הזיהוי
- DESTINATION_DICOM_STORE_ID: המזהה של מאגר ה-DICOM במערך הנתונים של היעד
- BUCKET/PATH/TO/FILE: המיקום של קובץ המסנן בקטגוריה של Cloud Storage
תוכן בקשת 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" } }כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של 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- משתמשים ב-method
projects.locations.datasets.operations.getכדי לקבל את הסטטוס של הפעולה הממושכת.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- DATASET_ID: מזהה מערך הנתונים
- LOCATION: המיקום של מערך הנתונים
- OPERATION_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
פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
"done": true, הפעולה הממושכת הסתיימה.
פתרון בעיות בפעולות של הסרת פרטי הזיהוי ב-DICOM
אם מתרחשות שגיאות במהלך פעולת הסרת פרטי הזיהוי של DICOM, השגיאות נרשמות ב-Cloud Logging. מידע נוסף זמין במאמר צפייה ביומני שגיאות ב-Cloud Logging.
אם כל הפעולה מחזירה שגיאה, עיינו במאמר פתרון בעיות בפעולות ארוכות.