blob: 80265fbbf3123ce0c7d829888b7ea3e6873efe18 [file] [log] [blame]
Bu Sun Kim673ec5c2020-11-16 11:05:03 -07001<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="datalabeling_v1beta1.html">Data Labeling API</a> . <a href="datalabeling_v1beta1.projects.html">projects</a> . <a href="datalabeling_v1beta1.projects.datasets.html">datasets</a> . <a href="datalabeling_v1beta1.projects.datasets.evaluations.html">evaluations</a> . <a href="datalabeling_v1beta1.projects.datasets.evaluations.exampleComparisons.html">exampleComparisons</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#close">close()</a></code></p>
79<p class="firstline">Close httplib2 connections.</p>
80<p class="toc_element">
81 <code><a href="#search">search(parent, body=None, x__xgafv=None)</a></code></p>
82<p class="firstline">Searches example comparisons from an evaluation. The return format is a list of example comparisons that show ground truth and prediction(s) for a single input. Search by providing an evaluation ID.</p>
83<p class="toc_element">
84 <code><a href="#search_next">search_next(previous_request, previous_response)</a></code></p>
85<p class="firstline">Retrieves the next page of results.</p>
86<h3>Method Details</h3>
87<div class="method">
88 <code class="details" id="close">close()</code>
89 <pre>Close httplib2 connections.</pre>
90</div>
91
92<div class="method">
93 <code class="details" id="search">search(parent, body=None, x__xgafv=None)</code>
94 <pre>Searches example comparisons from an evaluation. The return format is a list of example comparisons that show ground truth and prediction(s) for a single input. Search by providing an evaluation ID.
95
96Args:
97 parent: string, Required. Name of the Evaluation resource to search for example comparisons from. Format: &quot;projects/{project_id}/datasets/{dataset_id}/evaluations/ {evaluation_id}&quot; (required)
98 body: object, The request body.
99 The object takes the form of:
100
101{ # Request message of SearchExampleComparisons.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800102 &quot;pageToken&quot;: &quot;A String&quot;, # Optional. A token identifying a page of results for the server to return. Typically obtained by the nextPageToken of the response to a previous search rquest. If you don&#x27;t specify this field, the API call requests the first page of the search.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800103 &quot;pageSize&quot;: 42, # Optional. Requested page size. Server may return fewer results than requested. Default value is 100.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700104 }
105
106 x__xgafv: string, V1 error format.
107 Allowed values
108 1 - v1 error format
109 2 - v2 error format
110
111Returns:
112 An object of the form:
113
114 { # Results of searching example comparisons.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700115 &quot;exampleComparisons&quot;: [ # A list of example comparisons matching the search criteria.
116 { # Example comparisons comparing ground truth output and predictions for a specific input.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700117 &quot;modelCreatedExamples&quot;: [ # Predictions by the model for the input.
118 { # An Example is a piece of data and its annotation. For example, an image with label &quot;house&quot;.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800119 &quot;name&quot;: &quot;A String&quot;, # Output only. Name of the example, in format of: projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/ {annotated_dataset_id}/examples/{example_id}
120 &quot;textPayload&quot;: { # Container of information about a piece of text. # The text payload, a container of the text content.
121 &quot;textContent&quot;: &quot;A String&quot;, # Text content.
122 },
123 &quot;imagePayload&quot;: { # Container of information about an image. # The image payload, a container of the image bytes/uri.
124 &quot;imageThumbnail&quot;: &quot;A String&quot;, # A byte string of a thumbnail image.
125 &quot;mimeType&quot;: &quot;A String&quot;, # Image format.
126 &quot;imageUri&quot;: &quot;A String&quot;, # Image uri from the user bucket.
127 &quot;signedUri&quot;: &quot;A String&quot;, # Signed uri of the image file in the service bucket.
128 },
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700129 &quot;annotations&quot;: [ # Output only. Annotations for the piece of data in Example. One piece of data can have multiple annotations.
130 { # Annotation for Example. Each example may have one or more annotations. For example in image classification problem, each image might have one or more labels. We call labels binded with this image an Annotation.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800131 &quot;annotationMetadata&quot;: { # Additional information associated with the annotation. # Output only. Annotation metadata, including information like votes for labels.
132 &quot;operatorMetadata&quot;: { # General information useful for labels coming from contributors. # Metadata related to human labeling.
133 &quot;comments&quot;: [ # Comments from contributors.
134 &quot;A String&quot;,
135 ],
136 &quot;totalVotes&quot;: 42, # The total number of contributors that answer this question.
137 &quot;score&quot;: 3.14, # Confidence score corresponding to a label. For examle, if 3 contributors have answered the question and 2 of them agree on the final label, the confidence score will be 0.67 (2/3).
138 &quot;labelVotes&quot;: 42, # The total number of contributors that choose this label.
139 },
140 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800141 &quot;name&quot;: &quot;A String&quot;, # Output only. Unique name of this annotation, format is: projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/{annotated_dataset}/examples/{example_id}/annotations/{annotation_id}
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800142 &quot;annotationSource&quot;: &quot;A String&quot;, # Output only. The source of the annotation.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800143 &quot;annotationSentiment&quot;: &quot;A String&quot;, # Output only. Sentiment for this annotation.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700144 &quot;annotationValue&quot;: { # Annotation value for an example. # Output only. This is the actual annotation value, e.g classification, bounding box values are stored here.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800145 &quot;videoEventAnnotation&quot;: { # Video event annotation. # Annotation value for video event case.
146 &quot;annotationSpec&quot;: { # Container of information related to one possible annotation that can be used in a labeling task. For example, an image classification task where images are labeled as `dog` or `cat` must reference an AnnotationSpec for `dog` and an AnnotationSpec for `cat`. # Label of the event in this annotation.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800147 &quot;index&quot;: 42, # Output only. This is the integer index of the AnnotationSpec. The index for the whole AnnotationSpecSet is sequential starting from 0. For example, an AnnotationSpecSet with classes `dog` and `cat`, might contain one AnnotationSpec with `{ display_name: &quot;dog&quot;, index: 0 }` and one AnnotationSpec with `{ display_name: &quot;cat&quot;, index: 1 }`. This is especially useful for model training as it encodes the string labels into numeric values.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800148 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the AnnotationSpec. Maximum of 64 characters.
149 &quot;description&quot;: &quot;A String&quot;, # Optional. User-provided description of the annotation specification. The description can be up to 10,000 characters long.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800150 },
151 &quot;timeSegment&quot;: { # A time period inside of an example that has a time dimension (e.g. video). # The time segment of the video to which the annotation applies.
152 &quot;endTimeOffset&quot;: &quot;A String&quot;, # End of the time segment (exclusive), represented as the duration since the example start.
153 &quot;startTimeOffset&quot;: &quot;A String&quot;, # Start of the time segment (inclusive), represented as the duration since the example start.
154 },
155 },
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800156 &quot;imageBoundingPolyAnnotation&quot;: { # Image bounding poly annotation. It represents a polygon including bounding box in the image. # Annotation value for image bounding box, oriented bounding box and polygon cases.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800157 &quot;annotationSpec&quot;: { # Container of information related to one possible annotation that can be used in a labeling task. For example, an image classification task where images are labeled as `dog` or `cat` must reference an AnnotationSpec for `dog` and an AnnotationSpec for `cat`. # Label of object in this bounding polygon.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800158 &quot;index&quot;: 42, # Output only. This is the integer index of the AnnotationSpec. The index for the whole AnnotationSpecSet is sequential starting from 0. For example, an AnnotationSpecSet with classes `dog` and `cat`, might contain one AnnotationSpec with `{ display_name: &quot;dog&quot;, index: 0 }` and one AnnotationSpec with `{ display_name: &quot;cat&quot;, index: 1 }`. This is especially useful for model training as it encodes the string labels into numeric values.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800159 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the AnnotationSpec. Maximum of 64 characters.
160 &quot;description&quot;: &quot;A String&quot;, # Optional. User-provided description of the annotation specification. The description can be up to 10,000 characters long.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800161 },
162 &quot;normalizedBoundingPoly&quot;: { # Normalized bounding polygon.
163 &quot;normalizedVertices&quot;: [ # The bounding polygon normalized vertices.
164 { # A vertex represents a 2D point in the image. NOTE: the normalized vertex coordinates are relative to the original image and range from 0 to 1.
165 &quot;x&quot;: 3.14, # X coordinate.
166 &quot;y&quot;: 3.14, # Y coordinate.
167 },
168 ],
169 },
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800170 &quot;boundingPoly&quot;: { # A bounding polygon in the image.
171 &quot;vertices&quot;: [ # The bounding polygon vertices.
172 { # A vertex represents a 2D point in the image. NOTE: the vertex coordinates are in the same scale as the original image.
173 &quot;y&quot;: 42, # Y coordinate.
174 &quot;x&quot;: 42, # X coordinate.
175 },
176 ],
177 },
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800178 },
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800179 &quot;textClassificationAnnotation&quot;: { # Text classification annotation. # Annotation value for text classification case.
180 &quot;annotationSpec&quot;: { # Container of information related to one possible annotation that can be used in a labeling task. For example, an image classification task where images are labeled as `dog` or `cat` must reference an AnnotationSpec for `dog` and an AnnotationSpec for `cat`. # Label of the text.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700181 &quot;index&quot;: 42, # Output only. This is the integer index of the AnnotationSpec. The index for the whole AnnotationSpecSet is sequential starting from 0. For example, an AnnotationSpecSet with classes `dog` and `cat`, might contain one AnnotationSpec with `{ display_name: &quot;dog&quot;, index: 0 }` and one AnnotationSpec with `{ display_name: &quot;cat&quot;, index: 1 }`. This is especially useful for model training as it encodes the string labels into numeric values.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800182 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the AnnotationSpec. Maximum of 64 characters.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800183 &quot;description&quot;: &quot;A String&quot;, # Optional. User-provided description of the annotation specification. The description can be up to 10,000 characters long.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800184 },
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800185 },
186 &quot;videoObjectTrackingAnnotation&quot;: { # Video object tracking annotation. # Annotation value for video object detection and tracking case.
187 &quot;objectTrackingFrames&quot;: [ # The list of frames where this object track appears.
188 { # Video frame level annotation for object detection and tracking.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800189 &quot;timeOffset&quot;: &quot;A String&quot;, # The time offset of this frame relative to the beginning of the video.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800190 &quot;normalizedBoundingPoly&quot;: { # Normalized bounding polygon.
191 &quot;normalizedVertices&quot;: [ # The bounding polygon normalized vertices.
192 { # A vertex represents a 2D point in the image. NOTE: the normalized vertex coordinates are relative to the original image and range from 0 to 1.
193 &quot;x&quot;: 3.14, # X coordinate.
194 &quot;y&quot;: 3.14, # Y coordinate.
195 },
196 ],
197 },
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800198 &quot;boundingPoly&quot;: { # A bounding polygon in the image.
199 &quot;vertices&quot;: [ # The bounding polygon vertices.
200 { # A vertex represents a 2D point in the image. NOTE: the vertex coordinates are in the same scale as the original image.
201 &quot;y&quot;: 42, # Y coordinate.
202 &quot;x&quot;: 42, # X coordinate.
203 },
204 ],
205 },
206 },
207 ],
208 &quot;timeSegment&quot;: { # A time period inside of an example that has a time dimension (e.g. video). # The time segment of the video to which object tracking applies.
209 &quot;endTimeOffset&quot;: &quot;A String&quot;, # End of the time segment (exclusive), represented as the duration since the example start.
210 &quot;startTimeOffset&quot;: &quot;A String&quot;, # Start of the time segment (inclusive), represented as the duration since the example start.
211 },
212 &quot;annotationSpec&quot;: { # Container of information related to one possible annotation that can be used in a labeling task. For example, an image classification task where images are labeled as `dog` or `cat` must reference an AnnotationSpec for `dog` and an AnnotationSpec for `cat`. # Label of the object tracked in this annotation.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800213 &quot;index&quot;: 42, # Output only. This is the integer index of the AnnotationSpec. The index for the whole AnnotationSpecSet is sequential starting from 0. For example, an AnnotationSpecSet with classes `dog` and `cat`, might contain one AnnotationSpec with `{ display_name: &quot;dog&quot;, index: 0 }` and one AnnotationSpec with `{ display_name: &quot;cat&quot;, index: 1 }`. This is especially useful for model training as it encodes the string labels into numeric values.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800214 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the AnnotationSpec. Maximum of 64 characters.
215 &quot;description&quot;: &quot;A String&quot;, # Optional. User-provided description of the annotation specification. The description can be up to 10,000 characters long.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700216 },
217 },
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800218 &quot;textEntityExtractionAnnotation&quot;: { # Text entity extraction annotation. # Annotation value for text entity extraction case.
219 &quot;annotationSpec&quot;: { # Container of information related to one possible annotation that can be used in a labeling task. For example, an image classification task where images are labeled as `dog` or `cat` must reference an AnnotationSpec for `dog` and an AnnotationSpec for `cat`. # Label of the text entities.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700220 &quot;index&quot;: 42, # Output only. This is the integer index of the AnnotationSpec. The index for the whole AnnotationSpecSet is sequential starting from 0. For example, an AnnotationSpecSet with classes `dog` and `cat`, might contain one AnnotationSpec with `{ display_name: &quot;dog&quot;, index: 0 }` and one AnnotationSpec with `{ display_name: &quot;cat&quot;, index: 1 }`. This is especially useful for model training as it encodes the string labels into numeric values.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800221 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the AnnotationSpec. Maximum of 64 characters.
222 &quot;description&quot;: &quot;A String&quot;, # Optional. User-provided description of the annotation specification. The description can be up to 10,000 characters long.
223 },
224 &quot;sequentialSegment&quot;: { # Start and end position in a sequence (e.g. text segment). # Position of the entity.
225 &quot;start&quot;: 42, # Start position (inclusive).
226 &quot;end&quot;: 42, # End position (exclusive).
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700227 },
228 },
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800229 &quot;imageSegmentationAnnotation&quot;: { # Image segmentation annotation. # Annotation value for image segmentation.
230 &quot;mimeType&quot;: &quot;A String&quot;, # Image format.
231 &quot;imageBytes&quot;: &quot;A String&quot;, # A byte string of a full image&#x27;s color map.
232 &quot;annotationColors&quot;: { # The mapping between rgb color and annotation spec. The key is the rgb color represented in format of rgb(0, 0, 0). The value is the AnnotationSpec.
233 &quot;a_key&quot;: { # Container of information related to one possible annotation that can be used in a labeling task. For example, an image classification task where images are labeled as `dog` or `cat` must reference an AnnotationSpec for `dog` and an AnnotationSpec for `cat`.
234 &quot;index&quot;: 42, # Output only. This is the integer index of the AnnotationSpec. The index for the whole AnnotationSpecSet is sequential starting from 0. For example, an AnnotationSpecSet with classes `dog` and `cat`, might contain one AnnotationSpec with `{ display_name: &quot;dog&quot;, index: 0 }` and one AnnotationSpec with `{ display_name: &quot;cat&quot;, index: 1 }`. This is especially useful for model training as it encodes the string labels into numeric values.
235 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the AnnotationSpec. Maximum of 64 characters.
236 &quot;description&quot;: &quot;A String&quot;, # Optional. User-provided description of the annotation specification. The description can be up to 10,000 characters long.
237 },
238 },
239 },
240 &quot;imagePolylineAnnotation&quot;: { # A polyline for the image annotation. # Annotation value for image polyline cases. Polyline here is different from BoundingPoly. It is formed by line segments connected to each other but not closed form(Bounding Poly). The line segments can cross each other.
241 &quot;polyline&quot;: { # A line with multiple line segments.
242 &quot;vertices&quot;: [ # The polyline vertices.
243 { # A vertex represents a 2D point in the image. NOTE: the vertex coordinates are in the same scale as the original image.
244 &quot;y&quot;: 42, # Y coordinate.
245 &quot;x&quot;: 42, # X coordinate.
246 },
247 ],
248 },
249 &quot;annotationSpec&quot;: { # Container of information related to one possible annotation that can be used in a labeling task. For example, an image classification task where images are labeled as `dog` or `cat` must reference an AnnotationSpec for `dog` and an AnnotationSpec for `cat`. # Label of this polyline.
250 &quot;index&quot;: 42, # Output only. This is the integer index of the AnnotationSpec. The index for the whole AnnotationSpecSet is sequential starting from 0. For example, an AnnotationSpecSet with classes `dog` and `cat`, might contain one AnnotationSpec with `{ display_name: &quot;dog&quot;, index: 0 }` and one AnnotationSpec with `{ display_name: &quot;cat&quot;, index: 1 }`. This is especially useful for model training as it encodes the string labels into numeric values.
251 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the AnnotationSpec. Maximum of 64 characters.
252 &quot;description&quot;: &quot;A String&quot;, # Optional. User-provided description of the annotation specification. The description can be up to 10,000 characters long.
253 },
254 &quot;normalizedPolyline&quot;: { # Normalized polyline.
255 &quot;normalizedVertices&quot;: [ # The normalized polyline vertices.
256 { # A vertex represents a 2D point in the image. NOTE: the normalized vertex coordinates are relative to the original image and range from 0 to 1.
257 &quot;x&quot;: 3.14, # X coordinate.
258 &quot;y&quot;: 3.14, # Y coordinate.
259 },
260 ],
261 },
262 },
263 &quot;imageClassificationAnnotation&quot;: { # Image classification annotation definition. # Annotation value for image classification case.
264 &quot;annotationSpec&quot;: { # Container of information related to one possible annotation that can be used in a labeling task. For example, an image classification task where images are labeled as `dog` or `cat` must reference an AnnotationSpec for `dog` and an AnnotationSpec for `cat`. # Label of image.
265 &quot;index&quot;: 42, # Output only. This is the integer index of the AnnotationSpec. The index for the whole AnnotationSpecSet is sequential starting from 0. For example, an AnnotationSpecSet with classes `dog` and `cat`, might contain one AnnotationSpec with `{ display_name: &quot;dog&quot;, index: 0 }` and one AnnotationSpec with `{ display_name: &quot;cat&quot;, index: 1 }`. This is especially useful for model training as it encodes the string labels into numeric values.
266 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the AnnotationSpec. Maximum of 64 characters.
267 &quot;description&quot;: &quot;A String&quot;, # Optional. User-provided description of the annotation specification. The description can be up to 10,000 characters long.
268 },
269 },
270 &quot;videoClassificationAnnotation&quot;: { # Video classification annotation. # Annotation value for video classification case.
271 &quot;timeSegment&quot;: { # A time period inside of an example that has a time dimension (e.g. video). # The time segment of the video to which the annotation applies.
272 &quot;endTimeOffset&quot;: &quot;A String&quot;, # End of the time segment (exclusive), represented as the duration since the example start.
273 &quot;startTimeOffset&quot;: &quot;A String&quot;, # Start of the time segment (inclusive), represented as the duration since the example start.
274 },
275 &quot;annotationSpec&quot;: { # Container of information related to one possible annotation that can be used in a labeling task. For example, an image classification task where images are labeled as `dog` or `cat` must reference an AnnotationSpec for `dog` and an AnnotationSpec for `cat`. # Label of the segment specified by time_segment.
276 &quot;index&quot;: 42, # Output only. This is the integer index of the AnnotationSpec. The index for the whole AnnotationSpecSet is sequential starting from 0. For example, an AnnotationSpecSet with classes `dog` and `cat`, might contain one AnnotationSpec with `{ display_name: &quot;dog&quot;, index: 0 }` and one AnnotationSpec with `{ display_name: &quot;cat&quot;, index: 1 }`. This is especially useful for model training as it encodes the string labels into numeric values.
277 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the AnnotationSpec. Maximum of 64 characters.
278 &quot;description&quot;: &quot;A String&quot;, # Optional. User-provided description of the annotation specification. The description can be up to 10,000 characters long.
279 },
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700280 },
281 },
282 },
283 ],
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700284 &quot;videoPayload&quot;: { # Container of information of a video. # The video payload, a container of the video uri.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800285 &quot;mimeType&quot;: &quot;A String&quot;, # Video format.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800286 &quot;signedUri&quot;: &quot;A String&quot;, # Signed uri of the video file in the service bucket.
287 &quot;videoUri&quot;: &quot;A String&quot;, # Video uri from the user bucket.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700288 &quot;videoThumbnails&quot;: [ # The list of video thumbnails.
289 { # Container of information of a video thumbnail.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700290 &quot;thumbnail&quot;: &quot;A String&quot;, # A byte string of the video frame.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800291 &quot;timeOffset&quot;: &quot;A String&quot;, # Time offset relative to the beginning of the video, corresponding to the video frame where the thumbnail has been extracted from.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700292 },
293 ],
294 &quot;frameRate&quot;: 3.14, # FPS of the video.
295 },
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700296 },
297 ],
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800298 &quot;groundTruthExample&quot;: { # An Example is a piece of data and its annotation. For example, an image with label &quot;house&quot;. # The ground truth output for the input.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800299 &quot;name&quot;: &quot;A String&quot;, # Output only. Name of the example, in format of: projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/ {annotated_dataset_id}/examples/{example_id}
300 &quot;textPayload&quot;: { # Container of information about a piece of text. # The text payload, a container of the text content.
301 &quot;textContent&quot;: &quot;A String&quot;, # Text content.
302 },
303 &quot;imagePayload&quot;: { # Container of information about an image. # The image payload, a container of the image bytes/uri.
304 &quot;imageThumbnail&quot;: &quot;A String&quot;, # A byte string of a thumbnail image.
305 &quot;mimeType&quot;: &quot;A String&quot;, # Image format.
306 &quot;imageUri&quot;: &quot;A String&quot;, # Image uri from the user bucket.
307 &quot;signedUri&quot;: &quot;A String&quot;, # Signed uri of the image file in the service bucket.
308 },
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800309 &quot;annotations&quot;: [ # Output only. Annotations for the piece of data in Example. One piece of data can have multiple annotations.
310 { # Annotation for Example. Each example may have one or more annotations. For example in image classification problem, each image might have one or more labels. We call labels binded with this image an Annotation.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800311 &quot;annotationMetadata&quot;: { # Additional information associated with the annotation. # Output only. Annotation metadata, including information like votes for labels.
312 &quot;operatorMetadata&quot;: { # General information useful for labels coming from contributors. # Metadata related to human labeling.
313 &quot;comments&quot;: [ # Comments from contributors.
314 &quot;A String&quot;,
315 ],
316 &quot;totalVotes&quot;: 42, # The total number of contributors that answer this question.
317 &quot;score&quot;: 3.14, # Confidence score corresponding to a label. For examle, if 3 contributors have answered the question and 2 of them agree on the final label, the confidence score will be 0.67 (2/3).
318 &quot;labelVotes&quot;: 42, # The total number of contributors that choose this label.
319 },
320 },
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800321 &quot;name&quot;: &quot;A String&quot;, # Output only. Unique name of this annotation, format is: projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/{annotated_dataset}/examples/{example_id}/annotations/{annotation_id}
322 &quot;annotationSource&quot;: &quot;A String&quot;, # Output only. The source of the annotation.
323 &quot;annotationSentiment&quot;: &quot;A String&quot;, # Output only. Sentiment for this annotation.
324 &quot;annotationValue&quot;: { # Annotation value for an example. # Output only. This is the actual annotation value, e.g classification, bounding box values are stored here.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800325 &quot;videoEventAnnotation&quot;: { # Video event annotation. # Annotation value for video event case.
326 &quot;annotationSpec&quot;: { # Container of information related to one possible annotation that can be used in a labeling task. For example, an image classification task where images are labeled as `dog` or `cat` must reference an AnnotationSpec for `dog` and an AnnotationSpec for `cat`. # Label of the event in this annotation.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800327 &quot;index&quot;: 42, # Output only. This is the integer index of the AnnotationSpec. The index for the whole AnnotationSpecSet is sequential starting from 0. For example, an AnnotationSpecSet with classes `dog` and `cat`, might contain one AnnotationSpec with `{ display_name: &quot;dog&quot;, index: 0 }` and one AnnotationSpec with `{ display_name: &quot;cat&quot;, index: 1 }`. This is especially useful for model training as it encodes the string labels into numeric values.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800328 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the AnnotationSpec. Maximum of 64 characters.
329 &quot;description&quot;: &quot;A String&quot;, # Optional. User-provided description of the annotation specification. The description can be up to 10,000 characters long.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800330 },
331 &quot;timeSegment&quot;: { # A time period inside of an example that has a time dimension (e.g. video). # The time segment of the video to which the annotation applies.
332 &quot;endTimeOffset&quot;: &quot;A String&quot;, # End of the time segment (exclusive), represented as the duration since the example start.
333 &quot;startTimeOffset&quot;: &quot;A String&quot;, # Start of the time segment (inclusive), represented as the duration since the example start.
334 },
335 },
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800336 &quot;imageBoundingPolyAnnotation&quot;: { # Image bounding poly annotation. It represents a polygon including bounding box in the image. # Annotation value for image bounding box, oriented bounding box and polygon cases.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800337 &quot;annotationSpec&quot;: { # Container of information related to one possible annotation that can be used in a labeling task. For example, an image classification task where images are labeled as `dog` or `cat` must reference an AnnotationSpec for `dog` and an AnnotationSpec for `cat`. # Label of object in this bounding polygon.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800338 &quot;index&quot;: 42, # Output only. This is the integer index of the AnnotationSpec. The index for the whole AnnotationSpecSet is sequential starting from 0. For example, an AnnotationSpecSet with classes `dog` and `cat`, might contain one AnnotationSpec with `{ display_name: &quot;dog&quot;, index: 0 }` and one AnnotationSpec with `{ display_name: &quot;cat&quot;, index: 1 }`. This is especially useful for model training as it encodes the string labels into numeric values.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800339 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the AnnotationSpec. Maximum of 64 characters.
340 &quot;description&quot;: &quot;A String&quot;, # Optional. User-provided description of the annotation specification. The description can be up to 10,000 characters long.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800341 },
342 &quot;normalizedBoundingPoly&quot;: { # Normalized bounding polygon.
343 &quot;normalizedVertices&quot;: [ # The bounding polygon normalized vertices.
344 { # A vertex represents a 2D point in the image. NOTE: the normalized vertex coordinates are relative to the original image and range from 0 to 1.
345 &quot;x&quot;: 3.14, # X coordinate.
346 &quot;y&quot;: 3.14, # Y coordinate.
347 },
348 ],
349 },
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800350 &quot;boundingPoly&quot;: { # A bounding polygon in the image.
351 &quot;vertices&quot;: [ # The bounding polygon vertices.
352 { # A vertex represents a 2D point in the image. NOTE: the vertex coordinates are in the same scale as the original image.
353 &quot;y&quot;: 42, # Y coordinate.
354 &quot;x&quot;: 42, # X coordinate.
355 },
356 ],
357 },
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800358 },
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800359 &quot;textClassificationAnnotation&quot;: { # Text classification annotation. # Annotation value for text classification case.
360 &quot;annotationSpec&quot;: { # Container of information related to one possible annotation that can be used in a labeling task. For example, an image classification task where images are labeled as `dog` or `cat` must reference an AnnotationSpec for `dog` and an AnnotationSpec for `cat`. # Label of the text.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800361 &quot;index&quot;: 42, # Output only. This is the integer index of the AnnotationSpec. The index for the whole AnnotationSpecSet is sequential starting from 0. For example, an AnnotationSpecSet with classes `dog` and `cat`, might contain one AnnotationSpec with `{ display_name: &quot;dog&quot;, index: 0 }` and one AnnotationSpec with `{ display_name: &quot;cat&quot;, index: 1 }`. This is especially useful for model training as it encodes the string labels into numeric values.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800362 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the AnnotationSpec. Maximum of 64 characters.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800363 &quot;description&quot;: &quot;A String&quot;, # Optional. User-provided description of the annotation specification. The description can be up to 10,000 characters long.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800364 },
365 },
366 &quot;videoObjectTrackingAnnotation&quot;: { # Video object tracking annotation. # Annotation value for video object detection and tracking case.
367 &quot;objectTrackingFrames&quot;: [ # The list of frames where this object track appears.
368 { # Video frame level annotation for object detection and tracking.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800369 &quot;timeOffset&quot;: &quot;A String&quot;, # The time offset of this frame relative to the beginning of the video.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800370 &quot;normalizedBoundingPoly&quot;: { # Normalized bounding polygon.
371 &quot;normalizedVertices&quot;: [ # The bounding polygon normalized vertices.
372 { # A vertex represents a 2D point in the image. NOTE: the normalized vertex coordinates are relative to the original image and range from 0 to 1.
373 &quot;x&quot;: 3.14, # X coordinate.
374 &quot;y&quot;: 3.14, # Y coordinate.
375 },
376 ],
377 },
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800378 &quot;boundingPoly&quot;: { # A bounding polygon in the image.
379 &quot;vertices&quot;: [ # The bounding polygon vertices.
380 { # A vertex represents a 2D point in the image. NOTE: the vertex coordinates are in the same scale as the original image.
381 &quot;y&quot;: 42, # Y coordinate.
382 &quot;x&quot;: 42, # X coordinate.
383 },
384 ],
385 },
386 },
387 ],
388 &quot;timeSegment&quot;: { # A time period inside of an example that has a time dimension (e.g. video). # The time segment of the video to which object tracking applies.
389 &quot;endTimeOffset&quot;: &quot;A String&quot;, # End of the time segment (exclusive), represented as the duration since the example start.
390 &quot;startTimeOffset&quot;: &quot;A String&quot;, # Start of the time segment (inclusive), represented as the duration since the example start.
391 },
392 &quot;annotationSpec&quot;: { # Container of information related to one possible annotation that can be used in a labeling task. For example, an image classification task where images are labeled as `dog` or `cat` must reference an AnnotationSpec for `dog` and an AnnotationSpec for `cat`. # Label of the object tracked in this annotation.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800393 &quot;index&quot;: 42, # Output only. This is the integer index of the AnnotationSpec. The index for the whole AnnotationSpecSet is sequential starting from 0. For example, an AnnotationSpecSet with classes `dog` and `cat`, might contain one AnnotationSpec with `{ display_name: &quot;dog&quot;, index: 0 }` and one AnnotationSpec with `{ display_name: &quot;cat&quot;, index: 1 }`. This is especially useful for model training as it encodes the string labels into numeric values.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800394 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the AnnotationSpec. Maximum of 64 characters.
395 &quot;description&quot;: &quot;A String&quot;, # Optional. User-provided description of the annotation specification. The description can be up to 10,000 characters long.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800396 },
397 },
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800398 &quot;textEntityExtractionAnnotation&quot;: { # Text entity extraction annotation. # Annotation value for text entity extraction case.
399 &quot;annotationSpec&quot;: { # Container of information related to one possible annotation that can be used in a labeling task. For example, an image classification task where images are labeled as `dog` or `cat` must reference an AnnotationSpec for `dog` and an AnnotationSpec for `cat`. # Label of the text entities.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800400 &quot;index&quot;: 42, # Output only. This is the integer index of the AnnotationSpec. The index for the whole AnnotationSpecSet is sequential starting from 0. For example, an AnnotationSpecSet with classes `dog` and `cat`, might contain one AnnotationSpec with `{ display_name: &quot;dog&quot;, index: 0 }` and one AnnotationSpec with `{ display_name: &quot;cat&quot;, index: 1 }`. This is especially useful for model training as it encodes the string labels into numeric values.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800401 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the AnnotationSpec. Maximum of 64 characters.
402 &quot;description&quot;: &quot;A String&quot;, # Optional. User-provided description of the annotation specification. The description can be up to 10,000 characters long.
403 },
404 &quot;sequentialSegment&quot;: { # Start and end position in a sequence (e.g. text segment). # Position of the entity.
405 &quot;start&quot;: 42, # Start position (inclusive).
406 &quot;end&quot;: 42, # End position (exclusive).
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800407 },
408 },
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800409 &quot;imageSegmentationAnnotation&quot;: { # Image segmentation annotation. # Annotation value for image segmentation.
410 &quot;mimeType&quot;: &quot;A String&quot;, # Image format.
411 &quot;imageBytes&quot;: &quot;A String&quot;, # A byte string of a full image&#x27;s color map.
412 &quot;annotationColors&quot;: { # The mapping between rgb color and annotation spec. The key is the rgb color represented in format of rgb(0, 0, 0). The value is the AnnotationSpec.
413 &quot;a_key&quot;: { # Container of information related to one possible annotation that can be used in a labeling task. For example, an image classification task where images are labeled as `dog` or `cat` must reference an AnnotationSpec for `dog` and an AnnotationSpec for `cat`.
414 &quot;index&quot;: 42, # Output only. This is the integer index of the AnnotationSpec. The index for the whole AnnotationSpecSet is sequential starting from 0. For example, an AnnotationSpecSet with classes `dog` and `cat`, might contain one AnnotationSpec with `{ display_name: &quot;dog&quot;, index: 0 }` and one AnnotationSpec with `{ display_name: &quot;cat&quot;, index: 1 }`. This is especially useful for model training as it encodes the string labels into numeric values.
415 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the AnnotationSpec. Maximum of 64 characters.
416 &quot;description&quot;: &quot;A String&quot;, # Optional. User-provided description of the annotation specification. The description can be up to 10,000 characters long.
417 },
418 },
419 },
420 &quot;imagePolylineAnnotation&quot;: { # A polyline for the image annotation. # Annotation value for image polyline cases. Polyline here is different from BoundingPoly. It is formed by line segments connected to each other but not closed form(Bounding Poly). The line segments can cross each other.
421 &quot;polyline&quot;: { # A line with multiple line segments.
422 &quot;vertices&quot;: [ # The polyline vertices.
423 { # A vertex represents a 2D point in the image. NOTE: the vertex coordinates are in the same scale as the original image.
424 &quot;y&quot;: 42, # Y coordinate.
425 &quot;x&quot;: 42, # X coordinate.
426 },
427 ],
428 },
429 &quot;annotationSpec&quot;: { # Container of information related to one possible annotation that can be used in a labeling task. For example, an image classification task where images are labeled as `dog` or `cat` must reference an AnnotationSpec for `dog` and an AnnotationSpec for `cat`. # Label of this polyline.
430 &quot;index&quot;: 42, # Output only. This is the integer index of the AnnotationSpec. The index for the whole AnnotationSpecSet is sequential starting from 0. For example, an AnnotationSpecSet with classes `dog` and `cat`, might contain one AnnotationSpec with `{ display_name: &quot;dog&quot;, index: 0 }` and one AnnotationSpec with `{ display_name: &quot;cat&quot;, index: 1 }`. This is especially useful for model training as it encodes the string labels into numeric values.
431 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the AnnotationSpec. Maximum of 64 characters.
432 &quot;description&quot;: &quot;A String&quot;, # Optional. User-provided description of the annotation specification. The description can be up to 10,000 characters long.
433 },
434 &quot;normalizedPolyline&quot;: { # Normalized polyline.
435 &quot;normalizedVertices&quot;: [ # The normalized polyline vertices.
436 { # A vertex represents a 2D point in the image. NOTE: the normalized vertex coordinates are relative to the original image and range from 0 to 1.
437 &quot;x&quot;: 3.14, # X coordinate.
438 &quot;y&quot;: 3.14, # Y coordinate.
439 },
440 ],
441 },
442 },
443 &quot;imageClassificationAnnotation&quot;: { # Image classification annotation definition. # Annotation value for image classification case.
444 &quot;annotationSpec&quot;: { # Container of information related to one possible annotation that can be used in a labeling task. For example, an image classification task where images are labeled as `dog` or `cat` must reference an AnnotationSpec for `dog` and an AnnotationSpec for `cat`. # Label of image.
445 &quot;index&quot;: 42, # Output only. This is the integer index of the AnnotationSpec. The index for the whole AnnotationSpecSet is sequential starting from 0. For example, an AnnotationSpecSet with classes `dog` and `cat`, might contain one AnnotationSpec with `{ display_name: &quot;dog&quot;, index: 0 }` and one AnnotationSpec with `{ display_name: &quot;cat&quot;, index: 1 }`. This is especially useful for model training as it encodes the string labels into numeric values.
446 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the AnnotationSpec. Maximum of 64 characters.
447 &quot;description&quot;: &quot;A String&quot;, # Optional. User-provided description of the annotation specification. The description can be up to 10,000 characters long.
448 },
449 },
450 &quot;videoClassificationAnnotation&quot;: { # Video classification annotation. # Annotation value for video classification case.
451 &quot;timeSegment&quot;: { # A time period inside of an example that has a time dimension (e.g. video). # The time segment of the video to which the annotation applies.
452 &quot;endTimeOffset&quot;: &quot;A String&quot;, # End of the time segment (exclusive), represented as the duration since the example start.
453 &quot;startTimeOffset&quot;: &quot;A String&quot;, # Start of the time segment (inclusive), represented as the duration since the example start.
454 },
455 &quot;annotationSpec&quot;: { # Container of information related to one possible annotation that can be used in a labeling task. For example, an image classification task where images are labeled as `dog` or `cat` must reference an AnnotationSpec for `dog` and an AnnotationSpec for `cat`. # Label of the segment specified by time_segment.
456 &quot;index&quot;: 42, # Output only. This is the integer index of the AnnotationSpec. The index for the whole AnnotationSpecSet is sequential starting from 0. For example, an AnnotationSpecSet with classes `dog` and `cat`, might contain one AnnotationSpec with `{ display_name: &quot;dog&quot;, index: 0 }` and one AnnotationSpec with `{ display_name: &quot;cat&quot;, index: 1 }`. This is especially useful for model training as it encodes the string labels into numeric values.
457 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the AnnotationSpec. Maximum of 64 characters.
458 &quot;description&quot;: &quot;A String&quot;, # Optional. User-provided description of the annotation specification. The description can be up to 10,000 characters long.
459 },
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800460 },
461 },
462 },
463 ],
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800464 &quot;videoPayload&quot;: { # Container of information of a video. # The video payload, a container of the video uri.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800465 &quot;mimeType&quot;: &quot;A String&quot;, # Video format.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800466 &quot;signedUri&quot;: &quot;A String&quot;, # Signed uri of the video file in the service bucket.
467 &quot;videoUri&quot;: &quot;A String&quot;, # Video uri from the user bucket.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800468 &quot;videoThumbnails&quot;: [ # The list of video thumbnails.
469 { # Container of information of a video thumbnail.
470 &quot;thumbnail&quot;: &quot;A String&quot;, # A byte string of the video frame.
471 &quot;timeOffset&quot;: &quot;A String&quot;, # Time offset relative to the beginning of the video, corresponding to the video frame where the thumbnail has been extracted from.
472 },
473 ],
474 &quot;frameRate&quot;: 3.14, # FPS of the video.
475 },
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800476 },
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700477 },
478 ],
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800479 &quot;nextPageToken&quot;: &quot;A String&quot;, # A token to retrieve next page of results.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700480 }</pre>
481</div>
482
483<div class="method">
484 <code class="details" id="search_next">search_next(previous_request, previous_response)</code>
485 <pre>Retrieves the next page of results.
486
487Args:
488 previous_request: The request for the previous page. (required)
489 previous_response: The response from the request for the previous page. (required)
490
491Returns:
492 A request object that you can call &#x27;execute()&#x27; on to request the next
493 page. Returns None if there are no more items in the collection.
494 </pre>
495</div>
496
497</body></html>