הסרת פרטי הזיהוי מנתוני DICOM באמצעות DicomConfig

בדף הזה מוסבר איך משתמשים בהגדרות של גרסה 1 של DicomConfig כדי להסיר פרטים מזהים מנתונים רגישים במכונות DICOM ברמות הבאות:

בדף הזה מוסבר גם איך להחיל מסננים כשמסירים פרטים מזהים מנתונים ברמת מאגר ה-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 בשיטות שונות. בכל דוגמה מוצג פלט של התמונה לאחר הסרת פרטי הזיהוי. בכל דוגמה, התמונה המקורית הבאה משמשת כקלט:

xray_original

כדי לראות את ההשפעות של כל פעולה להסרת פרטים מזהים, אפשר להשוות את תמונת הפלט של הפעולה לתמונה המקורית הזו.

הסרת פרטי הזיהוי מתגי 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, התגים הבאים מתווספים כברירת מחדל:

  • StudyInstanceUID
  • SeriesInstanceUID
  • SOPInstanceUID
  • TransferSyntaxUID
  • MediaStorageSOPInstanceUID
  • MediaStorageSOPClassUID
  • PixelData
  • Rows
  • Columns
  • SamplesPerPixel
  • BitsAllocated
  • BitsStored
  • Highbit
  • PhotometricInterpretation
  • PixelRepresentation
  • NumberOfFrames
  • PlanarConfiguration
  • PixelAspectRatio
  • SmallestImagePixelValue
  • LargestImagePixelValue
  • RedPaletteColorLookupTableDescriptor
  • GreenPaletteColorLookupTableDescriptor
  • BluePaletteColorLookupTableDescriptor
  • RedPaletteColorLookupTableData
  • GreenPaletteColorLookupTableData
  • BluePaletteColorLookupTableData
  • ICCProfile
  • ColorSpace
  • WindowCenter
  • WindowWidth
  • VOILUTFunction

הפעולה deidentify לא מצנזרת את התגים הקודמים. עם זאת, הערכים של חלק מהתגים נוצרים מחדש, כלומר הערכים מוחלפים בערך אחר באמצעות טרנספורמציה דטרמיניסטית. מידע נוסף זמין בקטע Retain UIDs Option בתקן DICOM. כדי לשמור על הערכים המקוריים של התגים הקודמים, משתמשים באפשרות SkipIdRedaction.

אם לא מספקים תגי רשימת היתרים, לא מצנזרים אף תג DICOM במערך הנתונים.

הדוגמאות הבאות ממחישות איך להסיר את פרטי הזיהוי מקבוצת נתונים שמכילה מאגרי DICOM ונתוני DICOM, תוך השארת חלק מהתגים ללא שינוי.

אחרי ששולחים את התמונה ל-Cloud Healthcare API, היא נראית כך: המטא-נתונים שמוצגים בפינות העליונות של התמונה צונזרו, אבל המידע הרפואי המוגן (PHI) שמוטמע בתחתית התמונה נשאר. כדי להסיר גם את הטקסט המוטמע, קראו את המאמר צנזור טקסט מוטמע בתמונות.

dicom_keeplist

REST

  1. הסרת פרטי הזיהוי מקבוצת הנתונים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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"
            ]
          }
        }
      }
    }
    

    כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

    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
    הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של OPERATION_ID. תצטרכו את הערך הזה בשלב הבא.

  2. כדי לקבל את הסטטוס של הפעולה הממושכת, משתמשים ב-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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט שיתקבל: כשהתשובה מכילה את הערך "done": true, הפעולה הממושכת הסתיימה.
  3. אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה 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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    אתם אמורים לקבל תגובת JSON שדומה לזו:

    בטבלה הבאה מוצגים השינויים במזהה הייחודי של המחקרים, במזהה הייחודי של הסדרות ובמזהה הייחודי של המופעים:
      מטא-נתונים של המכונה המקורית מטא-נתונים של מופע ללא פרטים מזהים
    מזהה ייחודי של מחקרים (0020000D) 2.25.70541616638819138568043293671559322355 1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763
    מזהה ייחודי של הסדרה (0020000E) 1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694 1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710
    מזהה ייחודי (UID) של המופעים (00080018) 1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695 1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029
  4. אחזור המטא-נתונים של המכונה באמצעות הערכים החדשים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט מכיל את המטא-נתונים החדשים. אתם יכולים להשוות בין המטא-נתונים החדשים לבין המטא-נתונים המקוריים כדי לראות את ההשפעה של הטרנספורמציה.

Go

import (
	"context"
	"fmt"
	"io"
	"time"

	healthcare "google.golang.org/api/healthcare/v1"
)

// deidentifyDataset creates a new dataset containing de-identified data from the source dataset.
func deidentifyDataset(w io.Writer, projectID, location, sourceDatasetID, destinationDatasetID string) error {
	ctx := context.Background()

	healthcareService, err := healthcare.NewService(ctx)
	if err != nil {
		return fmt.Errorf("healthcare.NewService: %w", err)
	}

	datasetsService := healthcareService.Projects.Locations.Datasets

	parent := fmt.Sprintf("projects/%s/locations/%s", projectID, location)

	req := &healthcare.DeidentifyDatasetRequest{
		DestinationDataset: fmt.Sprintf("%s/datasets/%s", parent, destinationDatasetID),
		Config: &healthcare.DeidentifyConfig{
			Dicom: &healthcare.DicomConfig{
				KeepList: &healthcare.TagFilterList{
					Tags: []string{
						"PatientID",
					},
				},
			},
		},
	}

	sourceName := fmt.Sprintf("%s/datasets/%s", parent, sourceDatasetID)
	resp, err := datasetsService.Deidentify(sourceName, req).Do()
	if err != nil {
		return fmt.Errorf("Deidentify: %w", err)
	}

	// Wait for the deidentification operation to finish.
	operationService := healthcareService.Projects.Locations.Datasets.Operations
	for {
		op, err := operationService.Get(resp.Name).Do()
		if err != nil {
			return fmt.Errorf("operationService.Get: %w", err)
		}
		if !op.Done {
			time.Sleep(1 * time.Second)
			continue
		}
		if op.Error != nil {
			return fmt.Errorf("deidentify operation error: %v", *op.Error)
		}
		fmt.Fprintf(w, "Created de-identified dataset %s from %s\n", resp.Name, sourceName)
		return nil
	}
}

Java

import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.JsonFactory;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.healthcare.v1.CloudHealthcare;
import com.google.api.services.healthcare.v1.CloudHealthcare.Projects.Locations.Datasets;
import com.google.api.services.healthcare.v1.CloudHealthcareScopes;
import com.google.api.services.healthcare.v1.model.DeidentifyConfig;
import com.google.api.services.healthcare.v1.model.DeidentifyDatasetRequest;
import com.google.api.services.healthcare.v1.model.DicomConfig;
import com.google.api.services.healthcare.v1.model.Operation;
import com.google.api.services.healthcare.v1.model.TagFilterList;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.IOException;
import java.util.Arrays;
import java.util.Collections;

public class DatasetDeIdentify {
  private static final String DATASET_NAME = "projects/%s/locations/%s/datasets/%s";
  private static final JsonFactory JSON_FACTORY = new GsonFactory();
  private static final NetHttpTransport HTTP_TRANSPORT = new NetHttpTransport();

  public static void datasetDeIdentify(String srcDatasetName, String destDatasetName)
      throws IOException {
    // String srcDatasetName =
    //     String.format(DATASET_NAME, "your-project-id", "your-region-id", "your-src-dataset-id");
    // String destDatasetName =
    //    String.format(DATASET_NAME, "your-project-id", "your-region-id", "your-dest-dataset-id");

    // Initialize the client, which will be used to interact with the service.
    CloudHealthcare client = createClient();

    // Configure what information needs to be De-Identified.
    // For more information on de-identifying using tags, please see the following:
    // https://cloud.google.com/healthcare/docs/how-tos/dicom-deidentify#de-identification_using_tags
    TagFilterList tags = new TagFilterList().setTags(Arrays.asList("PatientID"));
    DicomConfig dicomConfig = new DicomConfig().setKeepList(tags);
    DeidentifyConfig config = new DeidentifyConfig().setDicom(dicomConfig);

    // Create the de-identify request and configure any parameters.
    DeidentifyDatasetRequest deidentifyRequest =
        new DeidentifyDatasetRequest().setDestinationDataset(destDatasetName).setConfig(config);
    Datasets.Deidentify request =
        client.projects().locations().datasets().deidentify(srcDatasetName, deidentifyRequest);

    // Execute the request, wait for the operation to complete, and process the results.
    try {
      Operation operation = request.execute();
      while (operation.getDone() == null || !operation.getDone()) {
        // Update the status of the operation with another request.
        Thread.sleep(500); // Pause for 500ms between requests.
        operation =
            client
                .projects()
                .locations()
                .datasets()
                .operations()
                .get(operation.getName())
                .execute();
      }
      System.out.println(
          "De-identified Dataset created. Response content: " + operation.getResponse());
    } catch (Exception ex) {
      System.out.printf("Error during request execution: %s", ex.toString());
      ex.printStackTrace(System.out);
    }
  }

  private static CloudHealthcare createClient() throws IOException {
    // Use Application Default Credentials (ADC) to authenticate the requests
    // For more information see https://cloud.google.com/docs/authentication/production
    GoogleCredentials credential =
        GoogleCredentials.getApplicationDefault()
            .createScoped(Collections.singleton(CloudHealthcareScopes.CLOUD_PLATFORM));

    // Create a HttpRequestInitializer, which will provide a baseline configuration to all requests.
    HttpRequestInitializer requestInitializer =
        request -> {
          new HttpCredentialsAdapter(credential).initialize(request);
          request.setConnectTimeout(60000); // 1 minute connect timeout
          request.setReadTimeout(60000); // 1 minute read timeout
        };

    // Build the client for interacting with the service.
    return new CloudHealthcare.Builder(HTTP_TRANSPORT, JSON_FACTORY, requestInitializer)
        .setApplicationName("your-application-name")
        .build();
  }
}

Node.js

const google = require('@googleapis/healthcare');
const healthcare = google.healthcare({
  version: 'v1',
  auth: new google.auth.GoogleAuth({
    scopes: ['https://www.googleapis.com/auth/cloud-platform'],
  }),
});

const deidentifyDataset = async () => {
  // TODO(developer): uncomment these lines before running the sample
  // const cloudRegion = 'us-central1';
  // const projectId = 'adjective-noun-123';
  // const sourceDatasetId = 'my-source-dataset';
  // const destinationDatasetId = 'my-destination-dataset';
  // const keeplistTags = 'PatientID'
  const sourceDataset = `projects/${projectId}/locations/${cloudRegion}/datasets/${sourceDatasetId}`;
  const destinationDataset = `projects/${projectId}/locations/${cloudRegion}/datasets/${destinationDatasetId}`;
  const request = {
    sourceDataset: sourceDataset,
    destinationDataset: destinationDataset,
    resource: {
      config: {
        dicom: {
          keepList: {
            tags: [keeplistTags],
          },
        },
      },
    },
  };

  await healthcare.projects.locations.datasets.deidentify(request);
  console.log(
    `De-identified data written from dataset ${sourceDatasetId} to dataset ${destinationDatasetId}`
  );
};

deidentifyDataset();

Python

# Imports the Dict type for runtime type hints.
from typing import Dict


def deidentify_dataset(
    project_id: str,
    location: str,
    dataset_id: str,
    destination_dataset_id: str,
) -> Dict[str, str]:
    """Uses a DICOM tag keeplist to create a new dataset containing de-identified DICOM data from the source dataset.

    See
    https://github.com/GoogleCloudPlatform/python-docs-samples/tree/main/healthcare/api-client/v1/datasets
    before running the sample.
    See https://googleapis.github.io/google-api-python-client/docs/dyn/healthcare_v1.projects.locations.datasets.html#deidentify
    for the Python API reference.

    Args:
      project_id: The project ID or project number of the Google Cloud project you want
          to use.
      location: The name of the dataset's location.
      dataset_id: The ID of the source dataset containing the DICOM store to de-identify.
      destination_dataset_id: The ID of the dataset where de-identified DICOM data
        is written.

    Returns:
      A dictionary representing a long-running operation that results from
      calling the 'DeidentifyDataset' method. Use the
      'google.longrunning.Operation'
      API to poll the operation status.
    """
    # Imports the Python built-in time module.
    import time

    # Imports the Google API Discovery Service.
    from googleapiclient import discovery

    # Imports HttpError from the Google Python API client errors module.
    from googleapiclient.errors import HttpError

    api_version = "v1"
    service_name = "healthcare"
    # Returns an authorized API client by discovering the Healthcare API
    # and using GOOGLE_APPLICATION_CREDENTIALS environment variable.
    client = discovery.build(service_name, api_version)

    # TODO(developer): Uncomment these lines and replace with your values.
    # project_id = 'my-project'
    # location = 'us-central1'
    # dataset_id = 'my-source-dataset'
    # destination_dataset_id = 'my-destination-dataset'
    source_dataset = "projects/{}/locations/{}/datasets/{}".format(
        project_id, location, dataset_id
    )
    destination_dataset = "projects/{}/locations/{}/datasets/{}".format(
        project_id, location, destination_dataset_id
    )

    body = {
        "destinationDataset": destination_dataset,
        "config": {
            "dicom": {
                "keepList": {
                    "tags": [
                        "Columns",
                        "NumberOfFrames",
                        "PixelRepresentation",
                        "MediaStorageSOPClassUID",
                        "MediaStorageSOPInstanceUID",
                        "Rows",
                        "SamplesPerPixel",
                        "BitsAllocated",
                        "HighBit",
                        "PhotometricInterpretation",
                        "BitsStored",
                        "PatientID",
                        "TransferSyntaxUID",
                        "SOPInstanceUID",
                        "StudyInstanceUID",
                        "SeriesInstanceUID",
                        "PixelData",
                    ]
                }
            }
        },
    }

    request = (
        client.projects()
        .locations()
        .datasets()
        .deidentify(sourceDataset=source_dataset, body=body)
    )

    # Set a start time for operation completion.
    start_time = time.time()
    # TODO(developer): Increase the max_time if de-identifying many resources.
    max_time = 600

    try:
        operation = request.execute()
        while not operation.get("done", False):
            # Poll until the operation finishes.
            print("Waiting for operation to finish...")
            if time.time() - start_time > max_time:
                raise RuntimeError("Timed out waiting for operation to finish.")
            operation = (
                client.projects()
                .locations()
                .datasets()
                .operations()
                .get(name=operation["name"])
                .execute()
            )
            # Wait 5 seconds between each poll to the operation.
            time.sleep(5)

        if operation.get("error"):
            raise TimeoutError(f"De-identify operation failed: {operation['error']}")
        else:
            print(f"De-identified data to dataset: {destination_dataset_id}")
            print(
                f"Resources succeeded: {operation.get('metadata').get('counter').get('success')}"
            )
            print(
                f"Resources failed: {operation.get('metadata').get('counter').get('failure')}"
            )
            return operation

    except HttpError as err:
        # A common error is when the destination dataset already exists.
        if err.resp.status == 409:
            raise RuntimeError(
                f"Destination dataset with ID {destination_dataset_id} already exists."
            )
        else:
            raise err

הסרת פרטי הזיהוי באמצעות תגי רשימת הסרה

אפשר לציין רשימת הסרה באובייקט DicomConfig. הפעולה deidentify תצנזר רק את התגים שצוינו ברשימה. אם לא מספקים תגי removelist, פעולת הסרת פרטי הזיהוי ממשיכה כרגיל, אבל לא מתבצעת צנזורה של תגי DICOM במערך הנתונים של היעד.

כשמציינים רשימת הסרה, התג OverlayData מתווסף כברירת מחדל כי נתוני השכבה עשויים להכיל מידע בריאותי אישי (PHI).

אי אפשר להוסיף לרשימת ההסרה תגים שמתווספים כברירת מחדל לרשימת ההכללה.

בדוגמאות הבאות מוסבר איך להסיר את פרטי הזיהוי מקבוצת נתונים שמכילה מאגרי DICOM ונתוני DICOM, על ידי הסרת כל התגים שברשימת ההסרה. תגים שלא נמצאים ברשימת ההסרה לא משתנים.

אחרי ששולחים את התמונה ל-Cloud Healthcare API, היא נראית כך: מבין התגים שסופקו ברשימת ההסרה, רק PatientBirthDate הוסר מהתמונה, כי זה התג היחיד מרשימת ההסרה שתואם למטא-נתונים שגלויים בתמונה.

ה-PatientBirthDate בפינה העליונה של התמונה צונזר בהתאם להגדרות ברשימת ההסרה, אבל ה-PHI שמוטמע בתחתית התמונה נשאר. כדי להסיר גם את הטקסט המוטמע, קראו את המאמר צנזור טקסט מוטמע בתמונות.

dicom_removelist

REST

  1. הסרת פרטי הזיהוי מקבוצת הנתונים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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"
            ]
          }
        }
      }
    }
    

    כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

    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
    הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של OPERATION_ID. תצטרכו את הערך הזה בשלב הבא.

  2. משתמשים ב-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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט שיתקבל: כשהתשובה מכילה את הערך "done": true, הפעולה הממושכת הסתיימה.
  3. אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה 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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    אתם אמורים לקבל תגובת JSON שדומה לזו:

    בטבלה הבאה מוצגים השינויים במזהה הייחודי של המחקרים, במזהה הייחודי של הסדרות ובמזהה הייחודי של המופעים:
      המטא-נתונים של המכונה המקורית מטא-נתונים של מופע ללא פרטים מזהים
    מזהה ייחודי של מחקרים (0020000D) 2.25.70541616638819138568043293671559322355 1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763
    מזהה ייחודי של הסדרה (0020000E) 1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694 1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710
    מזהה ייחודי (UID) של המופעים (00080018) 1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695 1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029
  4. אחזור המטא-נתונים של המכונה באמצעות הערכים החדשים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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 Content

    APIs 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, התמונה נראית ככה: למרות שהמטא-נתונים שמוצגים בפינות העליונות של התמונה צונזרו, המידע הרפואי המוגן שמוטמע בתחתית התמונה נשאר. כדי להסיר גם את הטקסט המוטמע, קראו את המאמר צנזור טקסט מוטמע בתמונות.

dicom_attribute_confidentiality_basic_profile

REST

  1. הסרת פרטי הזיהוי מקבוצת הנתונים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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"
        }
      }
    }
    

    כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

    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
    הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של OPERATION_ID. תצטרכו את הערך הזה בשלב הבא.

  2. כדי לקבל את הסטטוס של הפעולה הממושכת, משתמשים ב-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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט שיתקבל: כשהתשובה מכילה את הערך "done": true, הפעולה הממושכת הסתיימה.
  3. אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה 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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    אתם אמורים לקבל תגובת JSON שדומה לזו:

    בטבלה הבאה מוצגים השינויים במזהה הייחודי של המחקרים, במזהה הייחודי של הסדרות ובמזהה הייחודי של המופעים:
      מטא-נתונים של המכונה המקורית מטא-נתונים של מופע ללא פרטים מזהים
    מזהה ייחודי של מחקרים (0020000D) 2.25.70541616638819138568043293671559322355 1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763
    מזהה ייחודי של הסדרה (0020000E) 1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694 1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710
    מזהה ייחודי (UID) של המופעים (00080018) 1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695 1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029
  4. אחזור המטא-נתונים של המכונה באמצעות הערכים החדשים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט מכיל את המטא-נתונים החדשים. אתם יכולים להשוות בין המטא-נתונים החדשים לבין המטא-נתונים המקוריים כדי לראות את ההשפעה של הטרנספורמציה.

הסרת פרטי הזיהוי של נתונים במסוף Google Cloud

כדי להסיר פרטים מזהים מהנתונים במסוף Google Cloud :

  1. נכנסים לדף Datasets במסוף Google Cloud .

    כניסה לדף Datasets

  2. ברשימה Actions של מערך הנתונים שרוצים להסיר ממנו את פרטי הזיהוי, בוחרים באפשרות De-identify.

    מופיע הדף De-identify Dataset.

  3. בוחרים באפשרות Set destination dataset ומזינים שם למערך הנתונים החדש שבו יישמרו הנתונים ללא פרטים מזהים.

  4. בוחרים באפשרות DICOM tag de-identification כדי לבחור את הפרופיל שבו יוסרו פרטי הזיהוי מהנתונים. אפשר להסיר את פרטי הזיהוי מהנתונים בדרכים הבאות:

  5. בוחרים באפשרות DICOM burnt-in text redaction כדי להגדיר איך תתבצע צנזורת התמונות במהלך הסרת פרטי הזיהוי. כך מגדירים צנזור תמונות:

    • REDACT_NO_TEXT – אל תצנזרו טקסט בתמונות
    • ‫REDACT_SENSITIVE_TEXT – צנזור של טקסט רגיש בלבד בתמונות. כדי לצנזר גם טקסט שתואם לביטויים רגולריים בהתאמה אישית:
      1. לוחצים על שימוש בהגדרה מותאמת אישית.
      2. בוחרים באפשרות שימוש בביטוי רגולרי מותאם אישית.
      3. בשדה ביטוי רגולרי בהתאמה אישית, מזינים את תבנית הביטוי הרגולרי להתאמה.
      4. אופציונלי: בשדה Group Index, מזינים עד שלושה אינדקסים של קבוצות לחילוץ שמופרדים בפסיקים כדי לצנזר, לדוגמה 1,2. כדי לצנזר את כל ההתאמה, משאירים את השדה ריק או מזינים 0.
      5. אופציונלי: לוחצים על הוספת ביטוי רגולרי מותאם אישית כדי להגדיר ביטויים רגולריים מותאמים אישית נוספים.
    • REDACT_ALL_TEXT – צנזור כל הטקסט בתמונות
  6. לוחצים על De-identify כדי להסיר את פרטי הזיהוי מהנתונים במערך הנתונים.

צנזור טקסט שמוטמע בתמונות

באמצעות Cloud Healthcare API אפשר לצנזר טקסט רגיש שמוטמע בתמונות. ה-API מזהה מידע רגיש כמו PHI, ומסתיר אותו באמצעות מלבן אטום. ה-API מחזיר את אותן תמונות DICOM שנתתם לו, באותו פורמט, אבל כל טקסט שזוהה כמכיל מידע רגיש לפי הקריטריונים שלכם מצונזר.

כדי לצנזר טקסט שמוטמע בתמונות, מציינים אפשרות של TextRedactionMode בתוך אובייקט ImageConfig. אפשר לעיין במסמכי התיעוד של TextRedactionMode כדי לראות את הערכים האפשריים.

צנזור כל הטקסט שמוטמע בתמונה

בדוגמאות הבאות מוסבר איך לצנזר את כל הטקסט המוטמע בתמונות DICOM במערך נתונים. כדי לעשות את זה, מציינים את הערך REDACT_ALL_TEXT בשדה TextRedactionMode.

אחרי ששולחים את התמונה ל-Cloud Healthcare API באמצעות האפשרות REDACT_ALL_TEXT, התמונה נראית כך: הטקסט הצרוב בתחתית התמונה הוסר, אבל המטא-נתונים בפינות העליונות של התמונה נשארו. כדי להסיר גם את המטא-נתונים, ראו הסרת פרטי הזיהוי של תגי DICOM.

xray_redact_all_text

REST

  1. הסרת פרטי הזיהוי מקבוצת הנתונים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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"
        }
      }
    }
    

    כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

    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
    הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של OPERATION_ID. תצטרכו את הערך הזה בשלב הבא.

  2. משתמשים ב-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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט שיתקבל: כשהתשובה מכילה את הערך "done": true, הפעולה הממושכת הסתיימה.
  3. אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה 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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    אתם אמורים לקבל תגובת JSON שדומה לזו:

    בטבלה הבאה מוצגים השינויים במזהה הייחודי של המחקרים, במזהה הייחודי של הסדרות ובמזהה הייחודי של המופעים:
      מטא-נתונים של המכונה המקורית מטא-נתונים של מופע ללא פרטים מזהים
    מזהה ייחודי של מחקרים (0020000D) 2.25.70541616638819138568043293671559322355 1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763
    מזהה ייחודי של הסדרה (0020000E) 1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694 1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710
    מזהה ייחודי (UID) של המופעים (00080018) 1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695 1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029

צנזור של טקסט רגיש שמוטמע בתמונה

בדוגמאות הבאות מוסבר איך לצנזר טקסט רגיש שמוטמע בתמונות DICOM במערך נתונים. כדי לעשות את זה, מציינים את הערך REDACT_SENSITIVE_TEXT בשדה TextRedactionMode.

סוגי המידע שצוינו בסוגי המידע שמוגדרים כברירת מחדל ב-DICOM מצונזרים כשמציינים את REDACT_SENSITIVE_TEXT. שני סוגי מידע מותאמים אישית נוספים מוחלים גם על צנזור של:

  • מזהי מטופלים, כמו מספרי תיקים רפואיים (MRN)
  • מספרי קטלוג

בתמונה הבאה מוצג צילום רנטגן של מטופל, ללא צנזור:

xray2_unredacted

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

xray2_redact_sensitive_text

אפשר לראות שקרה הדבר הבא:

  • ה-PERSON_NAME בפינה הימנית התחתונה של התמונה צונזר
  • ה-DATE בפינה הימנית התחתונה של התמונה צונזר

המין של המטופל לא צונזר כי הוא לא נחשב לטקסט רגיש לפי סוגי המידע שמוגדרים כברירת מחדל ב-DICOM.

REST

  1. הסרת פרטי הזיהוי מקבוצת הנתונים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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"
        }
      }
    }
    

    כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

    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
    הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של OPERATION_ID. תצטרכו את הערך הזה בשלב הבא.

  2. משתמשים ב-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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט שיתקבל: כשהתשובה מכילה את הערך "done": true, הפעולה הממושכת הסתיימה.
  3. אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה 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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    אתם אמורים לקבל תגובת JSON שדומה לזו:

    בטבלה הבאה מוצגים השינויים במזהה הייחודי של המחקרים, במזהה הייחודי של הסדרות ובמזהה הייחודי של המופעים:
      מטא-נתונים של המכונה המקורית מטא-נתונים של מופע ללא פרטים מזהים
    מזהה ייחודי של מחקרים (0020000D) 2.25.70541616638819138568043293671559322355 1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763
    מזהה ייחודי של הסדרה (0020000E) 1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694 1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710
    מזהה ייחודי (UID) של המופעים (00080018) 1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695 1.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

  1. הסרת פרטי הזיהוי של מערך הנתונים או של מאגר ה-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]
            }
          ]
        }
      }
    }
    

    כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

    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
    הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של OPERATION_ID. תצטרכו את הערך הזה בשלב הבא.

    כדי להסיר פרטים מזהים ממאגר 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]
            }
          ]
        }
      }
    }
    

    כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

    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
    הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של OPERATION_ID. תצטרכו את הערך הזה בשלב הבא.

  2. משתמשים ב-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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט שיתקבל: כשהתשובה מכילה את הערך "done": true, הפעולה הממושכת הסתיימה.
  3. אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה 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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    אתם אמורים לקבל תגובת JSON שדומה לזו:

    בטבלה הבאה מוצגים השינויים במזהה הייחודי של המחקרים, במזהה הייחודי של הסדרות ובמזהה הייחודי של המופעים:
      מטא-נתונים של המכונה המקורית מטא-נתונים של מופע ללא פרטים מזהים
    מזהה ייחודי של מחקרים (0020000D) 2.25.70541616638819138568043293671559322355 1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763
    מזהה ייחודי של הסדרה (0020000E) 1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694 1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710
    מזהה ייחודי (UID) של המופעים (00080018) 1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695 1.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
  • הטקסט המוטמע בתחתית התמונה מצונזר

xray_redact_all_text_deidentify_tag_contents

REST

  1. הסרת פרטי הזיהוי מקבוצת הנתונים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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"
        }
      }
    }
    

    כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

    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
    הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של OPERATION_ID. תצטרכו את הערך הזה בשלב הבא.

  2. משתמשים ב-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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט שיתקבל: כשהתשובה מכילה את הערך "done": true, הפעולה הממושכת הסתיימה.
  3. אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה 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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    אתם אמורים לקבל תגובת JSON שדומה לזו:

  4. אחזור המטא-נתונים של המכונה באמצעות הערכים החדשים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט מכיל את המטא-נתונים החדשים. אתם יכולים להשוות בין המטא-נתונים החדשים לבין המטא-נתונים המקוריים כדי לראות את ההשפעה של הטרנספורמציה.

שימוש בטיפוסי מידע ובטרנספורמציות פרימיטיביות עם תגי DICOM

ב-Cloud Healthcare API אפשר להשתמש בסוגי מידע (infoTypes) כדי להגדיר אילו נתונים ייסרקו כשמתבצעת הסרת פרטי זיהוי בתגים. ‫infoType הוא סוג של מידע רגיש, כמו שם של מטופל, כתובת אימייל, מספר טלפון, מספר זיהוי או מספר כרטיס אשראי.

טרנספורמציות פרימיטיביות הן כללים שמשמשים לטרנספורמציה של ערך קלט. כדי להתאים אישית את הסרת פרטי הזיהוי של תגי DICOM, אפשר להחיל טרנספורמציה פרימיטיבית על ה-infoType של כל תג. לדוגמה, אפשר להסיר את פרטי הזיהוי של שם המשפחה של מטופל ולהחליף אותו בסדרה של כוכביות, על ידי ציון infoType של LAST_NAME עם הטרנספורמציה הפרימיטיבית CharacterMaskConfig.

סוגי מידע (infoTypes) שמוגדרים כברירת מחדל ב-DICOM

סוגי המידע הרגיש שמוגדרים כברירת מחדל ב-DICOM ומשמשים להסרת פרטים מזהים ממטא-נתונים הם:

  • AGE
  • CREDIT_CARD_NUMBER
  • DATE
  • EMAIL_ADDRESS
  • IP_ADDRESS
  • LOCATION
  • MAC_ADDRESS
  • PASSPORT
  • PERSON_NAME
  • PHONE_NUMBER
  • SWIFT_CODE
  • US_DRIVERS_LICENSE_NUMBER
  • US_SOCIAL_SECURITY_NUMBER
  • US_VEHICLE_IDENTIFICATION_NUMBER
  • US_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 מוחל על טקסט שמסווג כ-DATE infoType. ב-DateShiftConfig נעשה שימוש בטכניקה של הזזת תאריכים עם הפרש של 100 ימים.
  • CryptoHashConfig מוחל על טקסט שמסווג כ-PERSON_NAME infoType. ‫CryptoHashConfig מבצע טוקניזציה על ידי יצירת ערך חלופי באמצעות גיבוב קריפטוגרפי.

ההתנהגות הבאה רלוונטית גם:

  • כל גיל של מטופל שערכו גדול מ-90 או שווה לו מומר ל-90.
  • אם אי אפשר להחיל טרנספורמציה בגלל מגבלות של פורמט DICOM, המערכת מספקת ערך זמני לשמירת מקום (פלייסהולדר) שתואם לייצוג הערך (VR) של התג.
  • כל ערך אחר שתואם לאחד מסוגי המידע שמוגדרים כברירת מחדל ב-DICOM ב-Cloud Healthcare API, מוחלף בסוג המידע שלו. לדוגמה, אם התג PatientComments הכיל את המחרוזת "Ann Johnson went to Anytown Hospital", אז "Anytown" יוחלף ב-infoType LOCATION.

הדוגמאות הבאות מציגות את הפלט של שימוש בפרופיל ברירת המחדל DEIDENTIFY_TAG_CONTENTS במערך נתונים שמכיל מאגרי DICOM ונתוני DICOM. אתם יכולים להשוות את פלט ברירת המחדל הזה לפלטים שמתקבלים כשמשתמשים בטרנספורמציות פרימיטיביות שונות עם שילובים של infoType. בדוגמאות נעשה שימוש במכונה אחת של DICOM, אבל אפשר להסיר את פרטי הזיהוי מכמה מכונות.

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

  • השמות בפינה הימנית העליונה ובפינה השמאלית העליונה של התמונה השתנו באמצעות CryptoHashConfig
  • התאריכים בפינה הימנית העליונה ובפינה השמאלית העליונה של התמונה שונו באמצעות DateShiftConfig

dicom_infotype_default

REST

  1. הסרת פרטי הזיהוי מקבוצת הנתונים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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"
        }
      }
    }
    

    כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

    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
    הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של OPERATION_ID. תצטרכו את הערך הזה בשלב הבא.

  2. משתמשים ב-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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט שיתקבל: כשהתשובה מכילה את הערך "done": true, הפעולה הממושכת הסתיימה.
  3. אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה 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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    אתם אמורים לקבל תגובת JSON שדומה לזו:

  4. אחזור המטא-נתונים של המכונה באמצעות הערכים החדשים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט מכיל את המטא-נתונים החדשים. אתם יכולים להשוות בין המטא-נתונים החדשים לבין המטא-נתונים המקוריים כדי לראות את ההשפעה של הטרנספורמציה.

RedactConfig

ציון הערך redactConfig מצנזר ערך נתון על ידי הסרה מלאה שלו. להודעה redactConfig אין ארגומנטים. אם מציינים אותה, אפשר לבצע טרנספורמציה.

הדוגמאות הבאות מרחיבות את הגדרת ברירת המחדל, אבל עכשיו הן כוללות הגדרה של infoType‏ PERSON_NAME עם הטרנספורמציה redactConfig. שליחת הבקשה הזו מצנזרת את כל השמות מהמופע של DICOM.

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

dicom_redactconfig

REST

  1. הסרת פרטי הזיהוי מקבוצת הנתונים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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": {}
            }
          ]
        }
      }
    }
    

    כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

    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
    הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של OPERATION_ID. תצטרכו את הערך הזה בשלב הבא.

  2. משתמשים ב-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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט שיתקבל: כשהתשובה מכילה את הערך "done": true, הפעולה הממושכת הסתיימה.
  3. אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה 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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    אתם אמורים לקבל תגובת JSON שדומה לזו:

  4. אחזור המטא-נתונים של המכונה באמצעות הערכים החדשים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט מכיל את המטא-נתונים החדשים. אתם יכולים להשוות בין המטא-נתונים החדשים לבין המטא-נתונים המקוריים כדי לראות את ההשפעה של הטרנספורמציה.

בפלט אפשר לראות שהערכים ב-ReferringPhysicianName (00080090) וב-PatientName (00100010) הוסרו. זאת בניגוד לדוגמה בהגדרת ברירת המחדל, שבה הערכים האלה עברו טרנספורמציה באמצעות גיבוב קריפטוגרפי.

CharacterMaskConfig

אם מציינים את הערך characterMaskConfig, מחרוזות שתואמות לסוגי המידע הנתונים מוחלפות בתו קבוע שצוין. לדוגמה, במקום לצנזר את שם המטופל או לשנות אותו באמצעות גיבוב קריפטוגרפי, אפשר להחליף את השם בסדרה של כוכביות (*). אפשר לציין את התו הקבוע כערך בשדה maskingCharacter.

הדוגמאות הבאות מרחיבות את הגדרת ברירת המחדל, אבל עכשיו הן כוללות הגדרה של infoType‏ LAST_NAME עם הטרנספורמציה characterMaskConfig. לא צוין תו קבוע, ולכן ברירת המחדל היא שימוש בכוכביות.

בדוגמאות נעשה שימוש במכונה אחת של DICOM, אבל אפשר להסיר את פרטי הזיהוי מכמה מכונות.

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

dicom_charactermaskconfig

REST

  1. הסרת פרטי הזיהוי מקבוצת הנתונים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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": ""
              }
            }
          ]
        }
      }
    }
    

    כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

    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
    הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של OPERATION_ID. תצטרכו את הערך הזה בשלב הבא.

  2. משתמשים ב-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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט שיתקבל: כשהתשובה מכילה את הערך "done": true, הפעולה הממושכת הסתיימה.
  3. אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה 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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    אתם אמורים לקבל תגובת JSON שדומה לזו:

  4. אחזור המטא-נתונים של המכונה באמצעות הערכים החדשים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט מכיל את המטא-נתונים החדשים. אתם יכולים להשוות בין המטא-נתונים החדשים לבין המטא-נתונים המקוריים כדי לראות את ההשפעה של הטרנספורמציה.

בפלט אפשר לראות ששמות המשפחה בעמודות ReferringPhysicianName (00080090) ו-PatientName (00100010) הוחלפו בכוכביות. זאת בניגוד לדוגמה בהגדרת ברירת המחדל, שבה הערכים האלה עברו טרנספורמציה באמצעות גיבוב קריפטוגרפי.

DateShiftConfig

באמצעות Cloud Healthcare API אפשר לשנות תאריכים על ידי הזזה שלהם בטווח מוגדר מראש. כדי לשמור על עקביות בשינויי התאריכים בין הפעלות שונות של הסרת פרטי הזיהוי, משתמשים ב-DateShiftConfig עם אחת מהאפשרויות הבאות:

כדי לפענח את המפתח שעטוף ב-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, התמונה נראית כך:

dicom_dateshiftconfig

REST

  1. הסרת פרטי הזיהוי מקבוצת הנתונים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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="
              }
            }
          ]
        }
      }
    }
    

    כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

    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
    הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של OPERATION_ID. תצטרכו את הערך הזה בשלב הבא.

  2. משתמשים ב-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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט שיתקבל: כשהתשובה מכילה את הערך "done": true, הפעולה הממושכת הסתיימה.
  3. אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה 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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    אתם אמורים לקבל תגובת JSON שדומה לזו:

  4. אחזור המטא-נתונים של המכונה באמצעות הערכים החדשים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט מכיל את המטא-נתונים החדשים. אתם יכולים להשוות בין המטא-נתונים החדשים לבין המטא-נתונים המקוריים כדי לראות את ההשפעה של הטרנספורמציה.

בפלט אפשר לראות של-StudyDate (00080020) ול-PatientBirthDate (00100030) יש ערכים חדשים. השינויים האלה התרחשו כתוצאה משילוב של ההפרש של 100 הימים עם הערך של cryptoKey שסופק. ערכי התאריכים החדשים עקביים במופע הזה בין הפעלות של הסרת פרטי הזיהוי, כל עוד מספקים את אותו cryptoKey.

CryptoHashConfig

אפשר להשאיר את השדה cryptoHashConfig ריק, או להזין בו:

כדי לפענח את המפתח שעטוף ב-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, התמונה נראית כך:

dicom_cryptohashconfig

REST

  1. הסרת פרטי הזיהוי מקבוצת הנתונים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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="
              }
            }
          ]
        }
      }
    }
    

    כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

    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
    הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של OPERATION_ID. תצטרכו את הערך הזה בשלב הבא.

  2. משתמשים ב-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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט שיתקבל: כשהתשובה מכילה את הערך "done": true, הפעולה הממושכת הסתיימה.
  3. אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה 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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    אתם אמורים לקבל תגובת JSON שדומה לזו:

  4. אחזור המטא-נתונים של המכונה באמצעות הערכים החדשים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט מכיל את המטא-נתונים החדשים. אתם יכולים להשוות בין המטא-נתונים החדשים לבין המטא-נתונים המקוריים כדי לראות את ההשפעה של הטרנספורמציה.

הטרנספורמציות בפלט עקביות במופע הזה בין הרצות של הסרת פרטי הזיהוי, כל עוד מספקים את אותו cryptoKey.

ReplaceWithInfoTypeConfig

אם מציינים את הערך replaceWithInfoTypeConfig, ערכי הקלט מוחלפים בשם של ה-infoType של הערך.

בדוגמאות הבאות מוסבר איך להחיל טרנספורמציה של replaceWithInfoTypeConfig על כל סוגי המידע שמוגדרים כברירת מחדל ב-DICOM ונתמכים ב-Cloud Healthcare API. להודעה replaceWithInfoTypeConfig אין ארגומנטים, והציון שלה מאפשר טרנספורמציה.

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

dicom_replacewithinfotypeconfig

REST

  1. הסרת פרטי הזיהוי מקבוצת הנתונים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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": {}
            }
          ]
        }
      }
    }
    

    כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

    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
    הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של OPERATION_ID. תצטרכו את הערך הזה בשלב הבא.

  2. משתמשים ב-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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט שיתקבל: כשהתשובה מכילה את הערך "done": true, הפעולה הממושכת הסתיימה.
  3. אחרי שהסרת פרטי הזיהוי מסתיימת, אפשר לאחזר את המטא-נתונים של המכונה שהוסרו ממנה פרטי הזיהוי כדי לראות איך היא השתנתה. למופע שהוסרו ממנו פרטי הזיהוי יש מזהה 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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    אתם אמורים לקבל תגובת JSON שדומה לזו:

  4. אחזור המטא-נתונים של המכונה באמצעות הערכים החדשים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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 Content

    APIs 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 , מבצעים את השלבים הבאים:

  1. נכנסים לדף Datasets במסוף Google Cloud .

    לדף Datasets

  2. לוחצים על קבוצת הנתונים שמכילה את הנתונים שרוצים להסיר מהם את פרטי הזיהוי.

  3. ברשימת מאגרי ה-DICOM, בוחרים באפשרות De-identify מהרשימה Actions של מאגר ה-DICOM שרוצים להסיר ממנו את פרטי הזיהוי.

    מופיע הדף De-identify DICOM store.

  4. בוחרים באפשרות Set destination data store ובוחרים את קבוצת הנתונים ואת מאגר ה-DICOM שבהם יישמרו הנתונים שעברו הסרת פרטי זיהוי.

  5. בוחרים באפשרות DICOM tag de-identification כדי להגדיר איך להסיר את פרטי הזיהוי מהנתונים. אפשר להסיר את פרטי הזיהוי מהנתונים בדרכים הבאות:

  6. בוחרים באפשרות DICOM burnt-in text redaction כדי להגדיר איך תתבצע צנזורת התמונות במהלך הסרת פרטי הזיהוי. כך מגדירים צנזור תמונות:

    • ‫REDACT_NO_TEXT: לא לצנזר טקסט בתמונות
    • ‫REDACT_SENSITIVE_TEXT: צנזור של טקסט רגיש בלבד בתמונות. כדי לצנזר גם טקסט שתואם לביטויים רגולריים בהתאמה אישית:
      1. לוחצים על שימוש בהגדרה מותאמת אישית.
      2. בוחרים באפשרות שימוש בביטוי רגולרי מותאם אישית.
      3. בשדה ביטוי רגולרי בהתאמה אישית, מזינים את תבנית הביטוי הרגולרי להתאמה.
      4. אופציונלי: בשדה Group Index, מזינים עד שלושה אינדקסים של קבוצות לחילוץ שמופרדים בפסיקים כדי לצנזר, לדוגמה 1,2. כדי לצנזר את כל ההתאמה, משאירים את השדה ריק או מזינים 0.
      5. אופציונלי: לוחצים על הוספת ביטוי רגולרי מותאם אישית כדי להגדיר ביטויים רגולריים מותאמים אישית נוספים.
    • ‫REDACT_ALL_TEXT: צנזור כל הטקסט בתמונות
  7. לוחצים על De-identify כדי להסיר פרטי זיהוי מהנתונים במאגר ה-DICOM.

REST

  1. הסרת פרטי הזיהוי מקבוצת הנתונים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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"
        }
      }
    }
    

    כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

    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
    הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של OPERATION_ID. תצטרכו את הערך הזה בשלב הבא.

  2. משתמשים ב-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 Content

    APIs 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. לאחר מכן תוכלו לבצע את הפעולות הבאות:

  1. שולחים שאילתה לגבי מזהי ה-UID של המחקר, הסדרה והמופע שמעניינים אתכם. לדוגמה, אחרי שמייצאים את המטא-נתונים ל-BigQuery, אפשר להריץ את השאילתה הבאה כדי לשרשר את מזהי ה-UID של המחקר, הסדרה והמופע לפורמט שתואם לדרישות של קובץ הסינון:

    SELECT CONCAT
      ('/studies/', StudyInstanceUID, '/series/', SeriesInstanceUID, '/instances/', SOPInstanceUID)
    FROM
      [PROJECT_ID:BIGQUERY_DATASET.BIGQUERY_TABLE]
  2. אם השאילתה מחזירה קבוצת תוצאות גדולה, אתם יכולים ליצור טבלה חדשה על ידי שמירת תוצאות השאילתה בטבלת יעד ב-BigQuery.

  3. אחרי ששומרים את תוצאות השאילתה בטבלת היעד, אפשר לשמור את התוכן של טבלת היעד בקובץ ולייצא אותו ל-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

  1. הסרת פרטי הזיהוי מקבוצת הנתונים.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫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"
      }
    }
    

    כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

    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
    הפלט שיתקבל: התשובה מכילה מזהה של פעולה ממושכת. פעולות ממושכות מוחזרות כשהפעלות של שיטות (methods) עשויות להימשך זמן רב. שימו לב לערך של OPERATION_ID. תצטרכו את הערך הזה בשלב הבא.

  2. משתמשים ב-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 Content

    APIs Explorer

    פותחים את דף העזר של ה-method. החלונית של APIs Explorer תיפתח בצד ימין של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.

    הפלט שיתקבל: כשהתשובה מכילה את הערך "done": true, הפעולה הממושכת הסתיימה.

פתרון בעיות בפעולות של הסרת פרטי הזיהוי ב-DICOM

אם מתרחשות שגיאות במהלך פעולת הסרת פרטי הזיהוי של DICOM, השגיאות נרשמות ב-Cloud Logging. מידע נוסף זמין במאמר צפייה ביומני שגיאות ב-Cloud Logging.

אם כל הפעולה מחזירה שגיאה, עיינו במאמר פתרון בעיות בפעולות ארוכות.