docs: update generated docs (#981)
diff --git a/docs/dyn/dialogflow_v2.projects.agent.environments.users.sessions.contexts.html b/docs/dyn/dialogflow_v2.projects.agent.environments.users.sessions.contexts.html
index 2867dc1..da00997 100644
--- a/docs/dyn/dialogflow_v2.projects.agent.environments.users.sessions.contexts.html
+++ b/docs/dyn/dialogflow_v2.projects.agent.environments.users.sessions.contexts.html
@@ -84,7 +84,7 @@
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Retrieves the specified context.</p>
<p class="toc_element">
- <code><a href="#list">list(parent, pageToken=None, pageSize=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
<p class="firstline">Returns the list of all contexts in the specified session.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -109,28 +109,21 @@
body: object, The request body.
The object takes the form of:
-{ # Represents a context.
- "lifespanCount": 42, # Optional. The number of conversational query requests after which the
- # context expires. The default is `0`. If set to `0`, the context expires
- # immediately. Contexts expire automatically after 20 minutes if there
- # are no matching queries.
- "name": "A String", # Required. The unique identifier of the context. Format:
- # `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`,
- # or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
- # ID>/sessions/<Session ID>/contexts/<Context ID>`.
- #
- # The `Context ID` is always converted to lowercase, may only contain
- # characters in a-zA-Z0-9_-% and may be at most 250 bytes long.
- #
- # If `Environment ID` is not specified, we assume default 'draft'
- # environment. If `User ID` is not specified, we assume default '-' user.
- #
- # The following context names are reserved for internal use by Dialogflow.
- # You should not use these contexts or create contexts with these names:
- #
- # * `__system_counters__`
- # * `*_id_dialog_context`
- # * `*_dialog_params_size`
+{ # Dialogflow contexts are similar to natural language context. If a person says
+ # to you "they are orange", you need context in order to understand what "they"
+ # is referring to. Similarly, for Dialogflow to handle an end-user expression
+ # like that, it needs to be provided with context in order to correctly match
+ # an intent.
+ #
+ # Using contexts, you can control the flow of a conversation. You can configure
+ # contexts for an intent by setting input and output contexts, which are
+ # identified by string names. When an intent is matched, any configured output
+ # contexts for that intent become active. While any contexts are active,
+ # Dialogflow is more likely to match intents that are configured with input
+ # contexts that correspond to the currently active contexts.
+ #
+ # For more information about context, see the
+ # [Contexts guide](https://cloud.google.com/dialogflow/docs/contexts-overview).
"parameters": { # Optional. The collection of parameters associated with this context.
#
# Depending on your protocol or client library language, this is a
@@ -148,6 +141,27 @@
# - Else: parameter value
"a_key": "", # Properties of the object.
},
+ "name": "A String", # Required. The unique identifier of the context. Format:
+ # `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`,
+ # or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
+ # ID>/sessions/<Session ID>/contexts/<Context ID>`.
+ #
+ # The `Context ID` is always converted to lowercase, may only contain
+ # characters in a-zA-Z0-9_-% and may be at most 250 bytes long.
+ #
+ # If `Environment ID` is not specified, we assume default 'draft'
+ # environment. If `User ID` is not specified, we assume default '-' user.
+ #
+ # The following context names are reserved for internal use by Dialogflow.
+ # You should not use these contexts or create contexts with these names:
+ #
+ # * `__system_counters__`
+ # * `*_id_dialog_context`
+ # * `*_dialog_params_size`
+ "lifespanCount": 42, # Optional. The number of conversational query requests after which the
+ # context expires. The default is `0`. If set to `0`, the context expires
+ # immediately. Contexts expire automatically after 20 minutes if there
+ # are no matching queries.
}
x__xgafv: string, V1 error format.
@@ -158,28 +172,21 @@
Returns:
An object of the form:
- { # Represents a context.
- "lifespanCount": 42, # Optional. The number of conversational query requests after which the
- # context expires. The default is `0`. If set to `0`, the context expires
- # immediately. Contexts expire automatically after 20 minutes if there
- # are no matching queries.
- "name": "A String", # Required. The unique identifier of the context. Format:
- # `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`,
- # or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
- # ID>/sessions/<Session ID>/contexts/<Context ID>`.
- #
- # The `Context ID` is always converted to lowercase, may only contain
- # characters in a-zA-Z0-9_-% and may be at most 250 bytes long.
- #
- # If `Environment ID` is not specified, we assume default 'draft'
- # environment. If `User ID` is not specified, we assume default '-' user.
- #
- # The following context names are reserved for internal use by Dialogflow.
- # You should not use these contexts or create contexts with these names:
- #
- # * `__system_counters__`
- # * `*_id_dialog_context`
- # * `*_dialog_params_size`
+ { # Dialogflow contexts are similar to natural language context. If a person says
+ # to you "they are orange", you need context in order to understand what "they"
+ # is referring to. Similarly, for Dialogflow to handle an end-user expression
+ # like that, it needs to be provided with context in order to correctly match
+ # an intent.
+ #
+ # Using contexts, you can control the flow of a conversation. You can configure
+ # contexts for an intent by setting input and output contexts, which are
+ # identified by string names. When an intent is matched, any configured output
+ # contexts for that intent become active. While any contexts are active,
+ # Dialogflow is more likely to match intents that are configured with input
+ # contexts that correspond to the currently active contexts.
+ #
+ # For more information about context, see the
+ # [Contexts guide](https://cloud.google.com/dialogflow/docs/contexts-overview).
"parameters": { # Optional. The collection of parameters associated with this context.
#
# Depending on your protocol or client library language, this is a
@@ -197,6 +204,27 @@
# - Else: parameter value
"a_key": "", # Properties of the object.
},
+ "name": "A String", # Required. The unique identifier of the context. Format:
+ # `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`,
+ # or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
+ # ID>/sessions/<Session ID>/contexts/<Context ID>`.
+ #
+ # The `Context ID` is always converted to lowercase, may only contain
+ # characters in a-zA-Z0-9_-% and may be at most 250 bytes long.
+ #
+ # If `Environment ID` is not specified, we assume default 'draft'
+ # environment. If `User ID` is not specified, we assume default '-' user.
+ #
+ # The following context names are reserved for internal use by Dialogflow.
+ # You should not use these contexts or create contexts with these names:
+ #
+ # * `__system_counters__`
+ # * `*_id_dialog_context`
+ # * `*_dialog_params_size`
+ "lifespanCount": 42, # Optional. The number of conversational query requests after which the
+ # context expires. The default is `0`. If set to `0`, the context expires
+ # immediately. Contexts expire automatically after 20 minutes if there
+ # are no matching queries.
}</pre>
</div>
@@ -250,28 +278,21 @@
Returns:
An object of the form:
- { # Represents a context.
- "lifespanCount": 42, # Optional. The number of conversational query requests after which the
- # context expires. The default is `0`. If set to `0`, the context expires
- # immediately. Contexts expire automatically after 20 minutes if there
- # are no matching queries.
- "name": "A String", # Required. The unique identifier of the context. Format:
- # `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`,
- # or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
- # ID>/sessions/<Session ID>/contexts/<Context ID>`.
- #
- # The `Context ID` is always converted to lowercase, may only contain
- # characters in a-zA-Z0-9_-% and may be at most 250 bytes long.
- #
- # If `Environment ID` is not specified, we assume default 'draft'
- # environment. If `User ID` is not specified, we assume default '-' user.
- #
- # The following context names are reserved for internal use by Dialogflow.
- # You should not use these contexts or create contexts with these names:
- #
- # * `__system_counters__`
- # * `*_id_dialog_context`
- # * `*_dialog_params_size`
+ { # Dialogflow contexts are similar to natural language context. If a person says
+ # to you "they are orange", you need context in order to understand what "they"
+ # is referring to. Similarly, for Dialogflow to handle an end-user expression
+ # like that, it needs to be provided with context in order to correctly match
+ # an intent.
+ #
+ # Using contexts, you can control the flow of a conversation. You can configure
+ # contexts for an intent by setting input and output contexts, which are
+ # identified by string names. When an intent is matched, any configured output
+ # contexts for that intent become active. While any contexts are active,
+ # Dialogflow is more likely to match intents that are configured with input
+ # contexts that correspond to the currently active contexts.
+ #
+ # For more information about context, see the
+ # [Contexts guide](https://cloud.google.com/dialogflow/docs/contexts-overview).
"parameters": { # Optional. The collection of parameters associated with this context.
#
# Depending on your protocol or client library language, this is a
@@ -289,11 +310,32 @@
# - Else: parameter value
"a_key": "", # Properties of the object.
},
+ "name": "A String", # Required. The unique identifier of the context. Format:
+ # `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`,
+ # or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
+ # ID>/sessions/<Session ID>/contexts/<Context ID>`.
+ #
+ # The `Context ID` is always converted to lowercase, may only contain
+ # characters in a-zA-Z0-9_-% and may be at most 250 bytes long.
+ #
+ # If `Environment ID` is not specified, we assume default 'draft'
+ # environment. If `User ID` is not specified, we assume default '-' user.
+ #
+ # The following context names are reserved for internal use by Dialogflow.
+ # You should not use these contexts or create contexts with these names:
+ #
+ # * `__system_counters__`
+ # * `*_id_dialog_context`
+ # * `*_dialog_params_size`
+ "lifespanCount": 42, # Optional. The number of conversational query requests after which the
+ # context expires. The default is `0`. If set to `0`, the context expires
+ # immediately. Contexts expire automatically after 20 minutes if there
+ # are no matching queries.
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(parent, pageToken=None, pageSize=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
<pre>Returns the list of all contexts in the specified session.
Args:
@@ -303,9 +345,9 @@
ID>/sessions/<Session ID>`.
If `Environment ID` is not specified, we assume default 'draft'
environment. If `User ID` is not specified, we assume default '-' user. (required)
- pageToken: string, Optional. The next_page_token value returned from a previous list request.
pageSize: integer, Optional. The maximum number of items to return in a single page. By
default 100 and at most 1000.
+ pageToken: string, Optional. The next_page_token value returned from a previous list request.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -315,30 +357,25 @@
An object of the form:
{ # The response message for Contexts.ListContexts.
+ "nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no
+ # more results in the list.
"contexts": [ # The list of contexts. There will be a maximum number of items
# returned based on the page_size field in the request.
- { # Represents a context.
- "lifespanCount": 42, # Optional. The number of conversational query requests after which the
- # context expires. The default is `0`. If set to `0`, the context expires
- # immediately. Contexts expire automatically after 20 minutes if there
- # are no matching queries.
- "name": "A String", # Required. The unique identifier of the context. Format:
- # `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`,
- # or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
- # ID>/sessions/<Session ID>/contexts/<Context ID>`.
- #
- # The `Context ID` is always converted to lowercase, may only contain
- # characters in a-zA-Z0-9_-% and may be at most 250 bytes long.
- #
- # If `Environment ID` is not specified, we assume default 'draft'
- # environment. If `User ID` is not specified, we assume default '-' user.
- #
- # The following context names are reserved for internal use by Dialogflow.
- # You should not use these contexts or create contexts with these names:
- #
- # * `__system_counters__`
- # * `*_id_dialog_context`
- # * `*_dialog_params_size`
+ { # Dialogflow contexts are similar to natural language context. If a person says
+ # to you "they are orange", you need context in order to understand what "they"
+ # is referring to. Similarly, for Dialogflow to handle an end-user expression
+ # like that, it needs to be provided with context in order to correctly match
+ # an intent.
+ #
+ # Using contexts, you can control the flow of a conversation. You can configure
+ # contexts for an intent by setting input and output contexts, which are
+ # identified by string names. When an intent is matched, any configured output
+ # contexts for that intent become active. While any contexts are active,
+ # Dialogflow is more likely to match intents that are configured with input
+ # contexts that correspond to the currently active contexts.
+ #
+ # For more information about context, see the
+ # [Contexts guide](https://cloud.google.com/dialogflow/docs/contexts-overview).
"parameters": { # Optional. The collection of parameters associated with this context.
#
# Depending on your protocol or client library language, this is a
@@ -356,10 +393,29 @@
# - Else: parameter value
"a_key": "", # Properties of the object.
},
+ "name": "A String", # Required. The unique identifier of the context. Format:
+ # `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`,
+ # or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
+ # ID>/sessions/<Session ID>/contexts/<Context ID>`.
+ #
+ # The `Context ID` is always converted to lowercase, may only contain
+ # characters in a-zA-Z0-9_-% and may be at most 250 bytes long.
+ #
+ # If `Environment ID` is not specified, we assume default 'draft'
+ # environment. If `User ID` is not specified, we assume default '-' user.
+ #
+ # The following context names are reserved for internal use by Dialogflow.
+ # You should not use these contexts or create contexts with these names:
+ #
+ # * `__system_counters__`
+ # * `*_id_dialog_context`
+ # * `*_dialog_params_size`
+ "lifespanCount": 42, # Optional. The number of conversational query requests after which the
+ # context expires. The default is `0`. If set to `0`, the context expires
+ # immediately. Contexts expire automatically after 20 minutes if there
+ # are no matching queries.
},
],
- "nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no
- # more results in the list.
}</pre>
</div>
@@ -402,28 +458,21 @@
body: object, The request body.
The object takes the form of:
-{ # Represents a context.
- "lifespanCount": 42, # Optional. The number of conversational query requests after which the
- # context expires. The default is `0`. If set to `0`, the context expires
- # immediately. Contexts expire automatically after 20 minutes if there
- # are no matching queries.
- "name": "A String", # Required. The unique identifier of the context. Format:
- # `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`,
- # or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
- # ID>/sessions/<Session ID>/contexts/<Context ID>`.
- #
- # The `Context ID` is always converted to lowercase, may only contain
- # characters in a-zA-Z0-9_-% and may be at most 250 bytes long.
- #
- # If `Environment ID` is not specified, we assume default 'draft'
- # environment. If `User ID` is not specified, we assume default '-' user.
- #
- # The following context names are reserved for internal use by Dialogflow.
- # You should not use these contexts or create contexts with these names:
- #
- # * `__system_counters__`
- # * `*_id_dialog_context`
- # * `*_dialog_params_size`
+{ # Dialogflow contexts are similar to natural language context. If a person says
+ # to you "they are orange", you need context in order to understand what "they"
+ # is referring to. Similarly, for Dialogflow to handle an end-user expression
+ # like that, it needs to be provided with context in order to correctly match
+ # an intent.
+ #
+ # Using contexts, you can control the flow of a conversation. You can configure
+ # contexts for an intent by setting input and output contexts, which are
+ # identified by string names. When an intent is matched, any configured output
+ # contexts for that intent become active. While any contexts are active,
+ # Dialogflow is more likely to match intents that are configured with input
+ # contexts that correspond to the currently active contexts.
+ #
+ # For more information about context, see the
+ # [Contexts guide](https://cloud.google.com/dialogflow/docs/contexts-overview).
"parameters": { # Optional. The collection of parameters associated with this context.
#
# Depending on your protocol or client library language, this is a
@@ -441,6 +490,27 @@
# - Else: parameter value
"a_key": "", # Properties of the object.
},
+ "name": "A String", # Required. The unique identifier of the context. Format:
+ # `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`,
+ # or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
+ # ID>/sessions/<Session ID>/contexts/<Context ID>`.
+ #
+ # The `Context ID` is always converted to lowercase, may only contain
+ # characters in a-zA-Z0-9_-% and may be at most 250 bytes long.
+ #
+ # If `Environment ID` is not specified, we assume default 'draft'
+ # environment. If `User ID` is not specified, we assume default '-' user.
+ #
+ # The following context names are reserved for internal use by Dialogflow.
+ # You should not use these contexts or create contexts with these names:
+ #
+ # * `__system_counters__`
+ # * `*_id_dialog_context`
+ # * `*_dialog_params_size`
+ "lifespanCount": 42, # Optional. The number of conversational query requests after which the
+ # context expires. The default is `0`. If set to `0`, the context expires
+ # immediately. Contexts expire automatically after 20 minutes if there
+ # are no matching queries.
}
updateMask: string, Optional. The mask to control which fields get updated.
@@ -452,28 +522,21 @@
Returns:
An object of the form:
- { # Represents a context.
- "lifespanCount": 42, # Optional. The number of conversational query requests after which the
- # context expires. The default is `0`. If set to `0`, the context expires
- # immediately. Contexts expire automatically after 20 minutes if there
- # are no matching queries.
- "name": "A String", # Required. The unique identifier of the context. Format:
- # `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`,
- # or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
- # ID>/sessions/<Session ID>/contexts/<Context ID>`.
- #
- # The `Context ID` is always converted to lowercase, may only contain
- # characters in a-zA-Z0-9_-% and may be at most 250 bytes long.
- #
- # If `Environment ID` is not specified, we assume default 'draft'
- # environment. If `User ID` is not specified, we assume default '-' user.
- #
- # The following context names are reserved for internal use by Dialogflow.
- # You should not use these contexts or create contexts with these names:
- #
- # * `__system_counters__`
- # * `*_id_dialog_context`
- # * `*_dialog_params_size`
+ { # Dialogflow contexts are similar to natural language context. If a person says
+ # to you "they are orange", you need context in order to understand what "they"
+ # is referring to. Similarly, for Dialogflow to handle an end-user expression
+ # like that, it needs to be provided with context in order to correctly match
+ # an intent.
+ #
+ # Using contexts, you can control the flow of a conversation. You can configure
+ # contexts for an intent by setting input and output contexts, which are
+ # identified by string names. When an intent is matched, any configured output
+ # contexts for that intent become active. While any contexts are active,
+ # Dialogflow is more likely to match intents that are configured with input
+ # contexts that correspond to the currently active contexts.
+ #
+ # For more information about context, see the
+ # [Contexts guide](https://cloud.google.com/dialogflow/docs/contexts-overview).
"parameters": { # Optional. The collection of parameters associated with this context.
#
# Depending on your protocol or client library language, this is a
@@ -491,6 +554,27 @@
# - Else: parameter value
"a_key": "", # Properties of the object.
},
+ "name": "A String", # Required. The unique identifier of the context. Format:
+ # `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`,
+ # or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
+ # ID>/sessions/<Session ID>/contexts/<Context ID>`.
+ #
+ # The `Context ID` is always converted to lowercase, may only contain
+ # characters in a-zA-Z0-9_-% and may be at most 250 bytes long.
+ #
+ # If `Environment ID` is not specified, we assume default 'draft'
+ # environment. If `User ID` is not specified, we assume default '-' user.
+ #
+ # The following context names are reserved for internal use by Dialogflow.
+ # You should not use these contexts or create contexts with these names:
+ #
+ # * `__system_counters__`
+ # * `*_id_dialog_context`
+ # * `*_dialog_params_size`
+ "lifespanCount": 42, # Optional. The number of conversational query requests after which the
+ # context expires. The default is `0`. If set to `0`, the context expires
+ # immediately. Contexts expire automatically after 20 minutes if there
+ # are no matching queries.
}</pre>
</div>