blob: 82078ae1bf788bde2a5bb67aca499a657f821d64 [file] [log] [blame]
Bu Sun Kim65020912020-05-20 12:08:20 -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="firebaseml_v1beta2.html">Firebase ML API</a> . <a href="firebaseml_v1beta2.projects.html">projects</a> . <a href="firebaseml_v1beta2.projects.models.html">models</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070078 <code><a href="#close">close()</a></code></p>
79<p class="firstline">Close httplib2 connections.</p>
80<p class="toc_element">
Bu Sun Kim65020912020-05-20 12:08:20 -070081 <code><a href="#create">create(parent, body=None, x__xgafv=None)</a></code></p>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070082<p class="firstline">Creates a model in Firebase ML. The longrunning operation will eventually return a Model</p>
Bu Sun Kim65020912020-05-20 12:08:20 -070083<p class="toc_element">
84 <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
85<p class="firstline">Deletes a model</p>
86<p class="toc_element">
yoshi-code-botb6dc1b92021-03-02 11:49:08 -080087 <code><a href="#download">download(name, x__xgafv=None)</a></code></p>
88<p class="firstline">Gets Download information for a model. This is meant for downloading model resources onto devices. It gives very limited information about the model.</p>
89<p class="toc_element">
Bu Sun Kim65020912020-05-20 12:08:20 -070090 <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
91<p class="firstline">Gets a model resource.</p>
92<p class="toc_element">
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -080093 <code><a href="#list">list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
Bu Sun Kim65020912020-05-20 12:08:20 -070094<p class="firstline">Lists the models</p>
95<p class="toc_element">
96 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
97<p class="firstline">Retrieves the next page of results.</p>
98<p class="toc_element">
99 <code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
100<p class="firstline">Updates a model. The longrunning operation will eventually return a Model.</p>
101<h3>Method Details</h3>
102<div class="method">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700103 <code class="details" id="close">close()</code>
104 <pre>Close httplib2 connections.</pre>
105</div>
106
107<div class="method">
Bu Sun Kim65020912020-05-20 12:08:20 -0700108 <code class="details" id="create">create(parent, body=None, x__xgafv=None)</code>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700109 <pre>Creates a model in Firebase ML. The longrunning operation will eventually return a Model
Bu Sun Kim65020912020-05-20 12:08:20 -0700110
111Args:
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700112 parent: string, Required. The parent project resource where the model is to be created. The parent must have the form `projects/{project_id}` (required)
Bu Sun Kim65020912020-05-20 12:08:20 -0700113 body: object, The request body.
114 The object takes the form of:
115
116{ # An ML model hosted in Firebase ML
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800117 &quot;activeOperations&quot;: [ # Output only. Lists operation ids associated with this model whose status is NOT done.
118 { # This resource represents a long-running operation that is the result of a network API call.
119 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
120 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
121 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700122 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
Bu Sun Kim65020912020-05-20 12:08:20 -0700123 {
124 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
125 },
126 ],
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800127 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800128 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800129 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
130 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
131 },
132 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
133 &quot;response&quot;: { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
134 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
135 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700136 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800137 ],
138 &quot;createTime&quot;: &quot;A String&quot;, # Output only. Timestamp when this model was created in Firebase ML.
139 &quot;displayName&quot;: &quot;A String&quot;, # Required. The name of the model to create. The name can be up to 32 characters long and can consist only of ASCII Latin letters A-Z and a-z, underscores(_) and ASCII digits 0-9. It must start with a letter.
140 &quot;etag&quot;: &quot;A String&quot;, # Output only. See RFC7232 https://tools.ietf.org/html/rfc7232#section-2.3
141 &quot;modelHash&quot;: &quot;A String&quot;, # Output only. The model_hash will change if a new file is available for download.
142 &quot;name&quot;: &quot;A String&quot;, # The resource name of the Model. Model names have the form `projects/{project_id}/models/{model_id}` The name is ignored when creating a model.
143 &quot;state&quot;: { # State common to all model types. Includes publishing and validation information. # State common to all model types. Includes publishing and validation information.
144 &quot;published&quot;: True or False, # Indicates if this model has been published.
145 &quot;validationError&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. Indicates the latest validation error on the model if any. A model may have validation errors if there were problems during the model creation/update. e.g. in the case of a TfLiteModel, if a tflite model file was missing or in the wrong format. This field will be empty for valid models.
146 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
147 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
148 {
149 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
150 },
151 ],
152 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
153 },
154 },
155 &quot;tags&quot;: [ # User defined tags which can be used to group/filter models during listing
156 &quot;A String&quot;,
157 ],
158 &quot;tfliteModel&quot;: { # Information that is specific to TfLite models. # A TFLite Model
159 &quot;automlModel&quot;: &quot;A String&quot;, # The AutoML model id referencing a model you created with the AutoML API. The name should have format &#x27;projects//locations//models/&#x27; (This is the model resource name returned from the AutoML API)
160 &quot;gcsTfliteUri&quot;: &quot;A String&quot;, # The TfLite file containing the model. (Stored in Google Cloud). The gcs_tflite_uri should have form: gs://some-bucket/some-model.tflite Note: If you update the file in the original location, it is necessary to call UpdateModel for ML to pick up and validate the updated file.
161 &quot;sizeBytes&quot;: &quot;A String&quot;, # Output only. The size of the TFLite model
162 },
163 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Timestamp when this model was updated in Firebase ML.
164}
Bu Sun Kim65020912020-05-20 12:08:20 -0700165
166 x__xgafv: string, V1 error format.
167 Allowed values
168 1 - v1 error format
169 2 - v2 error format
170
171Returns:
172 An object of the form:
173
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700174 { # This resource represents a long-running operation that is the result of a network API call.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800175 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
176 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
177 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
178 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
179 {
180 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
181 },
182 ],
183 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
184 },
185 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
186 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
187 },
188 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
189 &quot;response&quot;: { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
190 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
191 },
192}</pre>
Bu Sun Kim65020912020-05-20 12:08:20 -0700193</div>
194
195<div class="method">
196 <code class="details" id="delete">delete(name, x__xgafv=None)</code>
197 <pre>Deletes a model
198
199Args:
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700200 name: string, Required. The name of the model to delete. The name must have the form `projects/{project_id}/models/{model_id}` (required)
Bu Sun Kim65020912020-05-20 12:08:20 -0700201 x__xgafv: string, V1 error format.
202 Allowed values
203 1 - v1 error format
204 2 - v2 error format
205
206Returns:
207 An object of the form:
208
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700209 { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800210}</pre>
Bu Sun Kim65020912020-05-20 12:08:20 -0700211</div>
212
213<div class="method">
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800214 <code class="details" id="download">download(name, x__xgafv=None)</code>
215 <pre>Gets Download information for a model. This is meant for downloading model resources onto devices. It gives very limited information about the model.
216
217Args:
218 name: string, Required. The name of the model to download. The name must have the form `projects/{project}/models/{model}` (required)
219 x__xgafv: string, V1 error format.
220 Allowed values
221 1 - v1 error format
222 2 - v2 error format
223
224Returns:
225 An object of the form:
226
227 { # The response for downloading a model to device.
228 &quot;downloadUri&quot;: &quot;A String&quot;, # Output only. A download URI for the model/zip file.
229 &quot;expireTime&quot;: &quot;A String&quot;, # Output only. The time that the download URI link expires. If the link has expired, the REST call must be repeated.
230 &quot;modelFormat&quot;: &quot;A String&quot;, # Output only. The format of the model being downloaded.
231 &quot;sizeBytes&quot;: &quot;A String&quot;, # Output only. The size of the file(s), if this information is available.
232}</pre>
233</div>
234
235<div class="method">
Bu Sun Kim65020912020-05-20 12:08:20 -0700236 <code class="details" id="get">get(name, x__xgafv=None)</code>
237 <pre>Gets a model resource.
238
239Args:
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700240 name: string, Required. The name of the model to get. The name must have the form `projects/{project_id}/models/{model_id}` (required)
Bu Sun Kim65020912020-05-20 12:08:20 -0700241 x__xgafv: string, V1 error format.
242 Allowed values
243 1 - v1 error format
244 2 - v2 error format
245
246Returns:
247 An object of the form:
248
249 { # An ML model hosted in Firebase ML
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800250 &quot;activeOperations&quot;: [ # Output only. Lists operation ids associated with this model whose status is NOT done.
251 { # This resource represents a long-running operation that is the result of a network API call.
252 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
253 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
254 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
255 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
256 {
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800257 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
258 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800259 ],
260 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
261 },
262 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
263 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
264 },
265 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
266 &quot;response&quot;: { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
267 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
268 },
269 },
270 ],
271 &quot;createTime&quot;: &quot;A String&quot;, # Output only. Timestamp when this model was created in Firebase ML.
272 &quot;displayName&quot;: &quot;A String&quot;, # Required. The name of the model to create. The name can be up to 32 characters long and can consist only of ASCII Latin letters A-Z and a-z, underscores(_) and ASCII digits 0-9. It must start with a letter.
273 &quot;etag&quot;: &quot;A String&quot;, # Output only. See RFC7232 https://tools.ietf.org/html/rfc7232#section-2.3
274 &quot;modelHash&quot;: &quot;A String&quot;, # Output only. The model_hash will change if a new file is available for download.
275 &quot;name&quot;: &quot;A String&quot;, # The resource name of the Model. Model names have the form `projects/{project_id}/models/{model_id}` The name is ignored when creating a model.
276 &quot;state&quot;: { # State common to all model types. Includes publishing and validation information. # State common to all model types. Includes publishing and validation information.
277 &quot;published&quot;: True or False, # Indicates if this model has been published.
278 &quot;validationError&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. Indicates the latest validation error on the model if any. A model may have validation errors if there were problems during the model creation/update. e.g. in the case of a TfLiteModel, if a tflite model file was missing or in the wrong format. This field will be empty for valid models.
279 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
280 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
281 {
282 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800283 },
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800284 ],
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800285 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
286 },
287 },
288 &quot;tags&quot;: [ # User defined tags which can be used to group/filter models during listing
289 &quot;A String&quot;,
290 ],
291 &quot;tfliteModel&quot;: { # Information that is specific to TfLite models. # A TFLite Model
292 &quot;automlModel&quot;: &quot;A String&quot;, # The AutoML model id referencing a model you created with the AutoML API. The name should have format &#x27;projects//locations//models/&#x27; (This is the model resource name returned from the AutoML API)
293 &quot;gcsTfliteUri&quot;: &quot;A String&quot;, # The TfLite file containing the model. (Stored in Google Cloud). The gcs_tflite_uri should have form: gs://some-bucket/some-model.tflite Note: If you update the file in the original location, it is necessary to call UpdateModel for ML to pick up and validate the updated file.
294 &quot;sizeBytes&quot;: &quot;A String&quot;, # Output only. The size of the TFLite model
295 },
296 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Timestamp when this model was updated in Firebase ML.
297}</pre>
Bu Sun Kim65020912020-05-20 12:08:20 -0700298</div>
299
300<div class="method">
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800301 <code class="details" id="list">list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
Bu Sun Kim65020912020-05-20 12:08:20 -0700302 <pre>Lists the models
303
304Args:
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700305 parent: string, Required. The name of the parent to list models for. The parent must have the form `projects/{project_id}&#x27; (required)
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800306 filter: string, A filter for the list e.g. &#x27;tags: abc&#x27; to list models which are tagged with &quot;abc&quot;
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800307 pageSize: integer, The maximum number of items to return
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800308 pageToken: string, The next_page_token value returned from a previous List request, if any.
Bu Sun Kim65020912020-05-20 12:08:20 -0700309 x__xgafv: string, V1 error format.
310 Allowed values
311 1 - v1 error format
312 2 - v2 error format
313
314Returns:
315 An object of the form:
316
317 { # The response for list models
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800318 &quot;models&quot;: [ # The list of models
319 { # An ML model hosted in Firebase ML
320 &quot;activeOperations&quot;: [ # Output only. Lists operation ids associated with this model whose status is NOT done.
321 { # This resource represents a long-running operation that is the result of a network API call.
322 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
323 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
324 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
325 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
326 {
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800327 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
328 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800329 ],
330 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800331 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800332 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
333 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
334 },
335 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
336 &quot;response&quot;: { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
337 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Bu Sun Kim65020912020-05-20 12:08:20 -0700338 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700339 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800340 ],
341 &quot;createTime&quot;: &quot;A String&quot;, # Output only. Timestamp when this model was created in Firebase ML.
342 &quot;displayName&quot;: &quot;A String&quot;, # Required. The name of the model to create. The name can be up to 32 characters long and can consist only of ASCII Latin letters A-Z and a-z, underscores(_) and ASCII digits 0-9. It must start with a letter.
343 &quot;etag&quot;: &quot;A String&quot;, # Output only. See RFC7232 https://tools.ietf.org/html/rfc7232#section-2.3
344 &quot;modelHash&quot;: &quot;A String&quot;, # Output only. The model_hash will change if a new file is available for download.
345 &quot;name&quot;: &quot;A String&quot;, # The resource name of the Model. Model names have the form `projects/{project_id}/models/{model_id}` The name is ignored when creating a model.
346 &quot;state&quot;: { # State common to all model types. Includes publishing and validation information. # State common to all model types. Includes publishing and validation information.
347 &quot;published&quot;: True or False, # Indicates if this model has been published.
348 &quot;validationError&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. Indicates the latest validation error on the model if any. A model may have validation errors if there were problems during the model creation/update. e.g. in the case of a TfLiteModel, if a tflite model file was missing or in the wrong format. This field will be empty for valid models.
349 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
350 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
351 {
352 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
353 },
354 ],
355 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
356 },
357 },
358 &quot;tags&quot;: [ # User defined tags which can be used to group/filter models during listing
359 &quot;A String&quot;,
360 ],
361 &quot;tfliteModel&quot;: { # Information that is specific to TfLite models. # A TFLite Model
362 &quot;automlModel&quot;: &quot;A String&quot;, # The AutoML model id referencing a model you created with the AutoML API. The name should have format &#x27;projects//locations//models/&#x27; (This is the model resource name returned from the AutoML API)
363 &quot;gcsTfliteUri&quot;: &quot;A String&quot;, # The TfLite file containing the model. (Stored in Google Cloud). The gcs_tflite_uri should have form: gs://some-bucket/some-model.tflite Note: If you update the file in the original location, it is necessary to call UpdateModel for ML to pick up and validate the updated file.
364 &quot;sizeBytes&quot;: &quot;A String&quot;, # Output only. The size of the TFLite model
365 },
366 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Timestamp when this model was updated in Firebase ML.
367 },
368 ],
369 &quot;nextPageToken&quot;: &quot;A String&quot;, # Token to retrieve the next page of results, or empty if there are no more results in the list.
370}</pre>
Bu Sun Kim65020912020-05-20 12:08:20 -0700371</div>
372
373<div class="method">
374 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
375 <pre>Retrieves the next page of results.
376
377Args:
378 previous_request: The request for the previous page. (required)
379 previous_response: The response from the request for the previous page. (required)
380
381Returns:
382 A request object that you can call &#x27;execute()&#x27; on to request the next
383 page. Returns None if there are no more items in the collection.
384 </pre>
385</div>
386
387<div class="method">
388 <code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>
389 <pre>Updates a model. The longrunning operation will eventually return a Model.
390
391Args:
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700392 name: string, The resource name of the Model. Model names have the form `projects/{project_id}/models/{model_id}` The name is ignored when creating a model. (required)
Bu Sun Kim65020912020-05-20 12:08:20 -0700393 body: object, The request body.
394 The object takes the form of:
395
396{ # An ML model hosted in Firebase ML
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800397 &quot;activeOperations&quot;: [ # Output only. Lists operation ids associated with this model whose status is NOT done.
398 { # This resource represents a long-running operation that is the result of a network API call.
399 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
400 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
401 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700402 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
Bu Sun Kim65020912020-05-20 12:08:20 -0700403 {
404 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
405 },
406 ],
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800407 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800408 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800409 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
410 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
411 },
412 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
413 &quot;response&quot;: { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
414 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
415 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700416 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800417 ],
418 &quot;createTime&quot;: &quot;A String&quot;, # Output only. Timestamp when this model was created in Firebase ML.
419 &quot;displayName&quot;: &quot;A String&quot;, # Required. The name of the model to create. The name can be up to 32 characters long and can consist only of ASCII Latin letters A-Z and a-z, underscores(_) and ASCII digits 0-9. It must start with a letter.
420 &quot;etag&quot;: &quot;A String&quot;, # Output only. See RFC7232 https://tools.ietf.org/html/rfc7232#section-2.3
421 &quot;modelHash&quot;: &quot;A String&quot;, # Output only. The model_hash will change if a new file is available for download.
422 &quot;name&quot;: &quot;A String&quot;, # The resource name of the Model. Model names have the form `projects/{project_id}/models/{model_id}` The name is ignored when creating a model.
423 &quot;state&quot;: { # State common to all model types. Includes publishing and validation information. # State common to all model types. Includes publishing and validation information.
424 &quot;published&quot;: True or False, # Indicates if this model has been published.
425 &quot;validationError&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. Indicates the latest validation error on the model if any. A model may have validation errors if there were problems during the model creation/update. e.g. in the case of a TfLiteModel, if a tflite model file was missing or in the wrong format. This field will be empty for valid models.
426 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
427 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
428 {
429 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
430 },
431 ],
432 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
433 },
434 },
435 &quot;tags&quot;: [ # User defined tags which can be used to group/filter models during listing
436 &quot;A String&quot;,
437 ],
438 &quot;tfliteModel&quot;: { # Information that is specific to TfLite models. # A TFLite Model
439 &quot;automlModel&quot;: &quot;A String&quot;, # The AutoML model id referencing a model you created with the AutoML API. The name should have format &#x27;projects//locations//models/&#x27; (This is the model resource name returned from the AutoML API)
440 &quot;gcsTfliteUri&quot;: &quot;A String&quot;, # The TfLite file containing the model. (Stored in Google Cloud). The gcs_tflite_uri should have form: gs://some-bucket/some-model.tflite Note: If you update the file in the original location, it is necessary to call UpdateModel for ML to pick up and validate the updated file.
441 &quot;sizeBytes&quot;: &quot;A String&quot;, # Output only. The size of the TFLite model
442 },
443 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Timestamp when this model was updated in Firebase ML.
444}
Bu Sun Kim65020912020-05-20 12:08:20 -0700445
446 updateMask: string, The update mask
447 x__xgafv: string, V1 error format.
448 Allowed values
449 1 - v1 error format
450 2 - v2 error format
451
452Returns:
453 An object of the form:
454
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700455 { # This resource represents a long-running operation that is the result of a network API call.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800456 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
457 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
458 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
459 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
460 {
461 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
462 },
463 ],
464 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
465 },
466 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
467 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
468 },
469 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
470 &quot;response&quot;: { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
471 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
472 },
473}</pre>
Bu Sun Kim65020912020-05-20 12:08:20 -0700474</div>
475
476</body></html>