commit d059ad881c7ae58c67931c48788d0bd7343ab16c
author Bu Sun Kim <8822365+busunkim96@users.noreply.github.com> Wed Jul 22 17:02:09 2020 -0700
committer GitHub <noreply@github.com> Wed Jul 22 17:02:09 2020 -0700
tree c2dda487c8702c56c65e9c6a18a63567db789f80
parent c72efbc6b71c963997c5728d471c04ab33d95e4f

docs: update generated docs (#981)

docs/dyn/dialogflow_v2beta1.projects.agent.environments.html

diff --git a/docs/dyn/dialogflow_v2beta1.projects.agent.environments.html b/docs/dyn/dialogflow_v2beta1.projects.agent.environments.html
index d9c2c0f..3637f0c 100644
--- a/docs/dyn/dialogflow_v2beta1.projects.agent.environments.html
+++ b/docs/dyn/dialogflow_v2beta1.projects.agent.environments.html
@@ -80,22 +80,25 @@
 <p class="firstline">Returns the users Resource.</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 non-draft environments of the specified agent.</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>
 <h3>Method Details</h3>
 <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 non-draft environments of the specified agent.
 
 Args:
   parent: string, Required. The agent to list all environments from.
-Format: `projects/&lt;Project ID&gt;/agent`. (required)
-  pageToken: string, Optional. The next_page_token value returned from a previous list request.
+Format:
+- `projects/&lt;Project Number / ID&gt;/agent`
+- `projects/&lt;Project Number / ID&gt;/locations/&lt;Location
+ID&gt;/agent (required)
   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
@@ -105,24 +108,43 @@
   An object of the form:
 
     { # The response message for Environments.ListEnvironments.
-    &quot;nextPageToken&quot;: &quot;A String&quot;, # Token to retrieve the next page of results, or empty if there are no
-        # more results in the list.
     &quot;environments&quot;: [ # The list of agent environments. There will be a maximum number of items
         # returned based on the page_size field in the request.
-      { # Represents an agent environment.
-        &quot;agentVersion&quot;: &quot;A String&quot;, # Optional. The agent version loaded into this environment.
-            # Format: `projects/&lt;Project ID&gt;/agent/versions/&lt;Version ID&gt;`.
+      { # You can create multiple versions of your agent and publish them to separate
+          # environments.
+          #
+          # When you edit an agent, you are editing the draft agent. At any point, you
+          # can save the draft agent as an agent version, which is an immutable snapshot
+          # of your agent.
+          #
+          # When you save the draft agent, it is published to the default environment.
+          # When you create agent versions, you can publish them to custom environments.
+          # You can create a variety of custom environments for:
+          #
+          # - testing
+          # - development
+          # - production
+          # - etc.
+          #
+          # For more information, see the [versions and environments
+          # guide](https://cloud.google.com/dialogflow/docs/agents-versions).
         &quot;state&quot;: &quot;A String&quot;, # Output only. The state of this environment. This field is read-only, i.e., it cannot be
             # set by create and update methods.
+        &quot;description&quot;: &quot;A String&quot;, # Optional. The developer-provided description for this environment.
+            # The maximum length is 500 characters. If exceeded, the request is rejected.
         &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The last update time of this environment. This field is read-only, i.e., it
             # cannot be set by create and update methods.
         &quot;name&quot;: &quot;A String&quot;, # Output only. The unique identifier of this agent environment.
-            # Format: `projects/&lt;Project ID&gt;/agent/environments/&lt;Environment ID&gt;`.
-            # For Environment ID, &quot;-&quot; is reserved for &#x27;draft&#x27; environment.
-        &quot;description&quot;: &quot;A String&quot;, # Optional. The developer-provided description for this environment.
-            # The maximum length is 500 characters. If exceeded, the request is rejected.
+            # Format:
+            # - `projects/&lt;Project Number / ID&gt;/agent/environments/&lt;Environment ID&gt;`
+            # - `projects/&lt;Project Number / ID&gt;/locations/&lt;Location
+            # ID&gt;/agent/environments/&lt;Environment ID&gt;`
+        &quot;agentVersion&quot;: &quot;A String&quot;, # Optional. The agent version loaded into this environment.
+            # Format: `projects/&lt;Project ID&gt;/agent/versions/&lt;Version ID&gt;`.
       },
     ],
+    &quot;nextPageToken&quot;: &quot;A String&quot;, # Token to retrieve the next page of results, or empty if there are no
+        # more results in the list.
   }</pre>
 </div>