Envie uma solicitação de processamento

REST

Este exemplo mostra como fornecer conteúdo de documentos (conteúdo de documentos não processado em bytes através de uma string codificada em base64) no objeto rawDocument.

Em alternativa, também pode especificar inlineDocument, que é o mesmo formato JSON Document devolvido pelo Document AI. Isto permite-lhe encadear pedidos transmitindo o mesmo formato em ambas as direções (por exemplo, se classificar um documento e, em seguida, extrair o respetivo conteúdo).

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• LOCATION: a localização do seu processador, por exemplo:
  • us – Estados Unidos
  • eu - União Europeia
• PROJECT_ID: o ID do seu Google Cloud projeto.
• PROCESSOR_ID: o ID do seu processador personalizado.
• skipHumanReview: um valor booleano para desativar a revisão humana (apenas suportado por processadores humanos no circuito).
  • true - ignora a revisão humana
  • false: Ativa a revisão humana (predefinição)
• MIME_TYPE^†: Uma das opções de tipo MIME válidas.
• IMAGE_CONTENT^†: um dos conteúdos de documentos inline válidos, representado como uma stream de bytes. Para representações JSON, a codificação base64 (string ASCII) dos dados da imagem binária. Esta string deve ser semelhante à seguinte string:
  • /9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
  Visite o tópico Codificação Base64 para mais informações.
• FIELD_MASK: especifica os campos a incluir na saída Document. Esta é uma lista separada por vírgulas de nomes totalmente qualificados de campos no formato FieldMask.
  • Exemplo: text,entities,pages.pageNumber
• INDIVIDUAL_PAGES: uma lista de páginas individuais a processar.
  • Em alternativa, indique o campo fromStart ou fromEnd para processar uma quantidade específica de páginas a partir do início ou do fim do documento.

† Também pode especificar este conteúdo através de conteúdo codificado em base64 no objeto inlineDocument.

Método HTTP e URL:

POST https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID:process

Corpo JSON do pedido:

{
  "skipHumanReview": skipHumanReview,
  "rawDocument": {
    "mimeType": "MIME_TYPE",
    "content": "IMAGE_CONTENT"
  },
  "fieldMask": "FIELD_MASK",
  "processOptions": {
    "individualPageSelector" {
      "pages": [INDIVIDUAL_PAGES]
    }
  }
}

Para enviar o seu pedido, escolha uma destas opções:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID:process"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID:process" | Select-Object -Expand Content

Se o pedido for bem-sucedido, o servidor devolve um código de estado HTTP 200 OK e a resposta no formato JSON. O corpo da resposta contém uma instância de Document.

Envie o pedido para uma versão do processador

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• LOCATION: a localização do seu processador, por exemplo:
  • us – Estados Unidos
  • eu - União Europeia
• PROJECT_ID: o ID do seu Google Cloud projeto.
• PROCESSOR_ID: o ID do seu processador personalizado.
• PROCESSOR_VERSION: o identificador da versão do processador. Consulte o artigo Selecione uma versão do processador para mais informações. Por exemplo:
  • pretrained-TYPE-vX.X-YYYY-MM-DD
  • stable
  • rc
• skipHumanReview: um valor booleano para desativar a revisão humana (apenas suportado por processadores humanos no circuito).
  • true - ignora a revisão humana
  • false: Ativa a revisão humana (predefinição)
• MIME_TYPE^†: Uma das opções de tipo MIME válidas.
• IMAGE_CONTENT^†: um dos conteúdos de documentos inline válidos, representado como uma stream de bytes. Para representações JSON, a codificação base64 (string ASCII) dos dados da imagem binária. Esta string deve ser semelhante à seguinte string:
  • /9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
  Visite o tópico Codificação Base64 para mais informações.
• FIELD_MASK: especifica os campos a incluir na saída Document. Esta é uma lista separada por vírgulas de nomes totalmente qualificados de campos no formato FieldMask.
  • Exemplo: text,entities,pages.pageNumber

† Também pode especificar este conteúdo através de conteúdo codificado em base64 no objeto inlineDocument.

Método HTTP e URL:

POST https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:process

Corpo JSON do pedido:

{
  "skipHumanReview": skipHumanReview,
  "rawDocument": {
    "mimeType": "MIME_TYPE",
    "content": "IMAGE_CONTENT"
  },
  "fieldMask": "FIELD_MASK"
}

Para enviar o seu pedido, escolha uma destas opções:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \