Benutzerdefinierte Metadatenlabels

Document AI unterstützt das Hinzufügen benutzerdefinierter Labels oder Schlüssel/Wert-Paare (KVPs) als Metadaten, die an den Prozessor gesendet werden, um ProcessDocument- und BatchProcessDocuments-Anfragen zu verarbeiten. Diese Metadaten zur Anfrage werden zusammen mit den Nutzungsdaten wie der Anzahl der Seiten an das Cloud Billing-System weitergeleitet. Sie werden im Abrechnungssystem erfasst, wo Sie die abgerechneten Gebühren durch Filtern nach diesen Metadatenlabels aufschlüsseln können.

Anwendungsfall

Ein wichtiger Anwendungsfall für Labels sind Kunden, die Dokumentverarbeitungsdienste für viele Kunden anbieten. Ein einzelnes Projekt kann für mehrere Kunden verwendet werden. Zu Abrechnungszwecken ist es wichtig, bestimmte Anfragen ihren jeweiligen Kunden zuzuordnen. Hier kommen Metadatenlabels ins Spiel. Sie dienen zum Filtern von Berichten in Google Cloud.

Anforderungen an Labels

Die Labels, die auf eine Anfrage angewendet werden, müssen die folgenden Anforderungen erfüllen:

• Jede Anfrage kann bis zu 64 Labels haben.
• Jedes Label muss ein Schlüssel/Wert-Paar sein.
• Schlüssel haben eine Mindestlänge von einem Zeichen und eine maximale Länge von 63 Zeichen und dürfen nicht leer sein. Werte dürfen leer sein und haben eine maximale Länge von 63 Zeichen.
• Schlüssel und Werte enthalten nur Kleinbuchstaben, Ziffern, Unterstriche und Bindestriche. Alle Zeichen müssen UTF-8-codiert sein. Internationale Zeichen sind zulässig.
• Der Schlüsselabschnitt eines Labels muss innerhalb einer einzelnen Anfrage eindeutig sein. Beispiel: {'country':'india'} ist zulässig, {'country':'india','country':'sweden'} ist jedoch nicht zulässig.
• Schlüssel müssen mit einem Kleinbuchstaben oder einem internationalen Zeichen beginnen.

Verwendung mit API

Im Sync Process-Codebeispiel wird gezeigt, wie Sie eine Anfrage mit einem Label an einen Auftragsverarbeiter senden.

  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"

Beispielanfrage

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

Im Async Process-Codebeispiel wird gezeigt, wie Sie eine Anfrage mit einem Label an einen Auftragsverarbeiter senden.

  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"

Beispielanfrage

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

Preisbericht

Mit diesen Labels können Sie die Anfragenutzung einsehen.

1. Rufen Sie die Cloud Billing-Konsole auf.

2. Klicken Sie in der Console oben links auf das Dreistrich-Menü  Menü und wählen Sie im Drop-down-Menü Abrechnung aus. Wenn Sie mehrere Rechnungskonten haben, wird eine Seite angezeigt, auf der Sie aufgefordert werden, eine Auswahl zu treffen. Wählen Sie Zum verknüpften Rechnungskonto aus.

   

   

3. Wählen Sie auf der Seite „Abrechnung“ die Option Berichte im linken Navigationsbereich aus.

   

4. Verwenden Sie die Filter im rechten Bereich, um die Nutzung von Anfragen zu prüfen.