Etiquetas de metadatos personalizados

Document AI permite añadir etiquetas o pares clave-valor definidos por el usuario como metadatos enviados al procesador para ProcessDocument y BatchProcessDocuments solicitudes. Estos metadatos sobre la solicitud (junto con los datos de uso, como el número de páginas) se reenvían al sistema de facturación de Cloud. Se rellena en el sistema de facturación, donde puedes desglosar los cargos de facturación filtrando por estas etiquetas de metadatos.

Caso práctico

Un caso práctico importante de las etiquetas es el de los clientes que ofrecen servicios de procesamiento de documentos a muchos clientes. Se puede usar un mismo proyecto para varios clientes. A efectos de facturación, es importante asociar solicitudes específicas con sus respectivos clientes. Aquí es donde entran en juego estas etiquetas de metadatos. Se usan para filtrar informes en Google Cloud.

Requisitos de las etiquetas

Las etiquetas aplicadas a una solicitud deben cumplir los siguientes requisitos:

• Cada solicitud puede tener varias etiquetas, hasta un máximo de 64.
• Cada etiqueta debe ser un par clave-valor.
• Las claves tienen una longitud mínima de 1 carácter y una máxima de 63 caracteres, y no pueden estar vacías. Los valores pueden estar vacíos y tener una longitud máxima de 63 caracteres.
• Las claves y los valores solo contienen letras en minúscula, caracteres numéricos, guiones bajos y guiones. Todos los caracteres deben usar la codificación UTF-8 y se pueden usar caracteres internacionales.
• La parte de la clave de una etiqueta debe ser única en una sola solicitud (por ejemplo, {'country':'india'} es correcto, pero {'country':'india','country':'sweden'} no está permitido).
• Las claves deben empezar por una letra minúscula o un carácter internacional.

Uso con la API

El ejemplo de código de Sync Process muestra cómo enviar una solicitud a un procesador mediante una etiqueta.

  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"

Solicitud de ejemplo

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

El ejemplo de código de Async Process muestra cómo enviar una solicitud a un procesador mediante una etiqueta.

  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"

Solicitud de ejemplo

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

Informe de precios

Puedes usar estas etiquetas para ver el uso de las solicitudes.

1. Ve a la consola de facturación de Cloud.

2. En la consola, selecciona el menú de la parte superior izquierda y, en el menú desplegable, selecciona Facturación. Si tienes varias cuentas de facturación, aparecerá una página en la que se te pedirá que elijas una. Selecciona Ir a la cuenta de facturación vinculada.

   

   

3. En la página de facturación, selecciona Informes en el panel de navegación de la izquierda.

   

4. Usa los filtros del panel de la derecha para comprobar el uso de las solicitudes.