docs: regenerate javadoc from protos (#224)

This PR was generated using Autosynth. 🌈

Synth log will be available here:
https://source.cloud.google.com/results/invocations/f7fe312d-54eb-4878-ac58-279f607f4132/targets

- [ ] To automatically regenerate this PR, check this box.

PiperOrigin-RevId: 317214667
Source-Link: googleapis/googleapis@4bb127d

README.md

@@ -17,7 +17,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file
     <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>libraries-bom</artifactId>
-      <version>5.7.0</version>
+      <version>7.0.0</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>

google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2beta1/AgentsClient.java

@@ -860,9 +860,16 @@ public final UnaryCallable<ExportAgentRequest, Operation> exportAgentCallable()
    * Imports the specified agent from a ZIP file.
    *
    * <p>Uploads new intents and entity types without deleting the existing ones. Intents and entity
-   * types with the same name are replaced with the new versions from ImportAgentRequest.
+   * types with the same name are replaced with the new versions from
+   * [ImportAgentRequest][google.cloud.dialogflow.v2beta1.ImportAgentRequest]. After the import, the
+   * imported draft agent will be trained automatically (unless disabled in agent settings).
+   * However, once the import is done, training may not be completed yet. Please call
+   * [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it
+   * returns in order to train explicitly.
    *
-   * <p>Operation &lt;response: [google.protobuf.Empty][google.protobuf.Empty]&gt;
+   * <p>Operation &lt;response: [google.protobuf.Empty][google.protobuf.Empty]&gt; An operation
+   * which tracks when importing is complete. It only tracks when the draft agent is updated not
+   * when it is done training.
    *
    * <p>Sample code:
    *
@@ -890,9 +897,16 @@ public final OperationFuture<Empty, Struct> importAgentAsync(ImportAgentRequest
    * Imports the specified agent from a ZIP file.
    *
    * <p>Uploads new intents and entity types without deleting the existing ones. Intents and entity
-   * types with the same name are replaced with the new versions from ImportAgentRequest.
+   * types with the same name are replaced with the new versions from
+   * [ImportAgentRequest][google.cloud.dialogflow.v2beta1.ImportAgentRequest]. After the import, the
+   * imported draft agent will be trained automatically (unless disabled in agent settings).
+   * However, once the import is done, training may not be completed yet. Please call
+   * [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it
+   * returns in order to train explicitly.
    *
-   * <p>Operation &lt;response: [google.protobuf.Empty][google.protobuf.Empty]&gt;
+   * <p>Operation &lt;response: [google.protobuf.Empty][google.protobuf.Empty]&gt; An operation
+   * which tracks when importing is complete. It only tracks when the draft agent is updated not
+   * when it is done training.
    *
    * <p>Sample code:
    *
@@ -918,9 +932,16 @@ public final OperationCallable<ImportAgentRequest, Empty, Struct> importAgentOpe
    * Imports the specified agent from a ZIP file.
    *
    * <p>Uploads new intents and entity types without deleting the existing ones. Intents and entity
-   * types with the same name are replaced with the new versions from ImportAgentRequest.
+   * types with the same name are replaced with the new versions from
+   * [ImportAgentRequest][google.cloud.dialogflow.v2beta1.ImportAgentRequest]. After the import, the
+   * imported draft agent will be trained automatically (unless disabled in agent settings).
+   * However, once the import is done, training may not be completed yet. Please call
+   * [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it
+   * returns in order to train explicitly.
    *
-   * <p>Operation &lt;response: [google.protobuf.Empty][google.protobuf.Empty]&gt;
+   * <p>Operation &lt;response: [google.protobuf.Empty][google.protobuf.Empty]&gt; An operation
+   * which tracks when importing is complete. It only tracks when the draft agent is updated not
+   * when it is done training.
    *
    * <p>Sample code:
    *
@@ -945,9 +966,15 @@ public final UnaryCallable<ImportAgentRequest, Operation> importAgentCallable()
    * Restores the specified agent from a ZIP file.
    *
    * <p>Replaces the current agent version with a new one. All the intents and entity types in the
-   * older version are deleted.
+   * older version are deleted. After the restore, the restored draft agent will be trained
+   * automatically (unless disabled in agent settings). However, once the restore is done, training
+   * may not be completed yet. Please call
+   * [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it
+   * returns in order to train explicitly.
    *
-   * <p>Operation &lt;response: [google.protobuf.Empty][google.protobuf.Empty]&gt;
+   * <p>Operation &lt;response: [google.protobuf.Empty][google.protobuf.Empty]&gt; An operation
+   * which tracks when restoring is complete. It only tracks when the draft agent is updated not
+   * when it is done training.
    *
    * <p>Sample code:
    *
@@ -975,9 +1002,15 @@ public final OperationFuture<Empty, Struct> restoreAgentAsync(RestoreAgentReques
    * Restores the specified agent from a ZIP file.
    *
    * <p>Replaces the current agent version with a new one. All the intents and entity types in the
-   * older version are deleted.
+   * older version are deleted. After the restore, the restored draft agent will be trained
+   * automatically (unless disabled in agent settings). However, once the restore is done, training
+   * may not be completed yet. Please call
+   * [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it
+   * returns in order to train explicitly.
    *
-   * <p>Operation &lt;response: [google.protobuf.Empty][google.protobuf.Empty]&gt;
+   * <p>Operation &lt;response: [google.protobuf.Empty][google.protobuf.Empty]&gt; An operation
+   * which tracks when restoring is complete. It only tracks when the draft agent is updated not
+   * when it is done training.
    *
    * <p>Sample code:
    *
@@ -1004,9 +1037,15 @@ public final OperationFuture<Empty, Struct> restoreAgentAsync(RestoreAgentReques
    * Restores the specified agent from a ZIP file.
    *
    * <p>Replaces the current agent version with a new one. All the intents and entity types in the
-   * older version are deleted.
-   *
-   * <p>Operation &lt;response: [google.protobuf.Empty][google.protobuf.Empty]&gt;
+   * older version are deleted. After the restore, the restored draft agent will be trained
+   * automatically (unless disabled in agent settings). However, once the restore is done, training
+   * may not be completed yet. Please call
+   * [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it
+   * returns in order to train explicitly.
+   *
+   * <p>Operation &lt;response: [google.protobuf.Empty][google.protobuf.Empty]&gt; An operation
+   * which tracks when restoring is complete. It only tracks when the draft agent is updated not
+   * when it is done training.
    *
    * <p>Sample code:
    *

grpc-google-cloud-dialogflow-v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/AgentsGrpc.java

@@ -622,8 +622,14 @@ public void exportAgent(
      * Imports the specified agent from a ZIP file.
      * Uploads new intents and entity types without deleting the existing ones.
      * Intents and entity types with the same name are replaced with the new
-     * versions from ImportAgentRequest.
+     * versions from [ImportAgentRequest][google.cloud.dialogflow.v2beta1.ImportAgentRequest]. After the import, the imported draft
+     * agent will be trained automatically (unless disabled in agent settings).
+     * However, once the import is done, training may not be completed yet. Please
+     * call [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it returns in order to train
+     * explicitly.
      * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * An operation which tracks when importing is complete. It only tracks
+     * when the draft agent is updated not when it is done training.
      * </pre>
      */
     public void importAgent(
@@ -638,8 +644,14 @@ public void importAgent(
      * <pre>
      * Restores the specified agent from a ZIP file.
      * Replaces the current agent version with a new one. All the intents and
-     * entity types in the older version are deleted.
+     * entity types in the older version are deleted. After the restore, the
+     * restored draft agent will be trained automatically (unless disabled in
+     * agent settings). However, once the restore is done, training may not be
+     * completed yet. Please call [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it
+     * returns in order to train explicitly.
      * Operation &lt;response: [google.protobuf.Empty][google.protobuf.Empty]&gt;
+     * An operation which tracks when restoring is complete. It only tracks
+     * when the draft agent is updated not when it is done training.
      * </pre>
      */
     public void restoreAgent(
@@ -870,8 +882,14 @@ public void exportAgent(
      * Imports the specified agent from a ZIP file.
      * Uploads new intents and entity types without deleting the existing ones.
      * Intents and entity types with the same name are replaced with the new
-     * versions from ImportAgentRequest.
+     * versions from [ImportAgentRequest][google.cloud.dialogflow.v2beta1.ImportAgentRequest]. After the import, the imported draft
+     * agent will be trained automatically (unless disabled in agent settings).
+     * However, once the import is done, training may not be completed yet. Please
+     * call [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it returns in order to train
+     * explicitly.
      * Operation &lt;response: [google.protobuf.Empty][google.protobuf.Empty]&gt;
+     * An operation which tracks when importing is complete. It only tracks
+     * when the draft agent is updated not when it is done training.
      * </pre>
      */
     public void importAgent(
@@ -889,8 +907,14 @@ public void importAgent(
      * <pre>
      * Restores the specified agent from a ZIP file.
      * Replaces the current agent version with a new one. All the intents and
-     * entity types in the older version are deleted.
+     * entity types in the older version are deleted. After the restore, the
+     * restored draft agent will be trained automatically (unless disabled in
+     * agent settings). However, once the restore is done, training may not be
+     * completed yet. Please call [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it
+     * returns in order to train explicitly.
      * Operation &lt;response: [google.protobuf.Empty][google.protobuf.Empty]&gt;
+     * An operation which tracks when restoring is complete. It only tracks
+     * when the draft agent is updated not when it is done training.
      * </pre>
      */
     public void restoreAgent(
@@ -1047,8 +1071,14 @@ public com.google.longrunning.Operation exportAgent(
      * Imports the specified agent from a ZIP file.
      * Uploads new intents and entity types without deleting the existing ones.
      * Intents and entity types with the same name are replaced with the new
-     * versions from ImportAgentRequest.
+     * versions from [ImportAgentRequest][google.cloud.dialogflow.v2beta1.ImportAgentRequest]. After the import, the imported draft
+     * agent will be trained automatically (unless disabled in agent settings).
+     * However, once the import is done, training may not be completed yet. Please
+     * call [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it returns in order to train
+     * explicitly.
      * Operation &lt;response: [google.protobuf.Empty][google.protobuf.Empty]&gt;
+     * An operation which tracks when importing is complete. It only tracks
+     * when the draft agent is updated not when it is done training.
      * </pre>
      */
     public com.google.longrunning.Operation importAgent(
@@ -1062,8 +1092,14 @@ public com.google.longrunning.Operation importAgent(
      * <pre>
      * Restores the specified agent from a ZIP file.
      * Replaces the current agent version with a new one. All the intents and
-     * entity types in the older version are deleted.
+     * entity types in the older version are deleted. After the restore, the
+     * restored draft agent will be trained automatically (unless disabled in
+     * agent settings). However, once the restore is done, training may not be
+     * completed yet. Please call [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it
+     * returns in order to train explicitly.
      * Operation &lt;response: [google.protobuf.Empty][google.protobuf.Empty]&gt;
+     * An operation which tracks when restoring is complete. It only tracks
+     * when the draft agent is updated not when it is done training.
      * </pre>
      */
     public com.google.longrunning.Operation restoreAgent(
@@ -1219,8 +1255,14 @@ protected AgentsFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions ca
      * Imports the specified agent from a ZIP file.
      * Uploads new intents and entity types without deleting the existing ones.
      * Intents and entity types with the same name are replaced with the new
-     * versions from ImportAgentRequest.
+     * versions from [ImportAgentRequest][google.cloud.dialogflow.v2beta1.ImportAgentRequest]. After the import, the imported draft
+     * agent will be trained automatically (unless disabled in agent settings).
+     * However, once the import is done, training may not be completed yet. Please
+     * call [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it returns in order to train
+     * explicitly.
      * Operation &lt;response: [google.protobuf.Empty][google.protobuf.Empty]&gt;
+     * An operation which tracks when importing is complete. It only tracks
+     * when the draft agent is updated not when it is done training.
      * </pre>
      */
     public com.google.common.util.concurrent.ListenableFuture<com.google.longrunning.Operation>
@@ -1235,8 +1277,14 @@ protected AgentsFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions ca
      * <pre>
      * Restores the specified agent from a ZIP file.
      * Replaces the current agent version with a new one. All the intents and
-     * entity types in the older version are deleted.
+     * entity types in the older version are deleted. After the restore, the
+     * restored draft agent will be trained automatically (unless disabled in
+     * agent settings). However, once the restore is done, training may not be
+     * completed yet. Please call [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it
+     * returns in order to train explicitly.
      * Operation &lt;response: [google.protobuf.Empty][google.protobuf.Empty]&gt;
+     * An operation which tracks when restoring is complete. It only tracks
+     * when the draft agent is updated not when it is done training.
      * </pre>
      */
     public com.google.common.util.concurrent.ListenableFuture<com.google.longrunning.Operation>