커스텀 메타데이터 라벨

Document AI는 ProcessDocument, BatchProcessDocuments 요청에 프로세서로 전송되는 메타데이터로 사용자 정의 라벨 또는 키-값 쌍 (KVP)을 추가하는 것을 지원합니다. 요청에 관한 이 메타데이터는 사용량 데이터 (예: 페이지 수)와 함께 Cloud Billing 시스템으로 전달됩니다. 이 필드는 결제 시스템에 채워지며, 여기에서 이러한 메타데이터 라벨을 사용하여 필터링하여 청구 상세 내역을 확인할 수 있습니다.

사용 사례

라벨의 중요한 사용 사례에는 다수의 클라이언트에 문서 처리 서비스를 제공하는 고객이 포함됩니다. 하나의 프로젝트를 여러 클라이언트에 사용할 수 있습니다. 결제 용도로 특정 요청을 해당 클라이언트와 연결해야 합니다. 이때 메타데이터 라벨이 사용됩니다. Google Cloud에서 보고서를 필터링하는 데 사용됩니다.

라벨 요구사항

요청에 적용된 라벨은 다음 요구사항을 충족해야 합니다.

• 각 요청에는 라벨이 최대 64개까지 있을 수 있습니다.
• 각 라벨은 KVP여야 합니다.
• 키는 비워 둘 수 없으며 최소 길이는 1자이고 최대 길이는 63자입니다. 값은 비워 둘 수 있으며 최대 길이는 63자(영문 기준)입니다.
• 키와 값에는 소문자, 숫자, 밑줄, 대시만 사용합니다. 모든 문자는 UTF-8 인코딩을 사용해야 하며 국제 문자가 허용됩니다.
• 라벨의 키 부분은 단일 요청 내에서 고유해야 합니다. 예를 들어 {'country':'india'}는 문제가 없지만 {'country':'india','country':'sweden'}은 허용되지 않습니다.
• 키는 소문자나 국제 문자로 시작해야 합니다.

API와 함께 사용

Sync Process 코드 샘플은 라벨을 사용하여 프로세서에 요청을 보내는 방법을 보여줍니다.

  curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @docai_request.json \
    "https://us-documentai.googleapis.com/v1/projects/514064100333/locations/us/processors/3bb61571a9731982:process"

샘플 요청

  {
    "skipHumanReview": true,
    "rawDocument": {
      "mimeType": "application/pdf",
        "content" : "PDF/IMAGE CONTENT"
    },
    "labels": {"country": "india" },
    "processOptions": {
      "individualPageSelector" : {
        "pages": [1]
      }
    }
  }

Async Process 코드 샘플은 라벨을 사용하여 프로세서에 요청을 보내는 방법을 보여줍니다.

  curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @batch_docai_request.json \
    "https://us-documentai.googleapis.com/v1/projects/514064100333/locations/us/processors/3bb61571a9731982:batchProcess"

샘플 요청

  {
   "inputDocuments": {
     "gcsPrefix": {
       "gcsUriPrefix": "gs://atul_dai_test/ravi/GCS_DWH_work_flows_docs/Small_pdf/"
     }
   },
   "documentOutputConfig": {
     "gcsOutputConfig": {
       "gcsUri": "gs://atul_dai_test/ravi/GCS_DWH_work_flows_docs/test/docai_config/"
     }
   },
   "labels": {"country": "india" },
   "skipHumanReview": true
 }

가격 책정 보고서

이러한 라벨을 사용하여 요청 사용량을 확인할 수 있습니다.

1. Cloud Billing 콘솔로 이동합니다.

2. 콘솔에서 왼쪽 상단의 메뉴를 선택하고 드롭다운에서 결제를 선택합니다. 결제 계정이 여러 개이면 선택하라는 메시지가 표시됩니다. 연결된 결제 계정으로 이동을 선택합니다.

   

   

3. 결제 페이지의 왼쪽 탐색 창에서 보고서를 선택합니다.

   

4. 오른쪽 창에서 필터를 사용하여 요청 사용량을 확인합니다.