Label metadata kustom

Document AI mendukung penambahan label yang ditentukan pengguna atau key-value pair (KVP) sebagai metadata yang dikirim ke pemroses untuk permintaan ProcessDocument, BatchProcessDocuments. Metadata tentang permintaan ini (beserta data penggunaan, seperti jumlah halaman) diteruskan ke sistem Penagihan Cloud. Data ini diisi di sistem penagihan, tempat Anda dapat mengelompokkan tagihan penagihan dengan memfilter menggunakan label metadata ini.

Kasus penggunaan

Kasus penggunaan penting untuk label melibatkan pelanggan yang menyediakan layanan pemrosesan dokumen kepada banyak klien. Satu project dapat digunakan untuk beberapa klien. Untuk tujuan penagihan, penting untuk mengaitkan permintaan tertentu dengan kliennya masing-masing. Di sinilah label metadata ini berperan. Laporan ini digunakan untuk memfilter laporan di Google Cloud.

Persyaratan untuk label

Label yang diterapkan ke permintaan harus memenuhi persyaratan berikut:

• Setiap permintaan dapat memiliki beberapa label, hingga maksimum 64 label.
• Setiap label harus berupa KVP.
• Kunci memiliki panjang minimum 1 karakter dan maksimum 63 karakter serta tidak boleh kosong. Nilai boleh kosong dan memiliki panjang maksimum 63 karakter.
• Kunci dan nilai hanya berisi huruf kecil, karakter numerik, garis bawah, dan tanda hubung. Semua karakter harus menggunakan encoding UTF-8, dan karakter internasional boleh digunakan.
• Bagian kunci label harus unik dalam satu permintaan (misalnya, {'country':'india'} boleh saja, tetapi {'country':'india','country':'sweden'} tidak diizinkan).
• Kunci harus diawali dengan huruf kecil atau karakter internasional.

Penggunaan dengan API

Contoh kode Sync Process menunjukkan cara mengirim permintaan ke pemroses menggunakan label.

  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"

Contoh Permintaan

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

Contoh kode Async Process menunjukkan cara mengirim permintaan ke pemroses menggunakan label.

  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"

Contoh Permintaan

  {
   "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
 }

Laporan harga

Anda dapat menggunakan label ini untuk melihat penggunaan permintaan.

1. Buka konsol Cloud Billing.

2. Dari konsol, pilih Menu di kiri atas, lalu pilih Penagihan dari menu drop-down. Jika Anda memiliki beberapa akun penagihan, akan muncul halaman yang meminta Anda untuk memilih. Pilih Buka akun penagihan tertaut.

   

   

3. Dari halaman penagihan, pilih Laporan di panel navigasi sebelah kiri.

   

4. Gunakan filter di panel sebelah kanan untuk memeriksa penggunaan permintaan.