feat: added location-aware HTTP path binding for ListIntents (#294)

PiperOrigin-RevId: 373895026

Source-Link: googleapis/googleapis@0d68bbb

Source-Link: googleapis/googleapis-gen@6acf4a0

Author: gcf-owl-bot[bot]

packages/google-cloud-dialogflow/google/cloud/dialogflow_v2/services/intents/async_client.py

@@ -181,7 +181,16 @@ async def list_intents(
                 [Intents.ListIntents][google.cloud.dialogflow.v2.Intents.ListIntents].
             parent (:class:`str`):
                 Required. The agent to list all intents from. Format:
-                ``projects/<Project ID>/agent``.
+                ``projects/<Project ID>/agent`` or
+                ``projects/<Project ID>/locations/<Location ID>/agent``.
+
+                Alternatively, you can specify the environment to list
+                intents for. Format:
+                ``projects/<Project ID>/agent/environments/<Environment ID>``
+                or
+                ``projects/<Project ID>/locations/<Location ID>/agent/environments/<Environment ID>``.
+                Note: training phrases of the intents will not be
+                returned for non-draft environment.
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this

packages/google-cloud-dialogflow/google/cloud/dialogflow_v2/services/intents/client.py

@@ -383,7 +383,16 @@ def list_intents(
                 [Intents.ListIntents][google.cloud.dialogflow.v2.Intents.ListIntents].
             parent (str):
                 Required. The agent to list all intents from. Format:
-                ``projects/<Project ID>/agent``.
+                ``projects/<Project ID>/agent`` or
+                ``projects/<Project ID>/locations/<Location ID>/agent``.
+
+                Alternatively, you can specify the environment to list
+                intents for. Format:
+                ``projects/<Project ID>/agent/environments/<Environment ID>``
+                or
+                ``projects/<Project ID>/locations/<Location ID>/agent/environments/<Environment ID>``.
+                Note: training phrases of the intents will not be
+                returned for non-draft environment.
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this

packages/google-cloud-dialogflow/google/cloud/dialogflow_v2/types/intent.py

@@ -1009,7 +1009,16 @@ class ListIntentsRequest(proto.Message):
     Attributes:
         parent (str):
             Required. The agent to list all intents from. Format:
-            ``projects/<Project ID>/agent``.
+            ``projects/<Project ID>/agent`` or
+            ``projects/<Project ID>/locations/<Location ID>/agent``.
+
+            Alternatively, you can specify the environment to list
+            intents for. Format:
+            ``projects/<Project ID>/agent/environments/<Environment ID>``
+            or
+            ``projects/<Project ID>/locations/<Location ID>/agent/environments/<Environment ID>``.
+            Note: training phrases of the intents will not be returned
+            for non-draft environment.
         language_code (str):
             Optional. The language used to access language-specific
             data. If not specified, the agent's default language is