docs: update generated docs (#1053)
Updates for both discovery docs and epydoc API Documentation
Fixes: #1049
diff --git a/docs/dyn/dialogflow_v2beta1.projects.agent.knowledgeBases.html b/docs/dyn/dialogflow_v2beta1.projects.agent.knowledgeBases.html
index 5f9e1de..bebd26e 100644
--- a/docs/dyn/dialogflow_v2beta1.projects.agent.knowledgeBases.html
+++ b/docs/dyn/dialogflow_v2beta1.projects.agent.knowledgeBases.html
@@ -80,55 +80,45 @@
<p class="firstline">Returns the documents Resource.</p>
<p class="toc_element">
+ <code><a href="#close">close()</a></code></p>
+<p class="firstline">Close httplib2 connections.</p>
+<p class="toc_element">
<code><a href="#create">create(parent, body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Creates a knowledge base.</p>
+<p class="firstline">Creates a knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.</p>
<p class="toc_element">
<code><a href="#delete">delete(name, force=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes the specified knowledge base.</p>
+<p class="firstline">Deletes the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.</p>
<p class="toc_element">
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
-<p class="firstline">Retrieves the specified knowledge base.</p>
+<p class="firstline">Retrieves the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.</p>
<p class="toc_element">
<code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Returns the list of all knowledge bases of the specified agent.</p>
+<p class="firstline">Returns the list of all knowledge bases of the specified agent. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.</p>
<p class="toc_element">
<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="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Updates the specified knowledge base.</p>
+<p class="firstline">Updates the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.</p>
<h3>Method Details</h3>
<div class="method">
- <code class="details" id="create">create(parent, body=None, x__xgafv=None)</code>
- <pre>Creates a knowledge base.
+ <code class="details" id="close">close()</code>
+ <pre>Close httplib2 connections.</pre>
+</div>
-Note: The `projects.agent.knowledgeBases` resource is deprecated;
-only use `projects.knowledgeBases`.
+<div class="method">
+ <code class="details" id="create">create(parent, body=None, x__xgafv=None)</code>
+ <pre>Creates a knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
Args:
- parent: string, Required. The project to create a knowledge base for.
-Format: `projects/<Project ID>`. (required)
+ parent: string, Required. The project to create a knowledge base for. Format: `projects/`. (required)
body: object, The request body.
The object takes the form of:
-{ # A knowledge base represents a collection of knowledge documents that you
- # provide to Dialogflow. Your knowledge documents contain information that may
- # be useful during conversations with end-users. Some Dialogflow features use
- # knowledge bases when looking for a response to an end-user input.
- #
- # For more information, see the [knowledge base
- # guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases).
- #
- # Note: The `projects.agent.knowledgeBases` resource is deprecated;
- # only use `projects.knowledgeBases`.
- "displayName": "A String", # Required. The display name of the knowledge base. The name must be 1024
- # bytes or less; otherwise, the creation request fails.
- "name": "A String", # The knowledge base resource name.
- # The name must be empty when creating a knowledge base.
- # Format: `projects/<Project ID>/knowledgeBases/<Knowledge Base ID>`.
- "languageCode": "A String", # Language which represents the KnowledgeBase. When the KnowledgeBase is
- # created/updated, this is populated for all non en-us languages. If not
- # populated, the default language en-us applies.
+{ # A knowledge base represents a collection of knowledge documents that you provide to Dialogflow. Your knowledge documents contain information that may be useful during conversations with end-users. Some Dialogflow features use knowledge bases when looking for a response to an end-user input. For more information, see the [knowledge base guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases). Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
+ "languageCode": "A String", # Language which represents the KnowledgeBase. When the KnowledgeBase is created/updated, this is populated for all non en-us languages. If not populated, the default language en-us applies.
+ "name": "A String", # The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`.
+ "displayName": "A String", # Required. The display name of the knowledge base. The name must be 1024 bytes or less; otherwise, the creation request fails.
}
x__xgafv: string, V1 error format.
@@ -139,39 +129,20 @@
Returns:
An object of the form:
- { # A knowledge base represents a collection of knowledge documents that you
- # provide to Dialogflow. Your knowledge documents contain information that may
- # be useful during conversations with end-users. Some Dialogflow features use
- # knowledge bases when looking for a response to an end-user input.
- #
- # For more information, see the [knowledge base
- # guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases).
- #
- # Note: The `projects.agent.knowledgeBases` resource is deprecated;
- # only use `projects.knowledgeBases`.
- "displayName": "A String", # Required. The display name of the knowledge base. The name must be 1024
- # bytes or less; otherwise, the creation request fails.
- "name": "A String", # The knowledge base resource name.
- # The name must be empty when creating a knowledge base.
- # Format: `projects/<Project ID>/knowledgeBases/<Knowledge Base ID>`.
- "languageCode": "A String", # Language which represents the KnowledgeBase. When the KnowledgeBase is
- # created/updated, this is populated for all non en-us languages. If not
- # populated, the default language en-us applies.
+ { # A knowledge base represents a collection of knowledge documents that you provide to Dialogflow. Your knowledge documents contain information that may be useful during conversations with end-users. Some Dialogflow features use knowledge bases when looking for a response to an end-user input. For more information, see the [knowledge base guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases). Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
+ "languageCode": "A String", # Language which represents the KnowledgeBase. When the KnowledgeBase is created/updated, this is populated for all non en-us languages. If not populated, the default language en-us applies.
+ "name": "A String", # The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`.
+ "displayName": "A String", # Required. The display name of the knowledge base. The name must be 1024 bytes or less; otherwise, the creation request fails.
}</pre>
</div>
<div class="method">
<code class="details" id="delete">delete(name, force=None, x__xgafv=None)</code>
- <pre>Deletes the specified knowledge base.
-
-Note: The `projects.agent.knowledgeBases` resource is deprecated;
-only use `projects.knowledgeBases`.
+ <pre>Deletes the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
Args:
- name: string, Required. The name of the knowledge base to delete.
-Format: `projects/<Project ID>/knowledgeBases/<Knowledge Base ID>`. (required)
- force: boolean, Optional. Force deletes the knowledge base. When set to true, any documents
-in the knowledge base are also deleted.
+ name: string, Required. The name of the knowledge base to delete. Format: `projects//knowledgeBases/`. (required)
+ force: boolean, Optional. Force deletes the knowledge base. When set to true, any documents in the knowledge base are also deleted.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -180,28 +151,16 @@
Returns:
An object of the form:
- { # 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 `{}`.
+ { # 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 `{}`.
}</pre>
</div>
<div class="method">
<code class="details" id="get">get(name, x__xgafv=None)</code>
- <pre>Retrieves the specified knowledge base.
-
-Note: The `projects.agent.knowledgeBases` resource is deprecated;
-only use `projects.knowledgeBases`.
+ <pre>Retrieves the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
Args:
- name: string, Required. The name of the knowledge base to retrieve.
-Format `projects/<Project ID>/knowledgeBases/<Knowledge Base ID>`. (required)
+ name: string, Required. The name of the knowledge base to retrieve. Format `projects//knowledgeBases/`. (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -210,40 +169,21 @@
Returns:
An object of the form:
- { # A knowledge base represents a collection of knowledge documents that you
- # provide to Dialogflow. Your knowledge documents contain information that may
- # be useful during conversations with end-users. Some Dialogflow features use
- # knowledge bases when looking for a response to an end-user input.
- #
- # For more information, see the [knowledge base
- # guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases).
- #
- # Note: The `projects.agent.knowledgeBases` resource is deprecated;
- # only use `projects.knowledgeBases`.
- "displayName": "A String", # Required. The display name of the knowledge base. The name must be 1024
- # bytes or less; otherwise, the creation request fails.
- "name": "A String", # The knowledge base resource name.
- # The name must be empty when creating a knowledge base.
- # Format: `projects/<Project ID>/knowledgeBases/<Knowledge Base ID>`.
- "languageCode": "A String", # Language which represents the KnowledgeBase. When the KnowledgeBase is
- # created/updated, this is populated for all non en-us languages. If not
- # populated, the default language en-us applies.
+ { # A knowledge base represents a collection of knowledge documents that you provide to Dialogflow. Your knowledge documents contain information that may be useful during conversations with end-users. Some Dialogflow features use knowledge bases when looking for a response to an end-user input. For more information, see the [knowledge base guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases). Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
+ "languageCode": "A String", # Language which represents the KnowledgeBase. When the KnowledgeBase is created/updated, this is populated for all non en-us languages. If not populated, the default language en-us applies.
+ "name": "A String", # The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`.
+ "displayName": "A String", # Required. The display name of the knowledge base. The name must be 1024 bytes or less; otherwise, the creation request fails.
}</pre>
</div>
<div class="method">
<code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
- <pre>Returns the list of all knowledge bases of the specified agent.
-
-Note: The `projects.agent.knowledgeBases` resource is deprecated;
-only use `projects.knowledgeBases`.
+ <pre>Returns the list of all knowledge bases of the specified agent. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
Args:
- parent: string, Required. The project to list of knowledge bases for.
-Format: `projects/<Project ID>`. (required)
- pageSize: integer, Optional. The maximum number of items to return in a single page. By
-default 10 and at most 100.
- pageToken: string, Optional. The next_page_token value returned from a previous list request.
+ parent: string, Required. The project to list of knowledge bases for. Format: `projects/`. (required)
+ pageSize: integer, The maximum number of items to return in a single page. By default 10 and at most 100.
+ pageToken: string, The next_page_token value returned from a previous list request.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -253,29 +193,14 @@
An object of the form:
{ # Response message for KnowledgeBases.ListKnowledgeBases.
+ "nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no more results in the list.
"knowledgeBases": [ # The list of knowledge bases.
- { # A knowledge base represents a collection of knowledge documents that you
- # provide to Dialogflow. Your knowledge documents contain information that may
- # be useful during conversations with end-users. Some Dialogflow features use
- # knowledge bases when looking for a response to an end-user input.
- #
- # For more information, see the [knowledge base
- # guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases).
- #
- # Note: The `projects.agent.knowledgeBases` resource is deprecated;
- # only use `projects.knowledgeBases`.
- "displayName": "A String", # Required. The display name of the knowledge base. The name must be 1024
- # bytes or less; otherwise, the creation request fails.
- "name": "A String", # The knowledge base resource name.
- # The name must be empty when creating a knowledge base.
- # Format: `projects/<Project ID>/knowledgeBases/<Knowledge Base ID>`.
- "languageCode": "A String", # Language which represents the KnowledgeBase. When the KnowledgeBase is
- # created/updated, this is populated for all non en-us languages. If not
- # populated, the default language en-us applies.
+ { # A knowledge base represents a collection of knowledge documents that you provide to Dialogflow. Your knowledge documents contain information that may be useful during conversations with end-users. Some Dialogflow features use knowledge bases when looking for a response to an end-user input. For more information, see the [knowledge base guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases). Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
+ "languageCode": "A String", # Language which represents the KnowledgeBase. When the KnowledgeBase is created/updated, this is populated for all non en-us languages. If not populated, the default language en-us applies.
+ "name": "A String", # The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`.
+ "displayName": "A String", # Required. The display name of the knowledge base. The name must be 1024 bytes or less; otherwise, the creation request fails.
},
],
- "nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no
- # more results in the list.
}</pre>
</div>
@@ -295,41 +220,20 @@
<div class="method">
<code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>
- <pre>Updates the specified knowledge base.
-
-Note: The `projects.agent.knowledgeBases` resource is deprecated;
-only use `projects.knowledgeBases`.
+ <pre>Updates the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
Args:
- name: string, The knowledge base resource name.
-The name must be empty when creating a knowledge base.
-Format: `projects/<Project ID>/knowledgeBases/<Knowledge Base ID>`. (required)
+ name: string, The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`. (required)
body: object, The request body.
The object takes the form of:
-{ # A knowledge base represents a collection of knowledge documents that you
- # provide to Dialogflow. Your knowledge documents contain information that may
- # be useful during conversations with end-users. Some Dialogflow features use
- # knowledge bases when looking for a response to an end-user input.
- #
- # For more information, see the [knowledge base
- # guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases).
- #
- # Note: The `projects.agent.knowledgeBases` resource is deprecated;
- # only use `projects.knowledgeBases`.
- "displayName": "A String", # Required. The display name of the knowledge base. The name must be 1024
- # bytes or less; otherwise, the creation request fails.
- "name": "A String", # The knowledge base resource name.
- # The name must be empty when creating a knowledge base.
- # Format: `projects/<Project ID>/knowledgeBases/<Knowledge Base ID>`.
- "languageCode": "A String", # Language which represents the KnowledgeBase. When the KnowledgeBase is
- # created/updated, this is populated for all non en-us languages. If not
- # populated, the default language en-us applies.
+{ # A knowledge base represents a collection of knowledge documents that you provide to Dialogflow. Your knowledge documents contain information that may be useful during conversations with end-users. Some Dialogflow features use knowledge bases when looking for a response to an end-user input. For more information, see the [knowledge base guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases). Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
+ "languageCode": "A String", # Language which represents the KnowledgeBase. When the KnowledgeBase is created/updated, this is populated for all non en-us languages. If not populated, the default language en-us applies.
+ "name": "A String", # The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`.
+ "displayName": "A String", # Required. The display name of the knowledge base. The name must be 1024 bytes or less; otherwise, the creation request fails.
}
- updateMask: string, Optional. Not specified means `update all`.
-Currently, only `display_name` can be updated, an InvalidArgument will be
-returned for attempting to update other fields.
+ updateMask: string, Optional. Not specified means `update all`. Currently, only `display_name` can be updated, an InvalidArgument will be returned for attempting to update other fields.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -338,24 +242,10 @@
Returns:
An object of the form:
- { # A knowledge base represents a collection of knowledge documents that you
- # provide to Dialogflow. Your knowledge documents contain information that may
- # be useful during conversations with end-users. Some Dialogflow features use
- # knowledge bases when looking for a response to an end-user input.
- #
- # For more information, see the [knowledge base
- # guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases).
- #
- # Note: The `projects.agent.knowledgeBases` resource is deprecated;
- # only use `projects.knowledgeBases`.
- "displayName": "A String", # Required. The display name of the knowledge base. The name must be 1024
- # bytes or less; otherwise, the creation request fails.
- "name": "A String", # The knowledge base resource name.
- # The name must be empty when creating a knowledge base.
- # Format: `projects/<Project ID>/knowledgeBases/<Knowledge Base ID>`.
- "languageCode": "A String", # Language which represents the KnowledgeBase. When the KnowledgeBase is
- # created/updated, this is populated for all non en-us languages. If not
- # populated, the default language en-us applies.
+ { # A knowledge base represents a collection of knowledge documents that you provide to Dialogflow. Your knowledge documents contain information that may be useful during conversations with end-users. Some Dialogflow features use knowledge bases when looking for a response to an end-user input. For more information, see the [knowledge base guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases). Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
+ "languageCode": "A String", # Language which represents the KnowledgeBase. When the KnowledgeBase is created/updated, this is populated for all non en-us languages. If not populated, the default language en-us applies.
+ "name": "A String", # The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`.
+ "displayName": "A String", # Required. The display name of the knowledge base. The name must be 1024 bytes or less; otherwise, the creation request fails.
}</pre>
</div>