Method: files.annotate

파일 배치에 대한 이미지 감지 및 주석을 수행하는 서비스입니다. 이제 'application/pdf', 'image/tiff', 'image/gif'만 지원됩니다.

이 서비스는 제공된 각 파일에서 최대 5개(AnnotateFileRequest.pages에 지정 가능)의 프레임(gif) 또는 페이지(pdf 또는 tiff)를 추출하고 추출된 각 이미지에 대한 감지 및 주석을 수행합니다.

HTTP 요청

POST https://vision.googleapis.com/v1p4beta1/files:annotate

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "requests": [
    {
      object (AnnotateFileRequest)
    }
  ]
}
필드
requests[]

object (AnnotateFileRequest)

파일 주석 요청 목록입니다. 현재는 BatchAnnotateFilesRequest에서 AnnotateFileRequest가 한 개만 지원됩니다.

응답 본문

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

파일 주석 응답의 목록입니다.

JSON 표현 
{
  "responses": [
    {
      object (AnnotateFileResponse)
    }
  ]
}
필드
responses[]

object (AnnotateFileResponse)

파일 주석 응답의 목록으로, 각 응답은 BatchAnnotateFilesRequest의 각 AnnotateFileRequest에 해당합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

AnnotateFileRequest

PDF, TIFF 또는 GIF 파일 등 단일 파일에 주석을 달기 위한 요청입니다.

JSON 표현 
{
  "inputConfig": {
    object (InputConfig)
  },
  "features": [
    {
      object (Feature)
    }
  ],
  "imageContext": {
    object (ImageContext)
  },
  "pages": [
    number
  ]
}
필드
inputConfig

object (InputConfig)

필수. 입력 파일에 대한 정보입니다.

features[]

object (Feature)

필수. 요청한 기능입니다.

imageContext

object (ImageContext)

파일의 이미지와 함께 제공될 수 있는 추가 컨텍스트입니다.

pages[]

number

이미지 주석을 수행할 파일의 페이지입니다.

페이지는 1부터 시작되며 파일의 첫 번째 페이지를 1페이지로 가정합니다. 요청당 최대 5개 페이지가 지원됩니다. 페이지는 음수일 수 있습니다.

1페이지는 첫 번째 페이지를 의미합니다. 2페이지는 두 번째 페이지를 의미합니다. -1페이지는 마지막 페이지를 의미합니다. -2페이지는 마지막 페이지의 두 번째 페이지를 의미합니다.

파일이 PDF 또는 TIFF가 아닌 GIF인 경우 페이지는 GIF 프레임을 의미합니다.

이 필드가 비어 있으면 기본적으로 서비스가 파일의 처음 5 페이지에 대해 이미지 주석을 수행합니다.

AnnotateFileResponse

단일 파일 주석 요청에 대한 응답입니다. 파일에는 개별 응답이 있는 하나 이상의 이미지가 포함될 수 있습니다.

JSON 표현 
{
  "inputConfig": {
    object (InputConfig)
  },
  "responses": [
    {
      object (AnnotateImageResponse)
    }
  ],
  "totalPages": number
}
필드
inputConfig

object (InputConfig)

이 응답이 생성된 파일에 대한 정보입니다.

responses[]

object (AnnotateImageResponse)

파일 내에서 발견된 이미지에 대한 개별 응답입니다.

totalPages

number

이 필드는 파일의 총 페이지 수를 제공합니다.