Method: files.asyncBatchAnnotate

여러 페이지를 포함할 수 있고 페이지당 여러 이미지를 포함할 수 있는 PDF 파일과 같은 일반 파일 목록에 대해 비동기 이미지 감지 및 주석을 실행합니다. google.longrunning.Operations 인터페이스를 통해 진행 상태 및 결과를 가져올 수 있습니다. Operation.metadata에는 OperationMetadata(메타데이터)가 포함됩니다. Operation.response에는 AsyncBatchAnnotateFilesResponse(결과)가 포함됩니다.

HTTP 요청

POST https://vision.googleapis.com/v1p3beta1/files:asyncBatchAnnotate

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

요청 본문

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

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

object(AsyncAnnotateFileRequest)

이 배치에 대한 개별 비동기 파일 주석 요청입니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

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

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

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

AsyncAnnotateFileRequest

오프라인 파일 주석 요청입니다.

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

object(InputConfig)

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

features[]

object(Feature)

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

imageContext

object(ImageContext)

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

outputConfig

object(OutputConfig)

필수. 원하는 출력 위치와 메타데이터(예: 형식)입니다.

InputConfig

원하는 입력 위치 및 메타데이터입니다.

JSON 표현 
{
  "gcsSource": {
    object(GcsSource)
  },
  "mimeType": string
}
필드
gcsSource

object(GcsSource)

입력을 읽을 Google Cloud Storage 위치입니다.

mimeType

string

파일 유형입니다. 현재는 'application/pdf' 및 'image/tiff'만 지원됩니다. 와일드 카드는 지원되지 않습니다.

GcsSource

입력을 읽을 Google Cloud Storage 위치입니다.

JSON 표현 
{
  "uri": string
}
필드
uri

string

입력 파일의 Google Cloud Storage URI입니다. Google Cloud Storage 객체여야 합니다. 현재 와일드 카드는 지원되지 않습니다.

OutputConfig

원하는 출력 위치 및 메타데이터입니다.

JSON 표현 
{
  "gcsDestination": {
    object(GcsDestination)
  },
  "batchSize": number
}
필드
gcsDestination

object(GcsDestination)

출력을 기록할 Google Cloud Storage 위치입니다.

batchSize

number

Google Cloud Storage의 각 출력 JSON 파일에 넣을 응답 proto의 최대 개수입니다. 유효한 범위는 [1, 100]입니다. 지정되지 않은 경우 기본값은 20입니다.

예를 들어 100페이지로 된 PDF 파일 1개의 경우 100개의 응답 proto가 생성됩니다. batchSize = 20인 경우 각각 20개의 응답 proto가 포함된 5개의 json 파일이 gcsDestination.uri 프리픽스로 기록됩니다.

현재 batchSize는 GcsDestination에만 적용되며 향후 다른 출력 구성에도 지원될 수 있습니다.

GcsDestination

출력이 기록될 Google Cloud Storage 위치입니다.

JSON 표현 
{
  "uri": string
}
필드
uri

string

결과가 저장될 Google Cloud Storage URI입니다. 결과는 JSON 형식이며 해당 입력 URI가 앞에 옵니다. 이 필드는 단일 파일 또는 여러 출력의 프리픽스를 나타낼 수 있습니다. 프리픽스는 /로 끝나야 합니다.

예를 들면 다음과 같습니다.

출력이 여러 개 있는 경우에도 각 응답은 여전히 AnnotateFileResponse이며, 각각 전체 AnnotateImageResponse 목록에 대한 하위 집합을 포함합니다. 출력 JSON이 너무 크고 샤딩된 여러 파일에 오버플로될 경우 등에 출력이 여러 번 발생할 수 있습니다.