自訂中繼資料標籤
Document AI 支援將使用者定義的標籤或鍵/值組合 (KVP) 新增為中繼資料，並傳送至處理器，以便處理 ProcessDocument 和 BatchProcessDocuments 要求。系統會將這項要求的中繼資料 (以及用量資料，例如頁面數量) 轉送至 Cloud Billing 系統。系統會在帳單系統中填入這些資訊，方便您使用這些中繼資料標籤篩選帳單費用。
用途
標籤的重要用途之一，是為許多客戶提供文件處理服務的客戶。單一專案可用於多個客戶。為了方便結算，請務必將特定要求與相應的客戶建立關聯。這時，這些中繼資料標籤就派上用場。用於篩選 Google Cloud中的報表。
標籤需求
套用至要求的標籤必須符合下列規定：
- 每個要求可以有多個標籤，上限為 64 個。
- 每個標籤都必須是鍵/值組合。
- 鍵的長度必須至少為 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
}
價格報表
您可以使用這些標籤查看要求用量。
前往 Cloud 帳單控制台。
在主控台中，選取左上方的 「選單」，然後從下拉式選單中選取「Billing」。如果您有多個帳單帳戶，系統會顯示要求您選取帳戶的頁面。選取「前往連結的帳單帳戶」。
在帳單頁面中，選取左側導覽窗格中的「報表」。
使用右側窗格中的篩選器，查看要求的用量。
