Label metadata kustom

Document AI mendukung penambahan label atau pasangan nilai kunci (KVP) yang ditentukan pengguna sebagai metadata yang dikirim ke pemroses untuk permintaan ProcessDocument, BatchProcessDocuments. Metadata tentang permintaan ini (bersama dengan data penggunaan, seperti jumlah halaman) diteruskan ke sistem Penagihan Cloud. Label ini diisi di sistem penagihan, tempat Anda dapat mengelompokkan biaya 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 fungsi label metadata ini. Filter 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 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.