Method: projects.images.asyncBatchAnnotate

針對圖片清單執行非同步圖片偵測和註解。

您可以透過 google.longrunning.Operations 介面擷取進度和結果。Operation.metadata 包含 OperationMetadata (中繼資料)。Operation.response 包含 AsyncBatchAnnotateImagesResponse (結果)。

這項服務會將圖片註解輸出內容寫入客戶 Google Cloud Storage 值區中的 JSON 檔案,每個 JSON 檔案都包含 BatchAnnotateImagesResponse 原型。

HTTP 要求

POST https://vision.googleapis.com/v1/{parent=projects/*}/images:asyncBatchAnnotate

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

路徑參數

參數
parent

string

(非必要) 要呼叫的目標專案和位置。

格式:projects/{project-id}/locations/{location-id}

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

支援的位置 ID:us:僅限美國,asia:日本、臺灣等東亞地區,eu:歐盟。

範例:projects/project-A/locations/eu

要求主體

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

JSON 表示法
{
  "requests": [
    {
      object (AnnotateImageRequest)
    }
  ],
  "outputConfig": {
    object (OutputConfig)
  }
}
欄位
requests[]

object (AnnotateImageRequest)

這是必要旗標,此批次的個別圖片註解要求。

outputConfig

object (OutputConfig)

這是必要旗標,所需的輸出位置和中繼資料 (例如格式)。

回應主體

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

授權範圍

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

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

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