처리할 문서를 보내기 전에 먼저 프로세서의 자체 인스턴스를 만들어야 합니다. 이 페이지에서는 프로세서 생성 및 관리에 대해 자세히 설명합니다.
사용 가능한 프로세서
API를 사용하여 프로세서 인스턴스를 만들려면 각 프로세서 유형의 이름을 알아야 합니다. 액세스 권한이 변경될 수 있으므로 아래 코드를 사용하여 이 목록을 동적으로 가져옵니다.
공개적으로 제공되는 프로세서 유형은 다음과 같습니다.
프로세서 디지털화
OCR_PROCESSORFORM_PARSER_PROCESSORLAYOUT_PARSER_PROCESSOR
사전 학습된 프로세서
BANK_STATEMENT_PROCESSOREXPENSE_PROCESSORFORM_W2_PROCESSORID_PROOFING_PROCESSORINVOICE_PROCESSORPAYSTUB_PROCESSORUS_DRIVER_LICENSE_PROCESSORUS_PASSPORT_PROCESSORUTILITY_PROCESSOR
추출 / 분류 / 분할 프로세서
CUSTOM_EXTRACTION_PROCESSORCUSTOM_CLASSIFICATION_PROCESSORCUSTOM_SPLITTING_PROCESSORSUMMARIZER_PROCESSOR
프로세서 유형 나열
웹 UI
Google Cloud 콘솔의 Document AI 섹션에서 프로세서 갤러리 페이지로 이동합니다.
프로세서 유형 목록을 보거나 검색합니다.
REST
이 샘플에서는 fetchProcessorTypes 메서드를 사용하여 프로젝트에 사용 가능한 프로세서 유형을 나열하는 방법을 보여줍니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- LOCATION: 프로세서의 위치입니다(예:
- ).
us- 미국eu- 유럽 연합
- PROJECT_ID: Google Cloud 프로젝트 ID입니다.
HTTP 메서드 및 URL:
GET https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION:fetchProcessorTypes
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
다음 명령어를 실행합니다.
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION:fetchProcessorTypes"
PowerShell
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION:fetchProcessorTypes" | Select-Object -Expand Content
응답은 사용 가능한 프로세서 유형, 카테고리, 사용 가능한 위치를 보여주는 ProcessorType 목록입니다.
{
"processorTypes": [
[
...
{
"name": "projects/PROJECT_ID/locations/LOCATION/processorTypes/FORM_PARSER_PROCESSOR",
"type": "FORM_PARSER_PROCESSOR",
"category": "GENERAL",
"availableLocations": [
{
"locationId": "eu"
},
{
"locationId": "us"
}
],
"allowCreation": true,
"launchStage": "GA"
},
{
"name": "projects/PROJECT_ID/locations/LOCATION/processorTypes/OCR_PROCESSOR",
"type": "OCR_PROCESSOR",
"category": "GENERAL",
"availableLocations": [
{
"locationId": "eu"
},
{
"locationId": "us"
}
],
"allowCreation": true,
"launchStage": "GA"
},
{
"name": "projects/PROJECT_ID/locations/LOCATION/processorTypes/INVOICE_PROCESSOR",
"type": "INVOICE_PROCESSOR",
"category": "SPECIALIZED",
"availableLocations": [
{
"locationId": "eu"
},
{
"locationId": "us"
}
],
"allowCreation": true,
"launchStage": "GA"
},
{
"name": "projects/PROJECT_ID/locations/LOCATION/processorTypes/US_DRIVER_LICENSE_PROCESSOR",
"type": "US_DRIVER_LICENSE_PROCESSOR",
"category": "SPECIALIZED",
"availableLocations": [
{
"locationId": "us"
},
{
"locationId": "eu"
}
],
"allowCreation": true,
"launchStage": "GA"
},
...
]
}
Python
자세한 내용은 Document AI Python API 참조 문서를 참고하세요.
Document AI에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
자세한 내용은 Document AI Go API 참조 문서를 참고하세요.
Document AI에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
자세한 내용은 Document AI Java API 참조 문서를 참고하세요.
Document AI에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Ruby
자세한 내용은 Document AI Ruby API 참조 문서를 참고하세요.
Document AI에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
C#
자세한 내용은 Document AI C# API 참조 문서를 참고하세요.
Document AI에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
프로세서 만들기
웹 UI
REST
이 샘플에서는 processors.create 메서드를 사용하여 새 processor를 만드는 방법을 보여줍니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- LOCATION: 프로세서의 위치입니다(예:
- ).
us- 미국eu- 유럽 연합
- PROJECT_ID: Google Cloud 프로젝트 ID입니다.
- PROCESSOR_TYPE: 프로세서 유형입니다(예:
OCR_PROCESSORFORM_PARSER_PROCESSORINVOICE_PROCESSORUS_DRIVER_LICENSE_PROCESSOR
- DISPLAY_NAME: 프로세서의 표시 이름입니다.
HTTP 메서드 및 URL:
POST https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors
JSON 요청 본문:
{
"type": "PROCESSOR_TYPE",
"displayName": "DISPLAY_NAME"
}
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors"
PowerShell
요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors" | Select-Object -Expand Content
요청이 성공하면 서버가 200 OK HTTP 상태 코드와 응답을 JSON 형식으로 반환합니다. 응답에는 새로 생성된 프로세서에 관한 정보(예: processEndpoint 및 전체 프로세서 이름)가 포함됩니다.
두 문자열 모두 요청을 전송하는 데 필요한 고유 프로세서 ID (예: aa22ec60216f6ccc)가 포함되어 있습니다.
{
"name": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID",
"type": "PROCESSOR_TYPE",
"displayName": "DISPLAY_NAME",
"state": "ENABLED",
"processEndpoint": "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID:process",
"createTime": "2022-03-02T22:50:31.395849Z",
"defaultProcessorVersion": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/pretrained"
}
Python
자세한 내용은 Document AI Python API 참조 문서를 참고하세요.
Document AI에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
자세한 내용은 Document AI Go API 참조 문서를 참고하세요.
Document AI에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
자세한 내용은 Document AI Java API 참조 문서를 참고하세요.
Document AI에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.