chore: regens API reference docs (#889)
diff --git a/docs/dyn/cloudsearch_v1.settings.datasources.html b/docs/dyn/cloudsearch_v1.settings.datasources.html
index ce48f4c..3ffe4ab 100644
--- a/docs/dyn/cloudsearch_v1.settings.datasources.html
+++ b/docs/dyn/cloudsearch_v1.settings.datasources.html
@@ -75,7 +75,7 @@
<h1><a href="cloudsearch_v1.html">Cloud Search API</a> . <a href="cloudsearch_v1.settings.html">settings</a> . <a href="cloudsearch_v1.settings.datasources.html">datasources</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
- <code><a href="#create">create(body, x__xgafv=None)</a></code></p>
+ <code><a href="#create">create(body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Creates a datasource.</p>
<p class="toc_element">
<code><a href="#delete">delete(name, debugOptions_enableDebugging=None, x__xgafv=None)</a></code></p>
@@ -90,15 +90,17 @@
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<p class="toc_element">
- <code><a href="#update">update(name, body, x__xgafv=None)</a></code></p>
+ <code><a href="#update">update(name, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Updates a datasource.</p>
<h3>Method Details</h3>
<div class="method">
- <code class="details" id="create">create(body, x__xgafv=None)</code>
+ <code class="details" id="create">create(body=None, x__xgafv=None)</code>
<pre>Creates a datasource.
+**Note:** This API requires an admin account to execute.
+
Args:
- body: object, The request body. (required)
+ body: object, The request body.
The object takes the form of:
{ # Datasource is a logical namespace for items to be indexed.
@@ -112,7 +114,7 @@
# The maximum length is 300 characters.
"name": "A String", # Name of the datasource resource.
# Format: datasources/{source_id}.
- # <br />The name is ignored when creating a datasource.
+ # <br />The name is ignored when creating a datasource.
"disableModifications": True or False, # If true, Indexing API rejects any modification calls to this datasource
# such as create, update, and delete.
# Disabling this does not imply halting process of previously
@@ -134,8 +136,8 @@
},
],
"shortName": "A String", # A short name or alias for the source. This value will be used to match the
- # 'source' operator. For example, if the short name is *<value>* then
- # queries like *source:<value>* will only return results for this
+ # 'source' operator. For example, if the short name is *&lt;value&gt;* then
+ # queries like *source:&lt;value&gt;* will only return results for this
# source. The value must be unique across all datasources. The value must
# only contain alphanumeric characters (a-zA-Z0-9). The value cannot start
# with 'google' and cannot be one of the following: mail, gmail, docs, drive,
@@ -160,6 +162,22 @@
# long-running operation should document the metadata type, if any.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "done": 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.
+ "response": { # 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`.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # 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}`.
"error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
# different programming environments, including REST APIs and RPC APIs. It is
# used by [gRPC](https://github.com/grpc). Each `Status` message contains
@@ -178,22 +196,6 @@
},
],
},
- "done": 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.
- "response": { # 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`.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- "name": "A String", # 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}`.
}</pre>
</div>
@@ -201,6 +203,8 @@
<code class="details" id="delete">delete(name, debugOptions_enableDebugging=None, x__xgafv=None)</code>
<pre>Deletes a datasource.
+**Note:** This API requires an admin account to execute.
+
Args:
name: string, Name of the datasource.
Format: datasources/{source_id}. (required)
@@ -222,6 +226,22 @@
# long-running operation should document the metadata type, if any.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "done": 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.
+ "response": { # 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`.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # 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}`.
"error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
# different programming environments, including REST APIs and RPC APIs. It is
# used by [gRPC](https://github.com/grpc). Each `Status` message contains
@@ -240,22 +260,6 @@
},
],
},
- "done": 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.
- "response": { # 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`.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- "name": "A String", # 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}`.
}</pre>
</div>
@@ -263,6 +267,8 @@
<code class="details" id="get">get(name, debugOptions_enableDebugging=None, x__xgafv=None)</code>
<pre>Gets a datasource.
+**Note:** This API requires an admin account to execute.
+
Args:
name: string, Name of the datasource resource.
Format: datasources/{source_id}. (required)
@@ -287,7 +293,7 @@
# The maximum length is 300 characters.
"name": "A String", # Name of the datasource resource.
# Format: datasources/{source_id}.
- # <br />The name is ignored when creating a datasource.
+ # <br />The name is ignored when creating a datasource.
"disableModifications": True or False, # If true, Indexing API rejects any modification calls to this datasource
# such as create, update, and delete.
# Disabling this does not imply halting process of previously
@@ -309,8 +315,8 @@
},
],
"shortName": "A String", # A short name or alias for the source. This value will be used to match the
- # 'source' operator. For example, if the short name is *<value>* then
- # queries like *source:<value>* will only return results for this
+ # 'source' operator. For example, if the short name is *&lt;value&gt;* then
+ # queries like *source:&lt;value&gt;* will only return results for this
# source. The value must be unique across all datasources. The value must
# only contain alphanumeric characters (a-zA-Z0-9). The value cannot start
# with 'google' and cannot be one of the following: mail, gmail, docs, drive,
@@ -324,10 +330,12 @@
<code class="details" id="list">list(pageSize=None, debugOptions_enableDebugging=None, pageToken=None, x__xgafv=None)</code>
<pre>Lists datasources.
+**Note:** This API requires an admin account to execute.
+
Args:
pageSize: integer, Maximum number of datasources to fetch in a request.
The max value is 100.
-<br />The default value is 10
+<br />The default value is 10
debugOptions_enableDebugging: boolean, If you are asked by Google to help with debugging, set this field.
Otherwise, ignore this field.
pageToken: string, Starting index of the results.
@@ -354,7 +362,7 @@
# The maximum length is 300 characters.
"name": "A String", # Name of the datasource resource.
# Format: datasources/{source_id}.
- # <br />The name is ignored when creating a datasource.
+ # <br />The name is ignored when creating a datasource.
"disableModifications": True or False, # If true, Indexing API rejects any modification calls to this datasource
# such as create, update, and delete.
# Disabling this does not imply halting process of previously
@@ -376,8 +384,8 @@
},
],
"shortName": "A String", # A short name or alias for the source. This value will be used to match the
- # 'source' operator. For example, if the short name is *<value>* then
- # queries like *source:<value>* will only return results for this
+ # 'source' operator. For example, if the short name is *&lt;value&gt;* then
+ # queries like *source:&lt;value&gt;* will only return results for this
# source. The value must be unique across all datasources. The value must
# only contain alphanumeric characters (a-zA-Z0-9). The value cannot start
# with 'google' and cannot be one of the following: mail, gmail, docs, drive,
@@ -404,14 +412,16 @@
</div>
<div class="method">
- <code class="details" id="update">update(name, body, x__xgafv=None)</code>
+ <code class="details" id="update">update(name, body=None, x__xgafv=None)</code>
<pre>Updates a datasource.
+**Note:** This API requires an admin account to execute.
+
Args:
name: string, Name of the datasource resource.
Format: datasources/{source_id}.
-<br />The name is ignored when creating a datasource. (required)
- body: object, The request body. (required)
+<br />The name is ignored when creating a datasource. (required)
+ body: object, The request body.
The object takes the form of:
{
@@ -426,7 +436,7 @@
# The maximum length is 300 characters.
"name": "A String", # Name of the datasource resource.
# Format: datasources/{source_id}.
- # <br />The name is ignored when creating a datasource.
+ # <br />The name is ignored when creating a datasource.
"disableModifications": True or False, # If true, Indexing API rejects any modification calls to this datasource
# such as create, update, and delete.
# Disabling this does not imply halting process of previously
@@ -448,8 +458,8 @@
},
],
"shortName": "A String", # A short name or alias for the source. This value will be used to match the
- # 'source' operator. For example, if the short name is *<value>* then
- # queries like *source:<value>* will only return results for this
+ # 'source' operator. For example, if the short name is *&lt;value&gt;* then
+ # queries like *source:&lt;value&gt;* will only return results for this
# source. The value must be unique across all datasources. The value must
# only contain alphanumeric characters (a-zA-Z0-9). The value cannot start
# with 'google' and cannot be one of the following: mail, gmail, docs, drive,
@@ -479,6 +489,22 @@
# long-running operation should document the metadata type, if any.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "done": 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.
+ "response": { # 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`.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # 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}`.
"error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
# different programming environments, including REST APIs and RPC APIs. It is
# used by [gRPC](https://github.com/grpc). Each `Status` message contains
@@ -497,22 +523,6 @@
},
],
},
- "done": 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.
- "response": { # 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`.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- "name": "A String", # 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}`.
}</pre>
</div>