Method: projects.files.annotate

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

這項服務會從每個提供的檔案中擷取最多 5 個影格 (GIF) 或頁面 (PDF 或 TIF)，並針對每個擷取的圖片執行偵測和註解作業。

HTTP 要求

POST https://vision.googleapis.com/v1/{parent=projects/*}/files:annotate

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
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

詳情請參閱驗證總覽一文。