google-cloud-document_ai-v1 0.4.0 → 0.5.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,71 @@
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 V1
24
+ # Encodes the detailed information of a barcode.
25
+ # @!attribute [rw] format
26
+ # @return [::String]
27
+ # Format of a barcode.
28
+ # The supported formats are:
29
+ # CODE_128: Code 128 type.
30
+ # CODE_39: Code 39 type.
31
+ # CODE_93: Code 93 type.
32
+ # CODABAR: Codabar type.
33
+ # DATA_MATRIX: 2D Data Matrix type.
34
+ # ITF: ITF type.
35
+ # EAN_13: EAN-13 type.
36
+ # EAN_8: EAN-8 type.
37
+ # QR_CODE: 2D QR code type.
38
+ # UPC_A: UPC-A type.
39
+ # UPC_E: UPC-E type.
40
+ # PDF417: PDF417 type.
41
+ # AZTEC: 2D Aztec code type.
42
+ # DATABAR: GS1 DataBar code type.
43
+ # @!attribute [rw] value_format
44
+ # @return [::String]
45
+ # Value format describes the format of the value that a barcode
46
+ # encodes.
47
+ # The supported formats are:
48
+ # CONTACT_INFO: Contact information.
49
+ # EMAIL: Email address.
50
+ # ISBN: ISBN identifier.
51
+ # PHONE: Phone number.
52
+ # PRODUCT: Product.
53
+ # SMS: SMS message.
54
+ # TEXT: Text string.
55
+ # URL: URL address.
56
+ # WIFI: Wifi information.
57
+ # GEO: Geo-localization.
58
+ # CALENDAR_EVENT: Calendar event.
59
+ # DRIVER_LICENSE: Driver's license.
60
+ # @!attribute [rw] raw_value
61
+ # @return [::String]
62
+ # Raw value encoded in the barcode.
63
+ # For example, 'MEBKM:TITLE:Google;URL:https://www.google.com;;'.
64
+ class Barcode
65
+ include ::Google::Protobuf::MessageExts
66
+ extend ::Google::Protobuf::MessageExts::ClassMethods
67
+ end
68
+ end
69
+ end
70
+ end
71
+ end
@@ -21,11 +21,10 @@ module Google
21
21
  module Cloud
22
22
  module DocumentAI
23
23
  module V1
24
- # Document represents the canonical document resource in Document Understanding
25
- # AI.
26
- # It is an interchange format that provides insights into documents and allows
27
- # for collaboration between users and Document Understanding AI to iterate and
28
- # optimize for quality.
24
+ # Document represents the canonical document resource in Document AI. It is an
25
+ # interchange format that provides insights into documents and allows for
26
+ # collaboration between users and Document AI to iterate and optimize for
27
+ # quality.
29
28
  # @!attribute [rw] uri
30
29
  # @return [::String]
31
30
  # Optional. Currently supports Google Cloud Storage URI of the form
@@ -48,24 +47,22 @@ module Google
48
47
  # Optional. UTF-8 encoded text in reading order from the document.
49
48
  # @!attribute [rw] text_styles
50
49
  # @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Style>]
51
- # Styles for the {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
50
+ # Placeholder. Styles for the {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
52
51
  # @!attribute [rw] pages
53
52
  # @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page>]
54
53
  # Visual page layout for the {::Google::Cloud::DocumentAI::V1::Document Document}.
55
54
  # @!attribute [rw] entities
56
55
  # @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Entity>]
57
- # A list of entities detected on
58
- # {::Google::Cloud::DocumentAI::V1::Document#text Document.text}. For document
59
- # shards, entities in this list may cross shard boundaries.
56
+ # A list of entities detected on {::Google::Cloud::DocumentAI::V1::Document#text Document.text}. For document shards,
57
+ # entities in this list may cross shard boundaries.
60
58
  # @!attribute [rw] entity_relations
61
59
  # @return [::Array<::Google::Cloud::DocumentAI::V1::Document::EntityRelation>]
62
- # Relationship among
63
- # {::Google::Cloud::DocumentAI::V1::Document#entities Document.entities}.
60
+ # Placeholder. Relationship among {::Google::Cloud::DocumentAI::V1::Document#entities Document.entities}.
64
61
  # @!attribute [rw] text_changes
65
62
  # @return [::Array<::Google::Cloud::DocumentAI::V1::Document::TextChange>]
66
- # A list of text corrections made to [Document.text]. This is usually
67
- # used for annotating corrections to OCR mistakes. Text changes for a given
68
- # revision may not overlap with each other.
63
+ # Placeholder. A list of text corrections made to [Document.text]. This is
64
+ # usually used for annotating corrections to OCR mistakes. Text changes for
65
+ # a given revision may not overlap with each other.
69
66
  # @!attribute [rw] shard_info
70
67
  # @return [::Google::Cloud::DocumentAI::V1::Document::ShardInfo]
71
68
  # Information about the sharding if this document is sharded part of a larger
@@ -75,7 +72,7 @@ module Google
75
72
  # Any error that occurred while processing this document.
76
73
  # @!attribute [rw] revisions
77
74
  # @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Revision>]
78
- # Revision history of this document.
75
+ # Placeholder. Revision history of this document.
79
76
  class Document
80
77
  include ::Google::Protobuf::MessageExts
81
78
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -91,8 +88,7 @@ module Google
91
88
  # Total number of shards.
92
89
  # @!attribute [rw] text_offset
93
90
  # @return [::Integer]
94
- # The index of the first character in
95
- # {::Google::Cloud::DocumentAI::V1::Document#text Document.text} in the overall
91
+ # The index of the first character in {::Google::Cloud::DocumentAI::V1::Document#text Document.text} in the overall
96
92
  # document global text.
97
93
  class ShardInfo
98
94
  include ::Google::Protobuf::MessageExts
@@ -103,8 +99,7 @@ module Google
103
99
  # conventions as much as possible.
104
100
  # @!attribute [rw] text_anchor
105
101
  # @return [::Google::Cloud::DocumentAI::V1::Document::TextAnchor]
106
- # Text anchor indexing into the
107
- # {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
102
+ # Text anchor indexing into the {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
108
103
  # @!attribute [rw] color
109
104
  # @return [::Google::Type::Color]
110
105
  # Text color.
@@ -147,11 +142,9 @@ module Google
147
142
  # A page in a {::Google::Cloud::DocumentAI::V1::Document Document}.
148
143
  # @!attribute [rw] page_number
149
144
  # @return [::Integer]
150
- # 1-based index for current
151
- # {::Google::Cloud::DocumentAI::V1::Document::Page Page} in a parent
152
- # {::Google::Cloud::DocumentAI::V1::Document Document}. Useful when a page is
153
- # taken out of a {::Google::Cloud::DocumentAI::V1::Document Document} for
154
- # individual processing.
145
+ # 1-based index for current {::Google::Cloud::DocumentAI::V1::Document::Page Page} in a parent {::Google::Cloud::DocumentAI::V1::Document Document}.
146
+ # Useful when a page is taken out of a {::Google::Cloud::DocumentAI::V1::Document Document} for individual
147
+ # processing.
155
148
  # @!attribute [rw] image
156
149
  # @return [::Google::Cloud::DocumentAI::V1::Document::Page::Image]
157
150
  # Rendered image for this page. This image is preprocessed to remove any
@@ -199,6 +192,9 @@ module Google
199
192
  # @!attribute [rw] symbols
200
193
  # @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::Symbol>]
201
194
  # A list of visually detected symbols on the page.
195
+ # @!attribute [rw] detected_barcodes
196
+ # @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::DetectedBarcode>]
197
+ # A list of detected barcodes.
202
198
  # @!attribute [rw] provenance
203
199
  # @return [::Google::Cloud::DocumentAI::V1::Document::Provenance]
204
200
  # The history of this page.
@@ -264,23 +260,18 @@ module Google
264
260
  # Visual element describing a layout unit on a page.
265
261
  # @!attribute [rw] text_anchor
266
262
  # @return [::Google::Cloud::DocumentAI::V1::Document::TextAnchor]
267
- # Text anchor indexing into the
268
- # {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
263
+ # Text anchor indexing into the {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
269
264
  # @!attribute [rw] confidence
270
265
  # @return [::Float]
271
- # Confidence of the current
272
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} within
273
- # context of the object this layout is for. e.g. confidence can be for a
274
- # single token, a table, a visual element, etc. depending on context.
275
- # Range [0, 1].
266
+ # Confidence of the current {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} within context of the object this
267
+ # 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].
276
269
  # @!attribute [rw] bounding_poly
277
270
  # @return [::Google::Cloud::DocumentAI::V1::BoundingPoly]
278
- # The bounding polygon for the
279
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout}.
271
+ # The bounding polygon for the {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout}.
280
272
  # @!attribute [rw] orientation
281
273
  # @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout::Orientation]
282
- # Detected orientation for the
283
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout}.
274
+ # Detected orientation for the {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout}.
284
275
  class Layout
285
276
  include ::Google::Protobuf::MessageExts
286
277
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -311,8 +302,7 @@ module Google
311
302
  # common line-spacing and orientation.
312
303
  # @!attribute [rw] layout
313
304
  # @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
314
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for
315
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Block Block}.
305
+ # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for {::Google::Cloud::DocumentAI::V1::Document::Page::Block Block}.
316
306
  # @!attribute [rw] detected_languages
317
307
  # @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::DetectedLanguage>]
318
308
  # A list of detected languages together with confidence.
@@ -327,8 +317,7 @@ module Google
327
317
  # A collection of lines that a human would perceive as a paragraph.
328
318
  # @!attribute [rw] layout
329
319
  # @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
330
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for
331
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Paragraph Paragraph}.
320
+ # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for {::Google::Cloud::DocumentAI::V1::Document::Page::Paragraph Paragraph}.
332
321
  # @!attribute [rw] detected_languages
333
322
  # @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::DetectedLanguage>]
334
323
  # A list of detected languages together with confidence.
@@ -344,8 +333,7 @@ module Google
344
333
  # Does not cross column boundaries, can be horizontal, vertical, etc.
345
334
  # @!attribute [rw] layout
346
335
  # @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
347
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for
348
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Line Line}.
336
+ # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for {::Google::Cloud::DocumentAI::V1::Document::Page::Line Line}.
349
337
  # @!attribute [rw] detected_languages
350
338
  # @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::DetectedLanguage>]
351
339
  # A list of detected languages together with confidence.
@@ -360,12 +348,10 @@ module Google
360
348
  # A detected token.
361
349
  # @!attribute [rw] layout
362
350
  # @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
363
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for
364
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Token Token}.
351
+ # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for {::Google::Cloud::DocumentAI::V1::Document::Page::Token Token}.
365
352
  # @!attribute [rw] detected_break
366
353
  # @return [::Google::Cloud::DocumentAI::V1::Document::Page::Token::DetectedBreak]
367
- # Detected break at the end of a
368
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Token Token}.
354
+ # Detected break at the end of a {::Google::Cloud::DocumentAI::V1::Document::Page::Token Token}.
369
355
  # @!attribute [rw] detected_languages
370
356
  # @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::DetectedLanguage>]
371
357
  # A list of detected languages together with confidence.
@@ -376,8 +362,7 @@ module Google
376
362
  include ::Google::Protobuf::MessageExts
377
363
  extend ::Google::Protobuf::MessageExts::ClassMethods
378
364
 
379
- # Detected break at the end of a
380
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Token Token}.
365
+ # Detected break at the end of a {::Google::Cloud::DocumentAI::V1::Document::Page::Token Token}.
381
366
  # @!attribute [rw] type
382
367
  # @return [::Google::Cloud::DocumentAI::V1::Document::Page::Token::DetectedBreak::Type]
383
368
  # Detected break type.
@@ -405,8 +390,7 @@ module Google
405
390
  # A detected symbol.
406
391
  # @!attribute [rw] layout
407
392
  # @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
408
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for
409
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Symbol Symbol}.
393
+ # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for {::Google::Cloud::DocumentAI::V1::Document::Page::Symbol Symbol}.
410
394
  # @!attribute [rw] detected_languages
411
395
  # @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::DetectedLanguage>]
412
396
  # A list of detected languages together with confidence.
@@ -419,12 +403,10 @@ module Google
419
403
  # page.
420
404
  # @!attribute [rw] layout
421
405
  # @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
422
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for
423
- # {::Google::Cloud::DocumentAI::V1::Document::Page::VisualElement VisualElement}.
406
+ # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for {::Google::Cloud::DocumentAI::V1::Document::Page::VisualElement VisualElement}.
424
407
  # @!attribute [rw] type
425
408
  # @return [::String]
426
- # Type of the
427
- # {::Google::Cloud::DocumentAI::V1::Document::Page::VisualElement VisualElement}.
409
+ # Type of the {::Google::Cloud::DocumentAI::V1::Document::Page::VisualElement VisualElement}.
428
410
  # @!attribute [rw] detected_languages
429
411
  # @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::DetectedLanguage>]
430
412
  # A list of detected languages together with confidence.
@@ -436,8 +418,7 @@ module Google
436
418
  # A table representation similar to HTML table structure.
437
419
  # @!attribute [rw] layout
438
420
  # @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
439
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for
440
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Table Table}.
421
+ # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for {::Google::Cloud::DocumentAI::V1::Document::Page::Table Table}.
441
422
  # @!attribute [rw] header_rows
442
423
  # @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::Table::TableRow>]
443
424
  # Header rows of the table.
@@ -463,8 +444,7 @@ module Google
463
444
  # A cell representation inside the table.
464
445
  # @!attribute [rw] layout
465
446
  # @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
466
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for
467
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Table::TableCell TableCell}.
447
+ # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for {::Google::Cloud::DocumentAI::V1::Document::Page::Table::TableCell TableCell}.
468
448
  # @!attribute [rw] row_span
469
449
  # @return [::Integer]
470
450
  # How many rows this cell spans.
@@ -483,13 +463,11 @@ module Google
483
463
  # A form field detected on the page.
484
464
  # @!attribute [rw] field_name
485
465
  # @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
486
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for the
487
- # {::Google::Cloud::DocumentAI::V1::Document::Page::FormField FormField} name.
488
- # e.g. `Address`, `Email`, `Grand total`, `Phone number`, etc.
466
+ # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for the {::Google::Cloud::DocumentAI::V1::Document::Page::FormField FormField} name. e.g. `Address`, `Email`,
467
+ # `Grand total`, `Phone number`, etc.
489
468
  # @!attribute [rw] field_value
490
469
  # @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
491
- # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for the
492
- # {::Google::Cloud::DocumentAI::V1::Document::Page::FormField FormField} value.
470
+ # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for the {::Google::Cloud::DocumentAI::V1::Document::Page::FormField FormField} value.
493
471
  # @!attribute [rw] name_detected_languages
494
472
  # @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::DetectedLanguage>]
495
473
  # A list of detected languages for name together with confidence.
@@ -503,6 +481,16 @@ module Google
503
481
  # - blank (this indicates the field_value is normal text)
504
482
  # - "unfilled_checkbox"
505
483
  # - "filled_checkbox"
484
+ # @!attribute [rw] corrected_key_text
485
+ # @return [::String]
486
+ # Created for Labeling UI to export key text.
487
+ # If corrections were made to the text identified by the
488
+ # `field_name.text_anchor`, this field will contain the correction.
489
+ # @!attribute [rw] corrected_value_text
490
+ # @return [::String]
491
+ # Created for Labeling UI to export value text.
492
+ # If corrections were made to the text identified by the
493
+ # `field_value.text_anchor`, this field will contain the correction.
506
494
  # @!attribute [rw] provenance
507
495
  # @return [::Google::Cloud::DocumentAI::V1::Document::Provenance]
508
496
  # The history of this annotation.
@@ -511,6 +499,18 @@ module Google
511
499
  extend ::Google::Protobuf::MessageExts::ClassMethods
512
500
  end
513
501
 
502
+ # A detected barcode.
503
+ # @!attribute [rw] layout
504
+ # @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
505
+ # {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for {::Google::Cloud::DocumentAI::V1::Document::Page::DetectedBarcode DetectedBarcode}.
506
+ # @!attribute [rw] barcode
507
+ # @return [::Google::Cloud::DocumentAI::V1::Barcode]
508
+ # Detailed barcode information of the {::Google::Cloud::DocumentAI::V1::Document::Page::DetectedBarcode DetectedBarcode}.
509
+ class DetectedBarcode
510
+ include ::Google::Protobuf::MessageExts
511
+ extend ::Google::Protobuf::MessageExts::ClassMethods
512
+ end
513
+
514
514
  # Detected language for a structural component.
515
515
  # @!attribute [rw] language_code
516
516
  # @return [::String]
@@ -532,15 +532,14 @@ module Google
532
532
  # @!attribute [rw] text_anchor
533
533
  # @return [::Google::Cloud::DocumentAI::V1::Document::TextAnchor]
534
534
  # Optional. Provenance of the entity.
535
- # Text anchor indexing into the
536
- # {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
535
+ # Text anchor indexing into the {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
537
536
  # @!attribute [rw] type
538
537
  # @return [::String]
539
538
  # Required. Entity type from a schema e.g. `Address`.
540
539
  # @!attribute [rw] mention_text
541
540
  # @return [::String]
542
- # Optional. Text value in the document e.g. `1600 Amphitheatre Pkwy`. If
543
- # the entity is not present in the document, this field will be empty.
541
+ # Optional. Text value in the document e.g. `1600 Amphitheatre Pkwy`. If the entity
542
+ # is not present in the document, this field will be empty.
544
543
  # @!attribute [rw] mention_id
545
544
  # @return [::String]
546
545
  # Optional. Deprecated. Use `id` field instead.
@@ -549,29 +548,28 @@ module Google
549
548
  # Optional. Confidence of detected Schema entity. Range [0, 1].
550
549
  # @!attribute [rw] page_anchor
551
550
  # @return [::Google::Cloud::DocumentAI::V1::Document::PageAnchor]
552
- # Optional. Represents the provenance of this entity wrt. the location on
553
- # the page where it was found.
551
+ # Optional. Represents the provenance of this entity wrt. the location on the
552
+ # page where it was found.
554
553
  # @!attribute [rw] id
555
554
  # @return [::String]
556
555
  # Optional. Canonical id. This will be a unique value in the entity list
557
556
  # for this document.
558
557
  # @!attribute [rw] normalized_value
559
558
  # @return [::Google::Cloud::DocumentAI::V1::Document::Entity::NormalizedValue]
560
- # Optional. Normalized entity value. Absent if the extracted value could
561
- # not be converted or the type (e.g. address) is not supported for certain
559
+ # Optional. Normalized entity value. Absent if the extracted value could not be
560
+ # converted or the type (e.g. address) is not supported for certain
562
561
  # parsers. This field is also only populated for certain supported document
563
562
  # types.
564
563
  # @!attribute [rw] properties
565
564
  # @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Entity>]
566
- # Optional. Entities can be nested to form a hierarchical data structure
567
- # representing the content in the document.
565
+ # Optional. Entities can be nested to form a hierarchical data structure representing
566
+ # the content in the document.
568
567
  # @!attribute [rw] provenance
569
568
  # @return [::Google::Cloud::DocumentAI::V1::Document::Provenance]
570
569
  # Optional. The history of this annotation.
571
570
  # @!attribute [rw] redacted
572
571
  # @return [::Boolean]
573
- # Optional. Whether the entity will be redacted for de-identification
574
- # purposes.
572
+ # Optional. Whether the entity will be redacted for de-identification purposes.
575
573
  class Entity
576
574
  include ::Google::Protobuf::MessageExts
577
575
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -597,6 +595,12 @@ module Google
597
595
  # @return [::Boolean]
598
596
  # Boolean value. Can be used for entities with binary values, or for
599
597
  # checkboxes.
598
+ # @!attribute [rw] integer_value
599
+ # @return [::Integer]
600
+ # Integer value.
601
+ # @!attribute [rw] float_value
602
+ # @return [::Float]
603
+ # Float value.
600
604
  # @!attribute [rw] text
601
605
  # @return [::String]
602
606
  # Optional. An optional field to store a normalized string.
@@ -615,8 +619,7 @@ module Google
615
619
  end
616
620
  end
617
621
 
618
- # Relationship between
619
- # {::Google::Cloud::DocumentAI::V1::Document::Entity Entities}.
622
+ # Relationship between {::Google::Cloud::DocumentAI::V1::Document::Entity Entities}.
620
623
  # @!attribute [rw] subject_id
621
624
  # @return [::String]
622
625
  # Subject entity id.
@@ -631,12 +634,10 @@ module Google
631
634
  extend ::Google::Protobuf::MessageExts::ClassMethods
632
635
  end
633
636
 
634
- # Text reference indexing into the
635
- # {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
637
+ # Text reference indexing into the {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
636
638
  # @!attribute [rw] text_segments
637
639
  # @return [::Array<::Google::Cloud::DocumentAI::V1::Document::TextAnchor::TextSegment>]
638
- # The text segments from the
639
- # {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
640
+ # The text segments from the {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
640
641
  # @!attribute [rw] content
641
642
  # @return [::String]
642
643
  # Contains the content of the text span so that users do
@@ -646,20 +647,15 @@ module Google
646
647
  include ::Google::Protobuf::MessageExts
647
648
  extend ::Google::Protobuf::MessageExts::ClassMethods
648
649
 
649
- # A text segment in the
650
- # {::Google::Cloud::DocumentAI::V1::Document#text Document.text}. The indices
651
- # may be out of bounds which indicate that the text extends into another
652
- # document shard for large sharded documents. See
653
- # {::Google::Cloud::DocumentAI::V1::Document::ShardInfo#text_offset ShardInfo.text_offset}
650
+ # A text segment in the {::Google::Cloud::DocumentAI::V1::Document#text Document.text}. The indices may be out of bounds
651
+ # which indicate that the text extends into another document shard for
652
+ # large sharded documents. See {::Google::Cloud::DocumentAI::V1::Document::ShardInfo#text_offset ShardInfo.text_offset}
654
653
  # @!attribute [rw] start_index
655
654
  # @return [::Integer]
656
- # {::Google::Cloud::DocumentAI::V1::Document::TextAnchor::TextSegment TextSegment}
657
- # start UTF-8 char index in the
658
- # {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
655
+ # {::Google::Cloud::DocumentAI::V1::Document::TextAnchor::TextSegment TextSegment} start UTF-8 char index in the {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
659
656
  # @!attribute [rw] end_index
660
657
  # @return [::Integer]
661
- # {::Google::Cloud::DocumentAI::V1::Document::TextAnchor::TextSegment TextSegment}
662
- # half open end UTF-8 char index in the
658
+ # {::Google::Cloud::DocumentAI::V1::Document::TextAnchor::TextSegment TextSegment} half open end UTF-8 char index in the
663
659
  # {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
664
660
  class TextSegment
665
661
  include ::Google::Protobuf::MessageExts
@@ -667,10 +663,9 @@ module Google
667
663
  end
668
664
  end
669
665
 
670
- # Referencing the visual context of the entity in the
671
- # {::Google::Cloud::DocumentAI::V1::Document#pages Document.pages}. Page anchors
672
- # can be cross-page, consist of multiple bounding polygons and optionally
673
- # reference specific layout element types.
666
+ # Referencing the visual context of the entity in the {::Google::Cloud::DocumentAI::V1::Document#pages Document.pages}.
667
+ # Page anchors can be cross-page, consist of multiple bounding polygons and
668
+ # optionally reference specific layout element types.
674
669
  # @!attribute [rw] page_refs
675
670
  # @return [::Array<::Google::Cloud::DocumentAI::V1::Document::PageAnchor::PageRef>]
676
671
  # One or more references to visual page elements
@@ -681,29 +676,22 @@ module Google
681
676
  # Represents a weak reference to a page element within a document.
682
677
  # @!attribute [rw] page
683
678
  # @return [::Integer]
684
- # Required. Index into the
685
- # {::Google::Cloud::DocumentAI::V1::Document#pages Document.pages} element,
686
- # for example using [Document.pages][page_refs.page] to locate the
687
- # related page element. This field is skipped when its value is the
688
- # default 0. See
679
+ # Required. Index into the {::Google::Cloud::DocumentAI::V1::Document#pages Document.pages} element, for example using
680
+ # [Document.pages][page_refs.page] to locate the related page element.
681
+ # This field is skipped when its value is the default 0. See
689
682
  # https://developers.google.com/protocol-buffers/docs/proto3#json.
690
683
  # @!attribute [rw] layout_type
691
684
  # @return [::Google::Cloud::DocumentAI::V1::Document::PageAnchor::PageRef::LayoutType]
692
- # Optional. The type of the layout element that is being referenced if
693
- # any.
685
+ # Optional. The type of the layout element that is being referenced if any.
694
686
  # @!attribute [rw] layout_id
695
687
  # @return [::String]
696
- # Optional. Deprecated. Use
697
- # {::Google::Cloud::DocumentAI::V1::Document::PageAnchor::PageRef#bounding_poly PageRef.bounding_poly}
698
- # instead.
688
+ # Optional. Deprecated. Use {::Google::Cloud::DocumentAI::V1::Document::PageAnchor::PageRef#bounding_poly PageRef.bounding_poly} instead.
699
689
  # @!attribute [rw] bounding_poly
700
690
  # @return [::Google::Cloud::DocumentAI::V1::BoundingPoly]
701
- # Optional. Identifies the bounding polygon of a layout element on the
702
- # page.
691
+ # Optional. Identifies the bounding polygon of a layout element on the page.
703
692
  # @!attribute [rw] confidence
704
693
  # @return [::Float]
705
- # Optional. Confidence of detected page element, if applicable. Range [0,
706
- # 1].
694
+ # Optional. Confidence of detected page element, if applicable. Range [0, 1].
707
695
  class PageRef
708
696
  include ::Google::Protobuf::MessageExts
709
697
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -713,38 +701,25 @@ module Google
713
701
  # Layout Unspecified.
714
702
  LAYOUT_TYPE_UNSPECIFIED = 0
715
703
 
716
- # References a
717
- # {::Google::Cloud::DocumentAI::V1::Document::Page#blocks Page.blocks}
718
- # element.
704
+ # References a {::Google::Cloud::DocumentAI::V1::Document::Page#blocks Page.blocks} element.
719
705
  BLOCK = 1
720
706
 
721
- # References a
722
- # {::Google::Cloud::DocumentAI::V1::Document::Page#paragraphs Page.paragraphs}
723
- # element.
707
+ # References a {::Google::Cloud::DocumentAI::V1::Document::Page#paragraphs Page.paragraphs} element.
724
708
  PARAGRAPH = 2
725
709
 
726
- # References a
727
- # {::Google::Cloud::DocumentAI::V1::Document::Page#lines Page.lines} element.
710
+ # References a {::Google::Cloud::DocumentAI::V1::Document::Page#lines Page.lines} element.
728
711
  LINE = 3
729
712
 
730
- # References a
731
- # {::Google::Cloud::DocumentAI::V1::Document::Page#tokens Page.tokens}
732
- # element.
713
+ # References a {::Google::Cloud::DocumentAI::V1::Document::Page#tokens Page.tokens} element.
733
714
  TOKEN = 4
734
715
 
735
- # References a
736
- # {::Google::Cloud::DocumentAI::V1::Document::Page#visual_elements Page.visual_elements}
737
- # element.
716
+ # References a {::Google::Cloud::DocumentAI::V1::Document::Page#visual_elements Page.visual_elements} element.
738
717
  VISUAL_ELEMENT = 5
739
718
 
740
- # Refrrences a
741
- # {::Google::Cloud::DocumentAI::V1::Document::Page#tables Page.tables}
742
- # element.
719
+ # Refrrences a {::Google::Cloud::DocumentAI::V1::Document::Page#tables Page.tables} element.
743
720
  TABLE = 6
744
721
 
745
- # References a
746
- # {::Google::Cloud::DocumentAI::V1::Document::Page#form_fields Page.form_fields}
747
- # element.
722
+ # References a {::Google::Cloud::DocumentAI::V1::Document::Page#form_fields Page.form_fields} element.
748
723
  FORM_FIELD = 7
749
724
  end
750
725
  end
@@ -830,6 +805,11 @@ module Google
830
805
  # The revisions that this revision is based on. This can include one or
831
806
  # more parent (when documents are merged.) This field represents the
832
807
  # index into the `revisions` field.
808
+ # @!attribute [rw] parent_ids
809
+ # @return [::Array<::String>]
810
+ # The revisions that this revision is based on. Must include all the ids
811
+ # that have anything to do with this revision - eg. there are
812
+ # `provenance.parent.revision` fields that index into this field.
833
813
  # @!attribute [rw] create_time
834
814
  # @return [::Google::Protobuf::Timestamp]
835
815
  # The time that the revision was created.
@@ -858,9 +838,8 @@ module Google
858
838
  # @!attribute [rw] text_anchor
859
839
  # @return [::Google::Cloud::DocumentAI::V1::Document::TextAnchor]
860
840
  # Provenance of the correction.
861
- # Text anchor indexing into the
862
- # {::Google::Cloud::DocumentAI::V1::Document#text Document.text}. There can
863
- # only be a single `TextAnchor.text_segments` element. If the start and
841
+ # Text anchor indexing into the {::Google::Cloud::DocumentAI::V1::Document#text Document.text}. There can only be a
842
+ # single `TextAnchor.text_segments` element. If the start and
864
843
  # end index of the text segment are the same, the text change is inserted
865
844
  # before that index.
866
845
  # @!attribute [rw] changed_text