圖片公用程式

一組公用程式動作,可在調查期間協助分析、擷取及轉換圖片和檔案內容。主要功能包括用於擷取文字的光學字元辨識 (OCR)、光柵化 (將網路內容轉換為靜態圖片),以及檔案格式轉換。所有動作都需要遠端代理。

動作

如要進一步瞭解動作,請參閱「 在工作區回應待處理動作」和「在案件中執行手動動作」。

轉換檔案

使用「轉換檔案」動作,變更指定檔案的格式。

動作輸入內容

「Convert File」動作需要下列參數:

參數 說明
Input File Format

這是必填欄位。

動作轉換的檔案原始格式。

可能的值如下:

  • PNG
  • PDF

預設值為 PNG。

Input File Path

這是必填欄位。

動作轉換的檔案路徑。

Output File Format

這是必填欄位。

轉換後的檔案格式。

可能的值如下:

  • PNG
  • PDF

預設值為 PDF。

動作輸出內容

「Convert File」(轉換檔案) 動作會提供下列輸出內容:

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼執行結果 可用
JSON 結果

以下範例顯示使用「Convert File」(轉換檔案) 動作時,收到的 JSON 結果輸出內容:

[
   {
       "output_format": ""  
       "file_path": ""
   }
]
輸出訊息

「轉換檔案」動作可能會傳回下列輸出訊息:

輸出訊息 訊息說明

Successfully converted file.

動作成功。
Error executing action "Convert File". Reason: ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用「Convert File」(轉換檔案) 動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success true或false

OCR 圖片

使用 OCR Image 動作執行 OCR,並從圖片檔擷取文字。

動作輸入內容

OCR Image 動作需要下列參數:

參數 說明
Base64 Encoded Image

選填。

圖片檔的 Base64 編碼字串。

File Path

這是必填欄位。

圖片檔的路徑。

動作輸出內容

「OCR Image」動作會提供下列輸出內容:

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼執行結果 可用
JSON 結果

以下範例顯示使用 OCR Image 動作時,收到的 JSON 結果輸出內容:

{ 
  "extracted_text": "",
}
輸出訊息

OCR Image 動作可傳回下列輸出訊息:

輸出訊息 訊息說明

Successfully performed OCR on the provided image.

動作成功。
Error executing action "OCR Image". Reason: ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用「OCR Image」(OCR 圖片) 動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success true或false

點陣化內容

使用「Rasterize Content」動作,將向量或複雜內容轉換為固定的點陣圖圖片格式。

遠端代理程式必要條件 (Debian)

為確保「Rasterize Content」(將內容點陣化) 動作在 Debian 遠端代理程式上順利執行,您必須安裝下列套件和依附元件:

Playwright Python 程式庫

使用下列指令安裝 Playwright Python 程式庫:

python3.11 -m pip install playwright
瀏覽器依附元件

安裝必要的 Chromium 瀏覽器依附元件,讓 Playwright 正常運作:

playwright install --with-deps chromium

動作輸入內容

參數 說明
Input Type

這是必填欄位。

動作主要輸入內容的類型。

可能的值如下:

  • URL
  • Email
  • HTML

預設值為 URL。

URLs or Body

這是必填欄位。

要光柵化的輸入內容,依據所選 Input Type。

如果選取 URL,請提供以逗號分隔的清單網址。

如果選取 Email 或 HTML,請提供該輸入類型的完整內容。

Output Type

選填。

點陣化內容的輸出格式。

可能的值如下:

  • PNG
  • PDF
  • Both

預設值為 PNG。

Export Method

選填。

輸出生成內容的方法。

可能的值如下:

  • Case Attachment
  • File Path
  • Both

預設值為 Case Attachment。

Width

這是必填欄位。

生成光柵內容的寬度 (以像素為單位)。

預設值為 1920。

Height

這是必填欄位。

生成光柵內容的高度 (以像素為單位)。

預設值為 1080。

Full Screen

選填。

如果選取,內容會在光柵化前,在整個瀏覽器視窗中顯示。

預設為停用。

Timeout

選填。

瀏覽器在開始光柵化之前,用於轉譯內容的時間上限 (以秒為單位)。

最大值為 60。

預設值為 120。

Wait For

選填。

瀏覽器必須達到的特定狀態,才能繼續執行光柵化或內容擷取。

NETWORK_IDLE 狀態通常最可靠。

可能的值如下:

  • LOAD
  • DOM_CONTENT_LOADED
  • NETWORK_IDLE COMMIT

預設值為 NETWORK_IDLE。

Wait for Selector

選填。

CSS 選取器,動作會等待該選取器顯示在網頁上,再擷取螢幕截圖。

動作輸出內容

「Rasterize Content」動作會提供下列輸出內容:

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼執行結果 可用
JSON 結果

以下範例顯示使用「Rasterize Content」動作時,收到的 JSON 結果輸出內容:

[
   {
       "attachment_name": "",
       "file_path": ""
   }
]
輸出訊息

「Rasterize Content」動作可能會傳回下列輸出訊息:

輸出訊息 訊息說明

Successfully rasterized content based on the provided input.

Successfully rasterized content based on the following URLs: URLS

Action wasn't able to rasterize content for the following URLs: URLS

Action wasn't able to rasterize content for the provided URLs.

動作成功。
Error executing action "Rasterize Content". Reason: ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用「Rasterize Content」動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success true或false

還有其他問題嗎?向社群成員和 Google SecOps 專業人員尋求解答。