Method: projects.files.annotate

複数のファイルに対して一括で画像検出とアノテーションを実行するサービス。現在、「application/pdf」、「image/tiff」、「image/gif」のみがサポートされています。

このサービスは、指定されたファイルから最大で 5 個のフレーム(gif)またはページ(PDF または tiff)を抽出して、抽出した各画像の検出とアノテーションを実行します(抽出対象は AnnotateFileRequest.pages で指定できます)。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

省略可。呼び出しを行うターゲット プロジェクトとロケーション。

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

親が指定されていない場合、リージョンが自動的に選択されます。

サポートされているロケーション ID: us: 米国のみ。asia: 東アジア地域(日本、台湾など)。eu: EU。

例: projects/project-A/locations/eu

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現
{
  "requests": [
    {
      object (AnnotateFileRequest)
    }
  ]
}
フィールド
requests[]

object (AnnotateFileRequest)

必須。ファイル アノテーション リクエストのリスト。現在、BatchAnnotateFilesRequest では AnnotateFileRequest が 1 つだけサポートされています。

レスポンスの本文

成功した場合、レスポンスの本文には BatchAnnotateFilesResponse のインスタンスが含まれます。

認証スコープ

次の OAuth スコープのいずれかが必要です。

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

詳細については、認証の概要をご覧ください。