google-cloud-document_ai-v1beta3 0.13.0 → 0.14.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/AUTHENTICATION.md +1 -1
- data/lib/google/cloud/document_ai/v1beta3/document_processor_service/client.rb +420 -0
- data/lib/google/cloud/document_ai/v1beta3/document_processor_service/paths.rb +23 -0
- data/lib/google/cloud/document_ai/v1beta3/version.rb +1 -1
- data/lib/google/cloud/documentai/v1beta3/document_io_pb.rb +3 -0
- data/lib/google/cloud/documentai/v1beta3/document_pb.rb +13 -0
- data/lib/google/cloud/documentai/v1beta3/document_processor_service_pb.rb +59 -0
- data/lib/google/cloud/documentai/v1beta3/document_processor_service_services_pb.rb +11 -0
- data/lib/google/cloud/documentai/v1beta3/evaluation_pb.rb +72 -0
- data/lib/google/cloud/documentai/v1beta3/processor_pb.rb +2 -0
- data/proto_docs/google/api/client.rb +318 -0
- data/proto_docs/google/api/launch_stage.rb +3 -3
- data/proto_docs/google/cloud/documentai/v1beta3/barcode.rb +29 -27
- data/proto_docs/google/cloud/documentai/v1beta3/document.rb +55 -11
- data/proto_docs/google/cloud/documentai/v1beta3/document_io.rb +7 -2
- data/proto_docs/google/cloud/documentai/v1beta3/document_processor_service.rb +159 -0
- data/proto_docs/google/cloud/documentai/v1beta3/document_schema.rb +4 -3
- data/proto_docs/google/cloud/documentai/v1beta3/evaluation.rb +181 -0
- data/proto_docs/google/cloud/documentai/v1beta3/processor.rb +8 -5
- data/proto_docs/google/cloud/documentai/v1beta3/processor_type.rb +2 -2
- metadata +7 -4
@@ -60,9 +60,9 @@ module Google
|
|
60
60
|
# Placeholder. Relationship among {::Google::Cloud::DocumentAI::V1beta3::Document#entities Document.entities}.
|
61
61
|
# @!attribute [rw] text_changes
|
62
62
|
# @return [::Array<::Google::Cloud::DocumentAI::V1beta3::Document::TextChange>]
|
63
|
-
# Placeholder. A list of text corrections made to
|
64
|
-
# usually used for annotating corrections to OCR mistakes. Text changes
|
65
|
-
# a given revision may not overlap with each other.
|
63
|
+
# Placeholder. A list of text corrections made to {::Google::Cloud::DocumentAI::V1beta3::Document#text Document.text}. This
|
64
|
+
# is usually used for annotating corrections to OCR mistakes. Text changes
|
65
|
+
# for a given revision may not overlap with each other.
|
66
66
|
# @!attribute [rw] shard_info
|
67
67
|
# @return [::Google::Cloud::DocumentAI::V1beta3::Document::ShardInfo]
|
68
68
|
# Information about the sharding if this document is sharded part of a larger
|
@@ -122,6 +122,10 @@ module Google
|
|
122
122
|
# @!attribute [rw] font_size
|
123
123
|
# @return [::Google::Cloud::DocumentAI::V1beta3::Document::Style::FontSize]
|
124
124
|
# Font size.
|
125
|
+
# @!attribute [rw] font_family
|
126
|
+
# @return [::String]
|
127
|
+
# Font family such as `Arial`, `Times New Roman`.
|
128
|
+
# https://www.w3schools.com/cssref/pr_font_font-family.asp
|
125
129
|
class Style
|
126
130
|
include ::Google::Protobuf::MessageExts
|
127
131
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -195,6 +199,9 @@ module Google
|
|
195
199
|
# @!attribute [rw] detected_barcodes
|
196
200
|
# @return [::Array<::Google::Cloud::DocumentAI::V1beta3::Document::Page::DetectedBarcode>]
|
197
201
|
# A list of detected barcodes.
|
202
|
+
# @!attribute [rw] image_quality_scores
|
203
|
+
# @return [::Google::Cloud::DocumentAI::V1beta3::Document::Page::ImageQualityScores]
|
204
|
+
# Image Quality Scores.
|
198
205
|
# @!attribute [rw] provenance
|
199
206
|
# @return [::Google::Cloud::DocumentAI::V1beta3::Document::Provenance]
|
200
207
|
# The history of this page.
|
@@ -265,7 +272,7 @@ module Google
|
|
265
272
|
# @return [::Float]
|
266
273
|
# Confidence of the current {::Google::Cloud::DocumentAI::V1beta3::Document::Page::Layout Layout} within context of the object this
|
267
274
|
# layout is for. e.g. confidence can be for a single token, a table,
|
268
|
-
# a visual element, etc. depending on context. Range [0, 1]
|
275
|
+
# a visual element, etc. depending on context. Range `[0, 1]`.
|
269
276
|
# @!attribute [rw] bounding_poly
|
270
277
|
# @return [::Google::Cloud::DocumentAI::V1beta3::BoundingPoly]
|
271
278
|
# The bounding polygon for the {::Google::Cloud::DocumentAI::V1beta3::Document::Page::Layout Layout}.
|
@@ -357,7 +364,7 @@ module Google
|
|
357
364
|
# A list of detected languages together with confidence.
|
358
365
|
# @!attribute [rw] provenance
|
359
366
|
# @return [::Google::Cloud::DocumentAI::V1beta3::Document::Provenance]
|
360
|
-
# The
|
367
|
+
# The history of this annotation.
|
361
368
|
class Token
|
362
369
|
include ::Google::Protobuf::MessageExts
|
363
370
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -428,6 +435,9 @@ module Google
|
|
428
435
|
# @!attribute [rw] detected_languages
|
429
436
|
# @return [::Array<::Google::Cloud::DocumentAI::V1beta3::Document::Page::DetectedLanguage>]
|
430
437
|
# A list of detected languages together with confidence.
|
438
|
+
# @!attribute [rw] provenance
|
439
|
+
# @return [::Google::Cloud::DocumentAI::V1beta3::Document::Provenance]
|
440
|
+
# The history of this table.
|
431
441
|
class Table
|
432
442
|
include ::Google::Protobuf::MessageExts
|
433
443
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -514,16 +524,50 @@ module Google
|
|
514
524
|
# Detected language for a structural component.
|
515
525
|
# @!attribute [rw] language_code
|
516
526
|
# @return [::String]
|
517
|
-
# The BCP-47 language code, such as
|
527
|
+
# The BCP-47 language code, such as `en-US` or `sr-Latn`. For more
|
518
528
|
# information, see
|
519
529
|
# https://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
|
520
530
|
# @!attribute [rw] confidence
|
521
531
|
# @return [::Float]
|
522
|
-
# Confidence of detected language. Range [0, 1]
|
532
|
+
# Confidence of detected language. Range `[0, 1]`.
|
523
533
|
class DetectedLanguage
|
524
534
|
include ::Google::Protobuf::MessageExts
|
525
535
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
526
536
|
end
|
537
|
+
|
538
|
+
# Image Quality Scores for the page image
|
539
|
+
# @!attribute [rw] quality_score
|
540
|
+
# @return [::Float]
|
541
|
+
# The overall quality score. Range `[0, 1]` where 1 is perfect quality.
|
542
|
+
# @!attribute [rw] detected_defects
|
543
|
+
# @return [::Array<::Google::Cloud::DocumentAI::V1beta3::Document::Page::ImageQualityScores::DetectedDefect>]
|
544
|
+
# A list of detected defects.
|
545
|
+
class ImageQualityScores
|
546
|
+
include ::Google::Protobuf::MessageExts
|
547
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
548
|
+
|
549
|
+
# Image Quality Defects
|
550
|
+
# @!attribute [rw] type
|
551
|
+
# @return [::String]
|
552
|
+
# Name of the defect type. Supported values are:
|
553
|
+
#
|
554
|
+
# - `quality/defect_blurry`
|
555
|
+
# - `quality/defect_noisy`
|
556
|
+
# - `quality/defect_dark`
|
557
|
+
# - `quality/defect_faint`
|
558
|
+
# - `quality/defect_text_too_small`
|
559
|
+
# - `quality/defect_document_cutoff`
|
560
|
+
# - `quality/defect_text_cutoff`
|
561
|
+
# - `quality/defect_glare`
|
562
|
+
# @!attribute [rw] confidence
|
563
|
+
# @return [::Float]
|
564
|
+
# Confidence of detected defect. Range `[0, 1]` where 1 indicates
|
565
|
+
# strong confidence of that the defect exists.
|
566
|
+
class DetectedDefect
|
567
|
+
include ::Google::Protobuf::MessageExts
|
568
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
569
|
+
end
|
570
|
+
end
|
527
571
|
end
|
528
572
|
|
529
573
|
# An entity that could be a phrase in the text or a property that belongs to
|
@@ -538,14 +582,13 @@ module Google
|
|
538
582
|
# Required. Entity type from a schema e.g. `Address`.
|
539
583
|
# @!attribute [rw] mention_text
|
540
584
|
# @return [::String]
|
541
|
-
# Optional. Text value
|
542
|
-
# is not present in the document, this field will be empty.
|
585
|
+
# Optional. Text value of the entity e.g. `1600 Amphitheatre Pkwy`.
|
543
586
|
# @!attribute [rw] mention_id
|
544
587
|
# @return [::String]
|
545
588
|
# Optional. Deprecated. Use `id` field instead.
|
546
589
|
# @!attribute [rw] confidence
|
547
590
|
# @return [::Float]
|
548
|
-
# Optional. Confidence of detected Schema entity. Range [0, 1]
|
591
|
+
# Optional. Confidence of detected Schema entity. Range `[0, 1]`.
|
549
592
|
# @!attribute [rw] page_anchor
|
550
593
|
# @return [::Google::Cloud::DocumentAI::V1beta3::Document::PageAnchor]
|
551
594
|
# Optional. Represents the provenance of this entity wrt. the location on the
|
@@ -610,6 +653,7 @@ module Google
|
|
610
653
|
# or int normalized text by default.
|
611
654
|
#
|
612
655
|
# Below are sample formats mapped to structured values.
|
656
|
+
#
|
613
657
|
# - Money/Currency type (`money_value`) is in the ISO 4217 text format.
|
614
658
|
# - Date type (`date_value`) is in the ISO 8601 text format.
|
615
659
|
# - Datetime type (`datetime_value`) is in the ISO 8601 text format.
|
@@ -691,7 +735,7 @@ module Google
|
|
691
735
|
# Optional. Identifies the bounding polygon of a layout element on the page.
|
692
736
|
# @!attribute [rw] confidence
|
693
737
|
# @return [::Float]
|
694
|
-
# Optional. Confidence of detected page element, if applicable. Range [0, 1]
|
738
|
+
# Optional. Confidence of detected page element, if applicable. Range `[0, 1]`.
|
695
739
|
class PageRef
|
696
740
|
include ::Google::Protobuf::MessageExts
|
697
741
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -28,7 +28,7 @@ module Google
|
|
28
28
|
# @!attribute [rw] mime_type
|
29
29
|
# @return [::String]
|
30
30
|
# An IANA MIME type (RFC6838) indicating the nature and format of the
|
31
|
-
#
|
31
|
+
# {::Google::Cloud::DocumentAI::V1beta3::RawDocument#content content}.
|
32
32
|
class RawDocument
|
33
33
|
include ::Google::Protobuf::MessageExts
|
34
34
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -67,7 +67,7 @@ module Google
|
|
67
67
|
# The common config to specify a set of documents used as input.
|
68
68
|
# @!attribute [rw] gcs_prefix
|
69
69
|
# @return [::Google::Cloud::DocumentAI::V1beta3::GcsPrefix]
|
70
|
-
# The set of documents that match the specified Cloud Storage
|
70
|
+
# The set of documents that match the specified Cloud Storage `gcs_prefix`.
|
71
71
|
# @!attribute [rw] gcs_documents
|
72
72
|
# @return [::Google::Cloud::DocumentAI::V1beta3::GcsDocuments]
|
73
73
|
# The set of documents individually specified on Cloud Storage.
|
@@ -89,6 +89,11 @@ module Google
|
|
89
89
|
# @!attribute [rw] gcs_uri
|
90
90
|
# @return [::String]
|
91
91
|
# The Cloud Storage uri (a directory) of the output.
|
92
|
+
# @!attribute [rw] field_mask
|
93
|
+
# @return [::Google::Protobuf::FieldMask]
|
94
|
+
# Specifies which fields to include in the output documents.
|
95
|
+
# Only supports top level document and pages field so it must be in the
|
96
|
+
# form of `{document_field_name}` or `pages.{page_field_name}`.
|
92
97
|
class GcsOutputConfig
|
93
98
|
include ::Google::Protobuf::MessageExts
|
94
99
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -46,6 +46,8 @@ module Google
|
|
46
46
|
# @!attribute [rw] field_mask
|
47
47
|
# @return [::Google::Protobuf::FieldMask]
|
48
48
|
# Specifies which fields to include in ProcessResponse's document.
|
49
|
+
# Only supports top level document and pages field so it must be in the form
|
50
|
+
# of `{document_field_name}` or `pages.{page_field_name}`.
|
49
51
|
class ProcessRequest
|
50
52
|
include ::Google::Protobuf::MessageExts
|
51
53
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -553,6 +555,89 @@ module Google
|
|
553
555
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
554
556
|
end
|
555
557
|
|
558
|
+
# Request message for the create processor version method.
|
559
|
+
# @!attribute [rw] parent
|
560
|
+
# @return [::String]
|
561
|
+
# Required. The parent (project, location and processor) to create the new version for.
|
562
|
+
# Format: `projects/{project}/locations/{location}/processors/{processor}`.
|
563
|
+
# @!attribute [rw] processor_version
|
564
|
+
# @return [::Google::Cloud::DocumentAI::V1beta3::ProcessorVersion]
|
565
|
+
# Required. The processor version to be created.
|
566
|
+
# @!attribute [rw] document_schema
|
567
|
+
# @return [::Google::Cloud::DocumentAI::V1beta3::DocumentSchema]
|
568
|
+
# Optional. The schema the processor version will be trained with.
|
569
|
+
# @!attribute [rw] input_data
|
570
|
+
# @return [::Google::Cloud::DocumentAI::V1beta3::TrainProcessorVersionRequest::InputData]
|
571
|
+
# Optional. The input data used to train the `ProcessorVersion`.
|
572
|
+
# @!attribute [rw] base_processor_version
|
573
|
+
# @return [::String]
|
574
|
+
# Optional. The processor version to use as a base for training. This processor version
|
575
|
+
# must be a child of `parent`. Format:
|
576
|
+
# `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processorVersion}`.
|
577
|
+
class TrainProcessorVersionRequest
|
578
|
+
include ::Google::Protobuf::MessageExts
|
579
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
580
|
+
|
581
|
+
# The input data used to train a new `ProcessorVersion`.
|
582
|
+
# @!attribute [rw] training_documents
|
583
|
+
# @return [::Google::Cloud::DocumentAI::V1beta3::BatchDocumentsInputConfig]
|
584
|
+
# The documents used for training the new version.
|
585
|
+
# @!attribute [rw] test_documents
|
586
|
+
# @return [::Google::Cloud::DocumentAI::V1beta3::BatchDocumentsInputConfig]
|
587
|
+
# The documents used for testing the trained version.
|
588
|
+
class InputData
|
589
|
+
include ::Google::Protobuf::MessageExts
|
590
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
591
|
+
end
|
592
|
+
end
|
593
|
+
|
594
|
+
# The response for the TrainProcessorVersion method.
|
595
|
+
# @!attribute [rw] processor_version
|
596
|
+
# @return [::String]
|
597
|
+
# The resource name of the processor version produced by training.
|
598
|
+
class TrainProcessorVersionResponse
|
599
|
+
include ::Google::Protobuf::MessageExts
|
600
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
601
|
+
end
|
602
|
+
|
603
|
+
# The metadata that represents a processor version being created.
|
604
|
+
# @!attribute [rw] common_metadata
|
605
|
+
# @return [::Google::Cloud::DocumentAI::V1beta3::CommonOperationMetadata]
|
606
|
+
# The basic metadata of the long running operation.
|
607
|
+
# @!attribute [rw] training_dataset_validation
|
608
|
+
# @return [::Google::Cloud::DocumentAI::V1beta3::TrainProcessorVersionMetadata::DatasetValidation]
|
609
|
+
# The training dataset validation information.
|
610
|
+
# @!attribute [rw] test_dataset_validation
|
611
|
+
# @return [::Google::Cloud::DocumentAI::V1beta3::TrainProcessorVersionMetadata::DatasetValidation]
|
612
|
+
# The test dataset validation information.
|
613
|
+
class TrainProcessorVersionMetadata
|
614
|
+
include ::Google::Protobuf::MessageExts
|
615
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
616
|
+
|
617
|
+
# The dataset validation information.
|
618
|
+
# This includes any and all errors with documents and the dataset.
|
619
|
+
# @!attribute [rw] document_error_count
|
620
|
+
# @return [::Integer]
|
621
|
+
# The total number of document errors.
|
622
|
+
# @!attribute [rw] dataset_error_count
|
623
|
+
# @return [::Integer]
|
624
|
+
# The total number of dataset errors.
|
625
|
+
# @!attribute [rw] document_errors
|
626
|
+
# @return [::Array<::Google::Rpc::Status>]
|
627
|
+
# Error information pertaining to specific documents. A maximum of 10
|
628
|
+
# document errors will be returned.
|
629
|
+
# Any document with errors will not be used throughout training.
|
630
|
+
# @!attribute [rw] dataset_errors
|
631
|
+
# @return [::Array<::Google::Rpc::Status>]
|
632
|
+
# Error information for the dataset as a whole. A maximum of 10 dataset
|
633
|
+
# errors will be returned.
|
634
|
+
# A single dataset error is terminal for training.
|
635
|
+
class DatasetValidation
|
636
|
+
include ::Google::Protobuf::MessageExts
|
637
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
638
|
+
end
|
639
|
+
end
|
640
|
+
|
556
641
|
# Request message for review document method.
|
557
642
|
# @!attribute [rw] inline_document
|
558
643
|
# @return [::Google::Cloud::DocumentAI::V1beta3::Document]
|
@@ -661,6 +746,80 @@ module Google
|
|
661
746
|
CANCELLED = 5
|
662
747
|
end
|
663
748
|
end
|
749
|
+
|
750
|
+
# Evaluates the given ProcessorVersion against the supplied documents.
|
751
|
+
# @!attribute [rw] processor_version
|
752
|
+
# @return [::String]
|
753
|
+
# Required. The resource name of the {::Google::Cloud::DocumentAI::V1beta3::ProcessorVersion ProcessorVersion} to evaluate.
|
754
|
+
# `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processorVersion}`
|
755
|
+
# @!attribute [rw] evaluation_documents
|
756
|
+
# @return [::Google::Cloud::DocumentAI::V1beta3::BatchDocumentsInputConfig]
|
757
|
+
# Optional. The documents used in the evaluation. If unspecified, use the processor's
|
758
|
+
# dataset as evaluation input.
|
759
|
+
class EvaluateProcessorVersionRequest
|
760
|
+
include ::Google::Protobuf::MessageExts
|
761
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
762
|
+
end
|
763
|
+
|
764
|
+
# Metadata of the EvaluateProcessorVersion method.
|
765
|
+
# @!attribute [rw] common_metadata
|
766
|
+
# @return [::Google::Cloud::DocumentAI::V1beta3::CommonOperationMetadata]
|
767
|
+
# The basic metadata of the long running operation.
|
768
|
+
class EvaluateProcessorVersionMetadata
|
769
|
+
include ::Google::Protobuf::MessageExts
|
770
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
771
|
+
end
|
772
|
+
|
773
|
+
# Metadata of the EvaluateProcessorVersion method.
|
774
|
+
# @!attribute [rw] evaluation
|
775
|
+
# @return [::String]
|
776
|
+
# The resource name of the created evaluation.
|
777
|
+
class EvaluateProcessorVersionResponse
|
778
|
+
include ::Google::Protobuf::MessageExts
|
779
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
780
|
+
end
|
781
|
+
|
782
|
+
# Retrieves a specific Evaluation.
|
783
|
+
# @!attribute [rw] name
|
784
|
+
# @return [::String]
|
785
|
+
# Required. The resource name of the {::Google::Cloud::DocumentAI::V1beta3::Evaluation Evaluation} to get.
|
786
|
+
# `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processorVersion}/evaluations/{evaluation}`
|
787
|
+
class GetEvaluationRequest
|
788
|
+
include ::Google::Protobuf::MessageExts
|
789
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
790
|
+
end
|
791
|
+
|
792
|
+
# Retrieves a list of evaluations for a given ProcessorVersion.
|
793
|
+
# @!attribute [rw] parent
|
794
|
+
# @return [::String]
|
795
|
+
# Required. The resource name of the {::Google::Cloud::DocumentAI::V1beta3::ProcessorVersion ProcessorVersion} to list evaluations for.
|
796
|
+
# `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processorVersion}`
|
797
|
+
# @!attribute [rw] page_size
|
798
|
+
# @return [::Integer]
|
799
|
+
# The standard list page size.
|
800
|
+
# If unspecified, at most 5 evaluations will be returned.
|
801
|
+
# The maximum value is 100; values above 100 will be coerced to 100.
|
802
|
+
# @!attribute [rw] page_token
|
803
|
+
# @return [::String]
|
804
|
+
# A page token, received from a previous `ListEvaluations` call.
|
805
|
+
# Provide this to retrieve the subsequent page.
|
806
|
+
class ListEvaluationsRequest
|
807
|
+
include ::Google::Protobuf::MessageExts
|
808
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
809
|
+
end
|
810
|
+
|
811
|
+
# The response from ListEvaluations.
|
812
|
+
# @!attribute [rw] evaluations
|
813
|
+
# @return [::Array<::Google::Cloud::DocumentAI::V1beta3::Evaluation>]
|
814
|
+
# The evaluations requested.
|
815
|
+
# @!attribute [rw] next_page_token
|
816
|
+
# @return [::String]
|
817
|
+
# A token, which can be sent as `page_token` to retrieve the next page.
|
818
|
+
# If this field is omitted, there are no subsequent pages.
|
819
|
+
class ListEvaluationsResponse
|
820
|
+
include ::Google::Protobuf::MessageExts
|
821
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
822
|
+
end
|
664
823
|
end
|
665
824
|
end
|
666
825
|
end
|
@@ -56,15 +56,16 @@ module Google
|
|
56
56
|
# Name of the type. It must be unique within the schema file and
|
57
57
|
# cannot be a 'Common Type'. Besides that we use the following naming
|
58
58
|
# conventions:
|
59
|
-
#
|
59
|
+
#
|
60
|
+
# - *use `snake_casing`*
|
60
61
|
# - name matching is case-insensitive
|
61
62
|
# - Maximum 64 characters.
|
62
63
|
# - Must start with a letter.
|
63
64
|
# - Allowed characters: ASCII letters `[a-z0-9_-]`. (For backward
|
64
65
|
# compatibility internal infrastructure and tooling can handle any ascii
|
65
66
|
# character)
|
66
|
-
# - The
|
67
|
-
# line_item/amount
|
67
|
+
# - The `/` is sometimes used to denote a property of a type. For example
|
68
|
+
# `line_item/amount`. This convention is deprecated, but will still be
|
68
69
|
# honored for backward compatibility.
|
69
70
|
# @!attribute [rw] base_types
|
70
71
|
# @return [::Array<::String>]
|
@@ -0,0 +1,181 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
# Copyright 2022 Google LLC
|
4
|
+
#
|
5
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
6
|
+
# you may not use this file except in compliance with the License.
|
7
|
+
# You may obtain a copy of the License at
|
8
|
+
#
|
9
|
+
# https://www.apache.org/licenses/LICENSE-2.0
|
10
|
+
#
|
11
|
+
# Unless required by applicable law or agreed to in writing, software
|
12
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
13
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
14
|
+
# See the License for the specific language governing permissions and
|
15
|
+
# limitations under the License.
|
16
|
+
|
17
|
+
# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
|
18
|
+
|
19
|
+
|
20
|
+
module Google
|
21
|
+
module Cloud
|
22
|
+
module DocumentAI
|
23
|
+
module V1beta3
|
24
|
+
# An evaluation of a ProcessorVersion's performance.
|
25
|
+
# @!attribute [rw] name
|
26
|
+
# @return [::String]
|
27
|
+
# The resource name of the evaluation.
|
28
|
+
# Format:
|
29
|
+
# `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processor_version}/evaluations/{evaluation}`
|
30
|
+
# @!attribute [rw] create_time
|
31
|
+
# @return [::Google::Protobuf::Timestamp]
|
32
|
+
# The time that the evaluation was created.
|
33
|
+
# @!attribute [rw] document_counters
|
34
|
+
# @return [::Google::Cloud::DocumentAI::V1beta3::Evaluation::Counters]
|
35
|
+
# Counters for the documents used in the evaluation.
|
36
|
+
# @!attribute [rw] all_entities_metrics
|
37
|
+
# @return [::Google::Cloud::DocumentAI::V1beta3::Evaluation::MultiConfidenceMetrics]
|
38
|
+
# Metrics for all the entities in aggregate.
|
39
|
+
# @!attribute [rw] entity_metrics
|
40
|
+
# @return [::Google::Protobuf::Map{::String => ::Google::Cloud::DocumentAI::V1beta3::Evaluation::MultiConfidenceMetrics}]
|
41
|
+
# Metrics across confidence levels, for different entities.
|
42
|
+
# @!attribute [rw] kms_key_name
|
43
|
+
# @return [::String]
|
44
|
+
# The KMS key name used for encryption.
|
45
|
+
# @!attribute [rw] kms_key_version_name
|
46
|
+
# @return [::String]
|
47
|
+
# The KMS key version with which data is encrypted.
|
48
|
+
class Evaluation
|
49
|
+
include ::Google::Protobuf::MessageExts
|
50
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
51
|
+
|
52
|
+
# Evaluation counters for the documents that were used.
|
53
|
+
# @!attribute [rw] input_documents_count
|
54
|
+
# @return [::Integer]
|
55
|
+
# How many documents were sent for evaluation.
|
56
|
+
# @!attribute [rw] invalid_documents_count
|
57
|
+
# @return [::Integer]
|
58
|
+
# How many documents were not included in the evaluation as they didn't
|
59
|
+
# pass validation.
|
60
|
+
# @!attribute [rw] failed_documents_count
|
61
|
+
# @return [::Integer]
|
62
|
+
# How many documents were not included in the evaluation as Document AI
|
63
|
+
# failed to process them.
|
64
|
+
# @!attribute [rw] evaluated_documents_count
|
65
|
+
# @return [::Integer]
|
66
|
+
# How many documents were used in the evaluation.
|
67
|
+
class Counters
|
68
|
+
include ::Google::Protobuf::MessageExts
|
69
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
70
|
+
end
|
71
|
+
|
72
|
+
# Evaluation metrics, either in aggregate or about a specific entity.
|
73
|
+
# @!attribute [rw] precision
|
74
|
+
# @return [::Float]
|
75
|
+
# The calculated precision.
|
76
|
+
# @!attribute [rw] recall
|
77
|
+
# @return [::Float]
|
78
|
+
# The calculated recall.
|
79
|
+
# @!attribute [rw] f1_score
|
80
|
+
# @return [::Float]
|
81
|
+
# The calculated f1 score.
|
82
|
+
# @!attribute [rw] predicted_occurrences_count
|
83
|
+
# @return [::Integer]
|
84
|
+
# The amount of occurrences in predicted documents.
|
85
|
+
# @!attribute [rw] ground_truth_occurrences_count
|
86
|
+
# @return [::Integer]
|
87
|
+
# The amount of occurrences in ground truth documents.
|
88
|
+
# @!attribute [rw] predicted_document_count
|
89
|
+
# @return [::Integer]
|
90
|
+
# The amount of documents with a predicted occurrence.
|
91
|
+
# @!attribute [rw] ground_truth_document_count
|
92
|
+
# @return [::Integer]
|
93
|
+
# The amount of documents with a ground truth occurrence.
|
94
|
+
# @!attribute [rw] true_positives_count
|
95
|
+
# @return [::Integer]
|
96
|
+
# The amount of true positives.
|
97
|
+
# @!attribute [rw] false_positives_count
|
98
|
+
# @return [::Integer]
|
99
|
+
# The amount of false positives.
|
100
|
+
# @!attribute [rw] false_negatives_count
|
101
|
+
# @return [::Integer]
|
102
|
+
# The amount of false negatives.
|
103
|
+
# @!attribute [rw] total_documents_count
|
104
|
+
# @return [::Integer]
|
105
|
+
# The amount of documents that had an occurrence of this label.
|
106
|
+
class Metrics
|
107
|
+
include ::Google::Protobuf::MessageExts
|
108
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
109
|
+
end
|
110
|
+
|
111
|
+
# Evaluations metrics, at a specific confidence level.
|
112
|
+
# @!attribute [rw] confidence_level
|
113
|
+
# @return [::Float]
|
114
|
+
# The confidence level.
|
115
|
+
# @!attribute [rw] metrics
|
116
|
+
# @return [::Google::Cloud::DocumentAI::V1beta3::Evaluation::Metrics]
|
117
|
+
# The metrics at the specific confidence level.
|
118
|
+
class ConfidenceLevelMetrics
|
119
|
+
include ::Google::Protobuf::MessageExts
|
120
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
121
|
+
end
|
122
|
+
|
123
|
+
# Metrics across multiple confidence levels.
|
124
|
+
# @!attribute [rw] confidence_level_metrics
|
125
|
+
# @return [::Array<::Google::Cloud::DocumentAI::V1beta3::Evaluation::ConfidenceLevelMetrics>]
|
126
|
+
# Metrics across confidence levels with fuzzy matching enabled.
|
127
|
+
# @!attribute [rw] confidence_level_metrics_exact
|
128
|
+
# @return [::Array<::Google::Cloud::DocumentAI::V1beta3::Evaluation::ConfidenceLevelMetrics>]
|
129
|
+
# Metrics across confidence levels with only exact matching.
|
130
|
+
# @!attribute [rw] auprc
|
131
|
+
# @return [::Float]
|
132
|
+
# The calculated area under the precision recall curve (AUPRC), computed by
|
133
|
+
# integrating over all confidence thresholds.
|
134
|
+
# @!attribute [rw] estimated_calibration_error
|
135
|
+
# @return [::Float]
|
136
|
+
# The Estimated Calibration Error (ECE) of the confidence of the predicted
|
137
|
+
# entities.
|
138
|
+
# @!attribute [rw] auprc_exact
|
139
|
+
# @return [::Float]
|
140
|
+
# The AUPRC for metrics with fuzzy matching disabled, i.e., exact matching
|
141
|
+
# only.
|
142
|
+
# @!attribute [rw] estimated_calibration_error_exact
|
143
|
+
# @return [::Float]
|
144
|
+
# The ECE for the predicted entities with fuzzy matching disabled, i.e.,
|
145
|
+
# exact matching only.
|
146
|
+
# @!attribute [rw] metrics_type
|
147
|
+
# @return [::Google::Cloud::DocumentAI::V1beta3::Evaluation::MultiConfidenceMetrics::MetricsType]
|
148
|
+
# The metrics type for the label.
|
149
|
+
class MultiConfidenceMetrics
|
150
|
+
include ::Google::Protobuf::MessageExts
|
151
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
152
|
+
|
153
|
+
# A type that determines how metrics should be interpreted.
|
154
|
+
module MetricsType
|
155
|
+
# The metrics type is unspecified. By default, metrics without a
|
156
|
+
# particular specification are for leaf entity types (i.e., top-level
|
157
|
+
# entity types without child types, or child types which are not
|
158
|
+
# parent types themselves).
|
159
|
+
METRICS_TYPE_UNSPECIFIED = 0
|
160
|
+
|
161
|
+
# Indicates whether metrics for this particular label type represent an
|
162
|
+
# aggregate of metrics for other types instead of being based on actual
|
163
|
+
# TP/FP/FN values for the label type. Metrics for parent (i.e., non-leaf)
|
164
|
+
# entity types are an aggregate of metrics for their children.
|
165
|
+
AGGREGATE = 1
|
166
|
+
end
|
167
|
+
end
|
168
|
+
|
169
|
+
# @!attribute [rw] key
|
170
|
+
# @return [::String]
|
171
|
+
# @!attribute [rw] value
|
172
|
+
# @return [::Google::Cloud::DocumentAI::V1beta3::Evaluation::MultiConfidenceMetrics]
|
173
|
+
class EntityMetricsEntry
|
174
|
+
include ::Google::Protobuf::MessageExts
|
175
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
176
|
+
end
|
177
|
+
end
|
178
|
+
end
|
179
|
+
end
|
180
|
+
end
|
181
|
+
end
|
@@ -34,6 +34,9 @@ module Google
|
|
34
34
|
# @!attribute [rw] display_name
|
35
35
|
# @return [::String]
|
36
36
|
# The display name of the processor version.
|
37
|
+
# @!attribute [rw] document_schema
|
38
|
+
# @return [::Google::Cloud::DocumentAI::V1beta3::DocumentSchema]
|
39
|
+
# The schema of the processor version. Describes the output.
|
37
40
|
# @!attribute [rw] state
|
38
41
|
# @return [::Google::Cloud::DocumentAI::V1beta3::ProcessorVersion::State]
|
39
42
|
# The state of the processor version.
|
@@ -104,7 +107,7 @@ module Google
|
|
104
107
|
# Format: `projects/{project}/locations/{location}/processors/{processor}`
|
105
108
|
# @!attribute [rw] type
|
106
109
|
# @return [::String]
|
107
|
-
# The processor type, e.g., OCR_PROCESSOR
|
110
|
+
# The processor type, e.g., `OCR_PROCESSOR`, `INVOICE_PROCESSOR`, etc.
|
108
111
|
# To get a list of processors types, see
|
109
112
|
# {::Google::Cloud::DocumentAI::V1beta3::DocumentProcessorService::Client#fetch_processor_types FetchProcessorTypes}.
|
110
113
|
# @!attribute [rw] display_name
|
@@ -143,14 +146,14 @@ module Google
|
|
143
146
|
# The processor is disabled.
|
144
147
|
DISABLED = 2
|
145
148
|
|
146
|
-
# The processor is being enabled, will become ENABLED if successful.
|
149
|
+
# The processor is being enabled, will become `ENABLED` if successful.
|
147
150
|
ENABLING = 3
|
148
151
|
|
149
|
-
# The processor is being disabled, will become DISABLED if successful.
|
152
|
+
# The processor is being disabled, will become `DISABLED` if successful.
|
150
153
|
DISABLING = 4
|
151
154
|
|
152
|
-
# The processor is being created, will become either ENABLED (for
|
153
|
-
# successful creation) or FAILED (for failed ones).
|
155
|
+
# The processor is being created, will become either `ENABLED` (for
|
156
|
+
# successful creation) or `FAILED` (for failed ones).
|
154
157
|
# Once a processor is in this state, it can then be used for document
|
155
158
|
# processing, but the feature dependencies of the processor might not be
|
156
159
|
# fully created yet.
|
@@ -26,10 +26,10 @@ module Google
|
|
26
26
|
# @!attribute [rw] name
|
27
27
|
# @return [::String]
|
28
28
|
# The resource name of the processor type.
|
29
|
-
# Format: projects
|
29
|
+
# Format: `projects/{project}/processorTypes/{processor_type}`
|
30
30
|
# @!attribute [rw] type
|
31
31
|
# @return [::String]
|
32
|
-
# The type
|
32
|
+
# The processor type, e.g., `OCR_PROCESSOR`, `INVOICE_PROCESSOR`, etc.
|
33
33
|
# @!attribute [rw] category
|
34
34
|
# @return [::String]
|
35
35
|
# The processor category, used by UI to group processor types.
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: google-cloud-document_ai-v1beta3
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.
|
4
|
+
version: 0.14.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Google LLC
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2022-
|
11
|
+
date: 2022-11-16 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: gapic-common
|
@@ -16,7 +16,7 @@ dependencies:
|
|
16
16
|
requirements:
|
17
17
|
- - ">="
|
18
18
|
- !ruby/object:Gem::Version
|
19
|
-
version: '0.
|
19
|
+
version: '0.12'
|
20
20
|
- - "<"
|
21
21
|
- !ruby/object:Gem::Version
|
22
22
|
version: 2.a
|
@@ -26,7 +26,7 @@ dependencies:
|
|
26
26
|
requirements:
|
27
27
|
- - ">="
|
28
28
|
- !ruby/object:Gem::Version
|
29
|
-
version: '0.
|
29
|
+
version: '0.12'
|
30
30
|
- - "<"
|
31
31
|
- !ruby/object:Gem::Version
|
32
32
|
version: 2.a
|
@@ -204,11 +204,13 @@ files:
|
|
204
204
|
- lib/google/cloud/documentai/v1beta3/document_processor_service_pb.rb
|
205
205
|
- lib/google/cloud/documentai/v1beta3/document_processor_service_services_pb.rb
|
206
206
|
- lib/google/cloud/documentai/v1beta3/document_schema_pb.rb
|
207
|
+
- lib/google/cloud/documentai/v1beta3/evaluation_pb.rb
|
207
208
|
- lib/google/cloud/documentai/v1beta3/geometry_pb.rb
|
208
209
|
- lib/google/cloud/documentai/v1beta3/operation_metadata_pb.rb
|
209
210
|
- lib/google/cloud/documentai/v1beta3/processor_pb.rb
|
210
211
|
- lib/google/cloud/documentai/v1beta3/processor_type_pb.rb
|
211
212
|
- proto_docs/README.md
|
213
|
+
- proto_docs/google/api/client.rb
|
212
214
|
- proto_docs/google/api/field_behavior.rb
|
213
215
|
- proto_docs/google/api/launch_stage.rb
|
214
216
|
- proto_docs/google/api/resource.rb
|
@@ -217,6 +219,7 @@ files:
|
|
217
219
|
- proto_docs/google/cloud/documentai/v1beta3/document_io.rb
|
218
220
|
- proto_docs/google/cloud/documentai/v1beta3/document_processor_service.rb
|
219
221
|
- proto_docs/google/cloud/documentai/v1beta3/document_schema.rb
|
222
|
+
- proto_docs/google/cloud/documentai/v1beta3/evaluation.rb
|
220
223
|
- proto_docs/google/cloud/documentai/v1beta3/geometry.rb
|
221
224
|
- proto_docs/google/cloud/documentai/v1beta3/operation_metadata.rb
|
222
225
|
- proto_docs/google/cloud/documentai/v1beta3/processor.rb
|