google-cloud-python icon indicating copy to clipboard operation
google-cloud-python copied to clipboard

Description for DocumentProcessorServiceAsyncClient class

Open gheduardo opened this issue 1 year ago • 1 comments

PLEASE READ: If you have a support contract with Google, please create an issue in the support console instead of filing on GitHub. This will ensure a timely response.

NOTE: Google Cloud Python client libraries are no longer maintained inside this repository. Please visit the python-API repository (e.g., https://github.com/googleapis/python-pubsub/issues) for faster response times.

See all published libraries in the README.

Descriptions for DocumentProcessorServiceAsyncClient and DocumentProcessorServiceClient class are exactly the same. There is no clear description on what their differences are nor when to use them. Moreover, the customers are growing confused since there is a limit of 10 pages per document processing when using DocumentProcessorServiceAsyncClient (except if using batch processing). See one more reference of the same in this Stack Overflow post:

https://stackoverflow.com/questions/71887957/400-document-pages-exceed-the-limit-page-limit-exceeded

This is shown in the public documentation here: https://cloud.google.com/python/docs/reference/documentai/latest/google.cloud.documentai_v1.services.document_processor_service

These GitHub pages are the source of the above:

  • DocumentProcessorServiceAsyncClient - packages/google-cloud-documentai/google/cloud/documentai_v1/services/document_processor_service/async_client.py
  • DocumentProcessorServiceClient - packages/google-cloud-documentai/google/cloud/documentai_v1/services/document_processor_service/client.py

Request:

  • Update class descriptions
  • Add use case
  • Add limitation of 10 pages per document when using DocumentProcessorServiceAsyncClient (except if using batch processing)

gheduardo avatar Apr 03 '24 20:04 gheduardo

@gheduardo Thanks for reporting this issue. We are taking a look into this and will provide an update soon.

ohmayr avatar Apr 04 '24 09:04 ohmayr