Method: projects.locations.files.annotate

這項服務可對批次檔案執行圖片偵測和註解作業。目前僅支援「application/pdf」、「image/tiff」和「image/gif」。

這項服務會從提供的每個檔案中，擷取最多 5 個影格 (GIF) 或頁面 (PDF 或 TIFF)，並對擷取的每張圖片執行偵測和註解作業。客戶可以在 AnnotateFileRequest.pages 中指定要擷取的 5 個影格/頁面。

HTTP 要求

POST https://{VISION_GDC_ENDPOINT}/v1/{parent}/files:annotate

路徑參數

參數
parent

string

(選用步驟) 要撥打電話的目標專案和位置。

格式：projects/{project-id}/locations/{location-id}。

如未指定父項，系統會自動選擇區域。

支援的位置 ID：us：僅限美國，asia：東亞地區，例如日本、臺灣，eu：歐盟。

範例：projects/project-A/locations/eu。

要求主體

要求主體包含下列結構的資料：

JSON 表示法 
{
  "requests": [
    {
      object (AnnotateFileRequest)
    }
  ]
}
欄位
requests[]

object (AnnotateFileRequest)

這是必要旗標，檔案註解要求清單。目前 BatchAnnotateFilesRequest 中僅支援一個 AnnotateFileRequest。

回應主體

如果成功，回應主體會包含 BatchAnnotateFilesResponse 的執行個體。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision