feat: expose Locations service to get/list avaliable locations of D…

…ialogflow products (#364)

PiperOrigin-RevId: 389905442

Source-Link: googleapis/googleapis@4c984f3

Source-Link: googleapis/googleapis-gen@ea3337a

feat: add language code to streaming recognition result
feat: add time zone and security settings to conversation profile
docs: fix validation result docs
docs: update environment docs
docs: update agent docs 
docs: update entity type docs 
docs: update intent docs

google/cloud/dialogflow_v2/services/agents/client.py

@@ -17,7 +17,7 @@
 from distutils import util
 import os
 import re
-from typing import Dict, Optional, Sequence, Tuple, Type, Union
+from typing import Callable, Dict, Optional, Sequence, Tuple, Type, Union
 import pkg_resources
 
 from google.api_core import client_options as client_options_lib  # type: ignore

google/cloud/dialogflow_v2/services/agents/transports/grpc.py

@@ -85,7 +85,7 @@ def __init__(
             api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
                 If provided, it overrides the ``host`` argument and tries to create
                 a mutual TLS channel with client SSL credentials from
-                ``client_cert_source`` or application default SSL credentials.
+                ``client_cert_source`` or applicatin default SSL credentials.
             client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]):
                 Deprecated. A callback to provide client SSL certificate bytes and
                 private key bytes, both in PEM format. It is ignored if

google/cloud/dialogflow_v2/services/agents/transports/grpc_asyncio.py

@@ -132,7 +132,7 @@ def __init__(
             api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
                 If provided, it overrides the ``host`` argument and tries to create
                 a mutual TLS channel with client SSL credentials from
-                ``client_cert_source`` or application default SSL credentials.
+                ``client_cert_source`` or applicatin default SSL credentials.
             client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]):
                 Deprecated. A callback to provide client SSL certificate bytes and
                 private key bytes, both in PEM format. It is ignored if

google/cloud/dialogflow_v2/services/answer_records/transports/grpc.py

@@ -82,7 +82,7 @@ def __init__(
             api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
                 If provided, it overrides the ``host`` argument and tries to create
                 a mutual TLS channel with client SSL credentials from
-                ``client_cert_source`` or application default SSL credentials.
+                ``client_cert_source`` or applicatin default SSL credentials.
             client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]):
                 Deprecated. A callback to provide client SSL certificate bytes and
                 private key bytes, both in PEM format. It is ignored if

google/cloud/dialogflow_v2/services/answer_records/transports/grpc_asyncio.py

@@ -129,7 +129,7 @@ def __init__(
             api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
                 If provided, it overrides the ``host`` argument and tries to create
                 a mutual TLS channel with client SSL credentials from
-                ``client_cert_source`` or application default SSL credentials.
+                ``client_cert_source`` or applicatin default SSL credentials.
             client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]):
                 Deprecated. A callback to provide client SSL certificate bytes and
                 private key bytes, both in PEM format. It is ignored if

google/cloud/dialogflow_v2/services/contexts/transports/grpc.py

@@ -82,7 +82,7 @@ def __init__(
             api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
                 If provided, it overrides the ``host`` argument and tries to create
                 a mutual TLS channel with client SSL credentials from
-                ``client_cert_source`` or application default SSL credentials.
+                ``client_cert_source`` or applicatin default SSL credentials.
             client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]):
                 Deprecated. A callback to provide client SSL certificate bytes and
                 private key bytes, both in PEM format. It is ignored if

google/cloud/dialogflow_v2/services/contexts/transports/grpc_asyncio.py

@@ -129,7 +129,7 @@ def __init__(
             api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
                 If provided, it overrides the ``host`` argument and tries to create
                 a mutual TLS channel with client SSL credentials from
-                ``client_cert_source`` or application default SSL credentials.
+                ``client_cert_source`` or applicatin default SSL credentials.
             client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]):
                 Deprecated. A callback to provide client SSL certificate bytes and
                 private key bytes, both in PEM format. It is ignored if

google/cloud/dialogflow_v2/services/conversation_profiles/transports/grpc.py

@@ -85,7 +85,7 @@ def __init__(
             api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
                 If provided, it overrides the ``host`` argument and tries to create
                 a mutual TLS channel with client SSL credentials from
-                ``client_cert_source`` or application default SSL credentials.
+                ``client_cert_source`` or applicatin default SSL credentials.
             client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]):
                 Deprecated. A callback to provide client SSL certificate bytes and
                 private key bytes, both in PEM format. It is ignored if

google/cloud/dialogflow_v2/services/conversation_profiles/transports/grpc_asyncio.py

@@ -132,7 +132,7 @@ def __init__(
             api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
                 If provided, it overrides the ``host`` argument and tries to create
                 a mutual TLS channel with client SSL credentials from
-                ``client_cert_source`` or application default SSL credentials.
+                ``client_cert_source`` or applicatin default SSL credentials.
             client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]):
                 Deprecated. A callback to provide client SSL certificate bytes and
                 private key bytes, both in PEM format. It is ignored if

google/cloud/dialogflow_v2/services/conversations/transports/grpc.py

@@ -82,7 +82,7 @@ def __init__(
             api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
                 If provided, it overrides the ``host`` argument and tries to create
                 a mutual TLS channel with client SSL credentials from
-                ``client_cert_source`` or application default SSL credentials.
+                ``client_cert_source`` or applicatin default SSL credentials.
             client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]):
                 Deprecated. A callback to provide client SSL certificate bytes and
                 private key bytes, both in PEM format. It is ignored if

google/cloud/dialogflow_v2/services/conversations/transports/grpc_asyncio.py

@@ -129,7 +129,7 @@ def __init__(
             api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
                 If provided, it overrides the ``host`` argument and tries to create
                 a mutual TLS channel with client SSL credentials from
-                ``client_cert_source`` or application default SSL credentials.
+                ``client_cert_source`` or applicatin default SSL credentials.
             client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]):
                 Deprecated. A callback to provide client SSL certificate bytes and
                 private key bytes, both in PEM format. It is ignored if

google/cloud/dialogflow_v2/services/documents/transports/grpc.py

@@ -84,7 +84,7 @@ def __init__(
             api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
                 If provided, it overrides the ``host`` argument and tries to create
                 a mutual TLS channel with client SSL credentials from
-                ``client_cert_source`` or application default SSL credentials.
+                ``client_cert_source`` or applicatin default SSL credentials.
             client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]):
                 Deprecated. A callback to provide client SSL certificate bytes and
                 private key bytes, both in PEM format. It is ignored if

google/cloud/dialogflow_v2/services/documents/transports/grpc_asyncio.py

@@ -131,7 +131,7 @@ def __init__(
             api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
                 If provided, it overrides the ``host`` argument and tries to create
                 a mutual TLS channel with client SSL credentials from
-                ``client_cert_source`` or application default SSL credentials.
+                ``client_cert_source`` or applicatin default SSL credentials.
             client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]):
                 Deprecated. A callback to provide client SSL certificate bytes and
                 private key bytes, both in PEM format. It is ignored if

google/cloud/dialogflow_v2/services/entity_types/transports/grpc.py

@@ -85,7 +85,7 @@ def __init__(
             api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
                 If provided, it overrides the ``host`` argument and tries to create
                 a mutual TLS channel with client SSL credentials from
-                ``client_cert_source`` or application default SSL credentials.
+                ``client_cert_source`` or applicatin default SSL credentials.
             client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]):
                 Deprecated. A callback to provide client SSL certificate bytes and
                 private key bytes, both in PEM format. It is ignored if

google/cloud/dialogflow_v2/services/entity_types/transports/grpc_asyncio.py

@@ -132,7 +132,7 @@ def __init__(
             api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
                 If provided, it overrides the ``host`` argument and tries to create
                 a mutual TLS channel with client SSL credentials from
-                ``client_cert_source`` or application default SSL credentials.
+                ``client_cert_source`` or applicatin default SSL credentials.
             client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]):
                 Deprecated. A callback to provide client SSL certificate bytes and
                 private key bytes, both in PEM format. It is ignored if

google/cloud/dialogflow_v2/services/environments/async_client.py

@@ -174,8 +174,8 @@ async def list_environments(
         timeout: float = None,
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> pagers.ListEnvironmentsAsyncPager:
-        r"""Returns the list of all non-draft environments of the
-        specified agent.
+        r"""Returns the list of all non-default environments of
+        the specified agent.
 
         Args:
             request (:class:`google.cloud.dialogflow_v2.types.ListEnvironmentsRequest`):
@@ -399,13 +399,14 @@ async def update_environment(
         environment. When an environment is pointed to a new agent
         version by setting ``environment.agent_version``, the
         environment is temporarily set to the ``LOADING`` state. During
-        that time, the environment keeps on serving the previous version
-        of the agent. After the new agent version is done loading, the
-        environment is set back to the ``RUNNING`` state. You can use
-        "-" as Environment ID in environment name to update version in
-        "draft" environment. WARNING: this will negate all recent
-        changes to draft and can't be undone. You may want to save the
-        draft to a version before calling this function.
+        that time, the environment continues serving the previous
+        version of the agent. After the new agent version is done
+        loading, the environment is set back to the ``RUNNING`` state.
+        You can use "-" as Environment ID in environment name to update
+        an agent version in the default environment. WARNING: this will
+        negate all recent changes to the draft agent and can't be
+        undone. You may want to save the draft agent to a version before
+        calling this method.
 
         Args:
             request (:class:`google.cloud.dialogflow_v2.types.UpdateEnvironmentRequest`):

google/cloud/dialogflow_v2/services/environments/client.py

@@ -386,8 +386,8 @@ def list_environments(
         timeout: float = None,
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> pagers.ListEnvironmentsPager:
-        r"""Returns the list of all non-draft environments of the
-        specified agent.
+        r"""Returns the list of all non-default environments of
+        the specified agent.
 
         Args:
             request (google.cloud.dialogflow_v2.types.ListEnvironmentsRequest):
@@ -613,13 +613,14 @@ def update_environment(
         environment. When an environment is pointed to a new agent
         version by setting ``environment.agent_version``, the
         environment is temporarily set to the ``LOADING`` state. During
-        that time, the environment keeps on serving the previous version
-        of the agent. After the new agent version is done loading, the
-        environment is set back to the ``RUNNING`` state. You can use
-        "-" as Environment ID in environment name to update version in
-        "draft" environment. WARNING: this will negate all recent
-        changes to draft and can't be undone. You may want to save the
-        draft to a version before calling this function.
+        that time, the environment continues serving the previous
+        version of the agent. After the new agent version is done
+        loading, the environment is set back to the ``RUNNING`` state.
+        You can use "-" as Environment ID in environment name to update
+        an agent version in the default environment. WARNING: this will
+        negate all recent changes to the draft agent and can't be
+        undone. You may want to save the draft agent to a version before
+        calling this method.
 
         Args:
             request (google.cloud.dialogflow_v2.types.UpdateEnvironmentRequest):

google/cloud/dialogflow_v2/services/environments/transports/grpc.py

@@ -82,7 +82,7 @@ def __init__(
             api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
                 If provided, it overrides the ``host`` argument and tries to create
                 a mutual TLS channel with client SSL credentials from
-                ``client_cert_source`` or application default SSL credentials.
+                ``client_cert_source`` or applicatin default SSL credentials.
             client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]):
                 Deprecated. A callback to provide client SSL certificate bytes and
                 private key bytes, both in PEM format. It is ignored if
@@ -235,8 +235,8 @@ def list_environments(
     ]:
         r"""Return a callable for the list environments method over gRPC.
 
-        Returns the list of all non-draft environments of the
-        specified agent.
+        Returns the list of all non-default environments of
+        the specified agent.
 
         Returns:
             Callable[[~.ListEnvironmentsRequest],
@@ -320,13 +320,14 @@ def update_environment(
         environment. When an environment is pointed to a new agent
         version by setting ``environment.agent_version``, the
         environment is temporarily set to the ``LOADING`` state. During
-        that time, the environment keeps on serving the previous version
-        of the agent. After the new agent version is done loading, the
-        environment is set back to the ``RUNNING`` state. You can use
-        "-" as Environment ID in environment name to update version in
-        "draft" environment. WARNING: this will negate all recent
-        changes to draft and can't be undone. You may want to save the
-        draft to a version before calling this function.
+        that time, the environment continues serving the previous
+        version of the agent. After the new agent version is done
+        loading, the environment is set back to the ``RUNNING`` state.
+        You can use "-" as Environment ID in environment name to update
+        an agent version in the default environment. WARNING: this will
+        negate all recent changes to the draft agent and can't be
+        undone. You may want to save the draft agent to a version before
+        calling this method.
 
         Returns:
             Callable[[~.UpdateEnvironmentRequest],

google/cloud/dialogflow_v2/services/environments/transports/grpc_asyncio.py

@@ -129,7 +129,7 @@ def __init__(
             api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
                 If provided, it overrides the ``host`` argument and tries to create
                 a mutual TLS channel with client SSL credentials from
-                ``client_cert_source`` or application default SSL credentials.
+                ``client_cert_source`` or applicatin default SSL credentials.
             client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]):
                 Deprecated. A callback to provide client SSL certificate bytes and
                 private key bytes, both in PEM format. It is ignored if
@@ -239,8 +239,8 @@ def list_environments(
     ]:
         r"""Return a callable for the list environments method over gRPC.
 
-        Returns the list of all non-draft environments of the
-        specified agent.
+        Returns the list of all non-default environments of
+        the specified agent.
 
         Returns:
             Callable[[~.ListEnvironmentsRequest],
@@ -330,13 +330,14 @@ def update_environment(
         environment. When an environment is pointed to a new agent
         version by setting ``environment.agent_version``, the
         environment is temporarily set to the ``LOADING`` state. During
-        that time, the environment keeps on serving the previous version
-        of the agent. After the new agent version is done loading, the
-        environment is set back to the ``RUNNING`` state. You can use
-        "-" as Environment ID in environment name to update version in
-        "draft" environment. WARNING: this will negate all recent
-        changes to draft and can't be undone. You may want to save the
-        draft to a version before calling this function.
+        that time, the environment continues serving the previous
+        version of the agent. After the new agent version is done
+        loading, the environment is set back to the ``RUNNING`` state.
+        You can use "-" as Environment ID in environment name to update
+        an agent version in the default environment. WARNING: this will
+        negate all recent changes to the draft agent and can't be
+        undone. You may want to save the draft agent to a version before
+        calling this method.
 
         Returns:
             Callable[[~.UpdateEnvironmentRequest],

google/cloud/dialogflow_v2/services/fulfillments/transports/grpc.py

@@ -82,7 +82,7 @@ def __init__(
             api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
                 If provided, it overrides the ``host`` argument and tries to create
                 a mutual TLS channel with client SSL credentials from
-                ``client_cert_source`` or application default SSL credentials.
+                ``client_cert_source`` or applicatin default SSL credentials.
             client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]):
                 Deprecated. A callback to provide client SSL certificate bytes and
                 private key bytes, both in PEM format. It is ignored if

google/cloud/dialogflow_v2/services/fulfillments/transports/grpc_asyncio.py

@@ -129,7 +129,7 @@ def __init__(
             api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
                 If provided, it overrides the ``host`` argument and tries to create
                 a mutual TLS channel with client SSL credentials from
-                ``client_cert_source`` or application default SSL credentials.
+                ``client_cert_source`` or applicatin default SSL credentials.
             client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]):
                 Deprecated. A callback to provide client SSL certificate bytes and
                 private key bytes, both in PEM format. It is ignored if

google/cloud/dialogflow_v2/services/intents/transports/grpc.py

@@ -84,7 +84,7 @@ def __init__(
             api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
                 If provided, it overrides the ``host`` argument and tries to create
                 a mutual TLS channel with client SSL credentials from
-                ``client_cert_source`` or application default SSL credentials.
+                ``client_cert_source`` or applicatin default SSL credentials.
             client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]):
                 Deprecated. A callback to provide client SSL certificate bytes and
                 private key bytes, both in PEM format. It is ignored if