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

PiperOrigin-RevId: 373895026 Source-Link: googleapis/googleapis@0d68bbb Source-Link: googleapis/googleapis-gen@6acf4a0
googleapis · May 15, 2021 · 1f71e77 · 1f71e77
1 parent a9f970c
commit 1f71e77
Show file tree

Hide file tree

Showing 3 changed files with 30 additions and 3 deletions.
diff --git a/google/cloud/dialogflow_v2/services/intents/async_client.py b/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

diff --git a/google/cloud/dialogflow_v2/services/intents/client.py b/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

diff --git a/google/cloud/dialogflow_v2/types/intent.py b/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