docs(v2): update generated javadocs from proto annotations

googleapis/googleapis@3d52f3c commit 3d52f3c126fbfc31f067a7f54737b7f0dfbce163 Author: Google APIs <noreply@google.com> Date: Fri Apr 3 09:48:52 2020 -0700 Dialogflow weekly v2 library update: - Change `parent` field's resource_reference to specify child_type instead of type per client library generation requirement; - Change Session with its child resource pattern to support both projects/{project}/agent/sessions/{session} and projects/{project}/agent/environments/{environment}/users/{user}/sessions/{session}; - Fix `method_signature` - Regular documentation update Important updates are also posted at: https://cloud.google.com/dialogflow/docs/release-notes PiperOrigin-RevId: 304635286
googleapis · Apr 6, 2020 · cc93b16 · cc93b16
1 parent fdd9453
commit cc93b16
Show file tree

Hide file tree

Showing 60 changed files with 2,028 additions and 2,262 deletions.
diff --git a/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/EntityTypesClient.java b/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/EntityTypesClient.java
@@ -264,10 +264,10 @@ public final ListEntityTypesPagedResponse listEntityTypes(String parent) {
    *
    * @param parent Required. The agent to list all entity types from. Format: `projects/&lt;Project
    *     ID&gt;/agent`.
-   * @param languageCode Optional. The language to list entity synonyms for. If not specified, the
-   *     agent's default language is used. [Many
-   *     languages](https://cloud.google.com/dialogflow/docs/reference/language) are supported.
-   *     Note: languages must be enabled in the agent before they can be used.
+   * @param languageCode Optional. The language used to access language-specific data. If not
+   *     specified, the agent's default language is used. For more information, see [Multilingual
+   *     intent and entity
+   *     data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final ListEntityTypesPagedResponse listEntityTypes(
@@ -298,10 +298,10 @@ public final ListEntityTypesPagedResponse listEntityTypes(
    *
    * @param parent Required. The agent to list all entity types from. Format: `projects/&lt;Project
    *     ID&gt;/agent`.
-   * @param languageCode Optional. The language to list entity synonyms for. If not specified, the
-   *     agent's default language is used. [Many
-   *     languages](https://cloud.google.com/dialogflow/docs/reference/language) are supported.
-   *     Note: languages must be enabled in the agent before they can be used.
+   * @param languageCode Optional. The language used to access language-specific data. If not
+   *     specified, the agent's default language is used. For more information, see [Multilingual
+   *     intent and entity
+   *     data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final ListEntityTypesPagedResponse listEntityTypes(String parent, String languageCode) {
@@ -453,10 +453,10 @@ public final EntityType getEntityType(String name) {
    *
    * @param name Required. The name of the entity type. Format: `projects/&lt;Project
    *     ID&gt;/agent/entityTypes/&lt;EntityType ID&gt;`.
-   * @param languageCode Optional. The language to retrieve entity synonyms for. If not specified,
-   *     the agent's default language is used. [Many
-   *     languages](https://cloud.google.com/dialogflow/docs/reference/language) are supported.
-   *     Note: languages must be enabled in the agent before they can be used.
+   * @param languageCode Optional. The language used to access language-specific data. If not
+   *     specified, the agent's default language is used. For more information, see [Multilingual
+   *     intent and entity
+   *     data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final EntityType getEntityType(EntityTypeName name, String languageCode) {
@@ -484,10 +484,10 @@ public final EntityType getEntityType(EntityTypeName name, String languageCode)
    *
    * @param name Required. The name of the entity type. Format: `projects/&lt;Project
    *     ID&gt;/agent/entityTypes/&lt;EntityType ID&gt;`.
-   * @param languageCode Optional. The language to retrieve entity synonyms for. If not specified,
-   *     the agent's default language is used. [Many
-   *     languages](https://cloud.google.com/dialogflow/docs/reference/language) are supported.
-   *     Note: languages must be enabled in the agent before they can be used.
+   * @param languageCode Optional. The language used to access language-specific data. If not
+   *     specified, the agent's default language is used. For more information, see [Multilingual
+   *     intent and entity
+   *     data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final EntityType getEntityType(String name, String languageCode) {
@@ -612,10 +612,10 @@ public final EntityType createEntityType(String parent, EntityType entityType) {
    * @param parent Required. The agent to create a entity type for. Format: `projects/&lt;Project
    *     ID&gt;/agent`.
    * @param entityType Required. The entity type to create.
-   * @param languageCode Optional. The language of entity synonyms defined in `entity_type`. If not
-   *     specified, the agent's default language is used. [Many
-   *     languages](https://cloud.google.com/dialogflow/docs/reference/language) are supported.
-   *     Note: languages must be enabled in the agent before they can be used.
+   * @param languageCode Optional. The language used to access language-specific data. If not
+   *     specified, the agent's default language is used. For more information, see [Multilingual
+   *     intent and entity
+   *     data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final EntityType createEntityType(
@@ -647,10 +647,10 @@ public final EntityType createEntityType(
    * @param parent Required. The agent to create a entity type for. Format: `projects/&lt;Project
    *     ID&gt;/agent`.
    * @param entityType Required. The entity type to create.
-   * @param languageCode Optional. The language of entity synonyms defined in `entity_type`. If not
-   *     specified, the agent's default language is used. [Many
-   *     languages](https://cloud.google.com/dialogflow/docs/reference/language) are supported.
-   *     Note: languages must be enabled in the agent before they can be used.
+   * @param languageCode Optional. The language used to access language-specific data. If not
+   *     specified, the agent's default language is used. For more information, see [Multilingual
+   *     intent and entity
+   *     data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final EntityType createEntityType(
@@ -750,10 +750,10 @@ public final EntityType updateEntityType(EntityType entityType) {
    * </code></pre>
    *
    * @param entityType Required. The entity type to update.
-   * @param languageCode Optional. The language of entity synonyms defined in `entity_type`. If not
-   *     specified, the agent's default language is used. [Many
-   *     languages](https://cloud.google.com/dialogflow/docs/reference/language) are supported.
-   *     Note: languages must be enabled in the agent before they can be used.
+   * @param languageCode Optional. The language used to access language-specific data. If not
+   *     specified, the agent's default language is used. For more information, see [Multilingual
+   *     intent and entity
+   *     data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final EntityType updateEntityType(EntityType entityType, String languageCode) {
@@ -1219,10 +1219,10 @@ public final OperationFuture<Empty, Struct> batchCreateEntitiesAsync(
    * @param parent Required. The name of the entity type to create entities in. Format:
    *     `projects/&lt;Project ID&gt;/agent/entityTypes/&lt;Entity Type ID&gt;`.
    * @param entities Required. The entities to create.
-   * @param languageCode Optional. The language of entity synonyms defined in `entities`. If not
-   *     specified, the agent's default language is used. [Many
-   *     languages](https://cloud.google.com/dialogflow/docs/reference/language) are supported.
-   *     Note: languages must be enabled in the agent before they can be used.
+   * @param languageCode Optional. The language used to access language-specific data. If not
+   *     specified, the agent's default language is used. For more information, see [Multilingual
+   *     intent and entity
+   *     data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   @BetaApi(
@@ -1258,10 +1258,10 @@ public final OperationFuture<Empty, Struct> batchCreateEntitiesAsync(
    * @param parent Required. The name of the entity type to create entities in. Format:
    *     `projects/&lt;Project ID&gt;/agent/entityTypes/&lt;Entity Type ID&gt;`.
    * @param entities Required. The entities to create.
-   * @param languageCode Optional. The language of entity synonyms defined in `entities`. If not
-   *     specified, the agent's default language is used. [Many
-   *     languages](https://cloud.google.com/dialogflow/docs/reference/language) are supported.
-   *     Note: languages must be enabled in the agent before they can be used.
+   * @param languageCode Optional. The language used to access language-specific data. If not
+   *     specified, the agent's default language is used. For more information, see [Multilingual
+   *     intent and entity
+   *     data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   @BetaApi(
@@ -1447,10 +1447,10 @@ public final OperationFuture<Empty, Struct> batchUpdateEntitiesAsync(
    * @param parent Required. The name of the entity type to update or create entities in. Format:
    *     `projects/&lt;Project ID&gt;/agent/entityTypes/&lt;Entity Type ID&gt;`.
    * @param entities Required. The entities to update or create.
-   * @param languageCode Optional. The language of entity synonyms defined in `entities`. If not
-   *     specified, the agent's default language is used. [Many
-   *     languages](https://cloud.google.com/dialogflow/docs/reference/language) are supported.
-   *     Note: languages must be enabled in the agent before they can be used.
+   * @param languageCode Optional. The language used to access language-specific data. If not
+   *     specified, the agent's default language is used. For more information, see [Multilingual
+   *     intent and entity
+   *     data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   @BetaApi(
@@ -1487,10 +1487,10 @@ public final OperationFuture<Empty, Struct> batchUpdateEntitiesAsync(
    * @param parent Required. The name of the entity type to update or create entities in. Format:
    *     `projects/&lt;Project ID&gt;/agent/entityTypes/&lt;Entity Type ID&gt;`.
    * @param entities Required. The entities to update or create.
-   * @param languageCode Optional. The language of entity synonyms defined in `entities`. If not
-   *     specified, the agent's default language is used. [Many
-   *     languages](https://cloud.google.com/dialogflow/docs/reference/language) are supported.
-   *     Note: languages must be enabled in the agent before they can be used.
+   * @param languageCode Optional. The language used to access language-specific data. If not
+   *     specified, the agent's default language is used. For more information, see [Multilingual
+   *     intent and entity
+   *     data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   @BetaApi(
@@ -1682,10 +1682,10 @@ public final OperationFuture<Empty, Struct> batchDeleteEntitiesAsync(
    *     `projects/&lt;Project ID&gt;/agent/entityTypes/&lt;Entity Type ID&gt;`.
    * @param entityValues Required. The reference `values` of the entities to delete. Note that these
    *     are not fully-qualified names, i.e. they don't start with `projects/&lt;Project ID&gt;`.
-   * @param languageCode Optional. The language of entity synonyms defined in `entities`. If not
-   *     specified, the agent's default language is used. [Many
-   *     languages](https://cloud.google.com/dialogflow/docs/reference/language) are supported.
-   *     Note: languages must be enabled in the agent before they can be used.
+   * @param languageCode Optional. The language used to access language-specific data. If not
+   *     specified, the agent's default language is used. For more information, see [Multilingual
+   *     intent and entity
+   *     data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   @BetaApi(
@@ -1722,10 +1722,10 @@ public final OperationFuture<Empty, Struct> batchDeleteEntitiesAsync(
    *     `projects/&lt;Project ID&gt;/agent/entityTypes/&lt;Entity Type ID&gt;`.
    * @param entityValues Required. The reference `values` of the entities to delete. Note that these
    *     are not fully-qualified names, i.e. they don't start with `projects/&lt;Project ID&gt;`.
-   * @param languageCode Optional. The language of entity synonyms defined in `entities`. If not
-   *     specified, the agent's default language is used. [Many
-   *     languages](https://cloud.google.com/dialogflow/docs/reference/language) are supported.
-   *     Note: languages must be enabled in the agent before they can be used.
+   * @param languageCode Optional. The language used to access language-specific data. If not
+   *     specified, the agent's default language is used. For more information, see [Multilingual
+   *     intent and entity
+   *     data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   @BetaApi(