google-cloud-dialogflow 0.2.3 → 0.3.0

data/lib/google/cloud/dialogflow/v2/doc/google/cloud/dialogflow/v2/session_entity_type.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -29,6 +29,9 @@ module Google
         #     Required. The unique identifier of this session entity type. Format:
         #     `projects/<Project ID>/agent/sessions/<Session ID>/entityTypes/<Entity Type
         #     Display Name>`.
+        #
+        #     `<Entity Type Display Name>` must be the display name of an existing entity
+        #     type in the same agent that will be overridden or supplemented.
         # @!attribute [rw] entity_override_mode
         #   @return [Google::Cloud::Dialogflow::V2::SessionEntityType::EntityOverrideMode]
         #     Required. Indicates whether the additional data should override or
@@ -49,10 +52,13 @@ module Google
 
             # The collection of session entities extends the collection of entities in
             # the corresponding developer entity type.
-            # Calls to `ListSessionEntityTypes`, `GetSessionEntityType`,
-            # `CreateSessionEntityType` and `UpdateSessionEntityType` return the full
-            # collection of entities from the developer entity type in the agent's
-            # default language and the session entity type.
+            #
+            # Note: Even in this override mode calls to `ListSessionEntityTypes`,
+            # `GetSessionEntityType`, `CreateSessionEntityType` and
+            # `UpdateSessionEntityType` only return the additional entities added in
+            # this session entity type. If you want to get the supplemented list,
+            # please call {Google::Cloud::Dialogflow::V2::EntityTypes::GetEntityType EntityTypes::GetEntityType} on the developer entity type
+            # and merge.
             ENTITY_OVERRIDE_MODE_SUPPLEMENT = 2
           end
         end

data/lib/google/cloud/dialogflow/v2/doc/google/longrunning/operations.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -31,7 +31,7 @@ module Google
     # @!attribute [rw] done
     #   @return [true, false]
     #     If the value is `false`, it means the operation is still in progress.
-    #     If true, the operation is completed, and either `error` or `response` is
+    #     If `true`, the operation is completed, and either `error` or `response` is
     #     available.
     # @!attribute [rw] error
     #   @return [Google::Rpc::Status]
@@ -47,47 +47,5 @@ module Google
     #     is `TakeSnapshot()`, the inferred response type is
     #     `TakeSnapshotResponse`.
     class Operation; end
-
-    # The request message for {Google::Longrunning::Operations::GetOperation Operations::GetOperation}.
-    # @!attribute [rw] name
-    #   @return [String]
-    #     The name of the operation resource.
-    class GetOperationRequest; end
-
-    # The request message for {Google::Longrunning::Operations::ListOperations Operations::ListOperations}.
-    # @!attribute [rw] name
-    #   @return [String]
-    #     The name of the operation collection.
-    # @!attribute [rw] filter
-    #   @return [String]
-    #     The standard list filter.
-    # @!attribute [rw] page_size
-    #   @return [Integer]
-    #     The standard list page size.
-    # @!attribute [rw] page_token
-    #   @return [String]
-    #     The standard list page token.
-    class ListOperationsRequest; end
-
-    # The response message for {Google::Longrunning::Operations::ListOperations Operations::ListOperations}.
-    # @!attribute [rw] operations
-    #   @return [Array<Google::Longrunning::Operation>]
-    #     A list of operations that matches the specified filter in the request.
-    # @!attribute [rw] next_page_token
-    #   @return [String]
-    #     The standard List next-page token.
-    class ListOperationsResponse; end
-
-    # The request message for {Google::Longrunning::Operations::CancelOperation Operations::CancelOperation}.
-    # @!attribute [rw] name
-    #   @return [String]
-    #     The name of the operation resource to be cancelled.
-    class CancelOperationRequest; end
-
-    # The request message for {Google::Longrunning::Operations::DeleteOperation Operations::DeleteOperation}.
-    # @!attribute [rw] name
-    #   @return [String]
-    #     The name of the operation resource to be deleted.
-    class DeleteOperationRequest; end
   end
 end

data/lib/google/cloud/dialogflow/v2/doc/google/protobuf/any.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -97,7 +97,8 @@ module Google
     # @!attribute [rw] type_url
     #   @return [String]
     #     A URL/resource name that uniquely identifies the type of the serialized
-    #     protocol buffer message. The last segment of the URL's path must represent
+    #     protocol buffer message. This string must contain at least
+    #     one "/" character. The last segment of the URL's path must represent
     #     the fully qualified name of the type (as in
     #     `path/google.protobuf.Duration`). The name should be in a canonical form
     #     (e.g., leading "." is not accepted).

data/lib/google/cloud/dialogflow/v2/doc/google/protobuf/empty.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/cloud/dialogflow/v2/doc/google/protobuf/field_mask.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -83,57 +83,49 @@ module Google
     # describe the updated values, the API ignores the values of all
     # fields not covered by the mask.
     #
-    # If a repeated field is specified for an update operation, the existing
-    # repeated values in the target resource will be overwritten by the new values.
-    # Note that a repeated field is only allowed in the last position of a `paths`
-    # string.
+    # If a repeated field is specified for an update operation, new values will
+    # be appended to the existing repeated field in the target resource. Note that
+    # a repeated field is only allowed in the last position of a `paths` string.
     #
     # If a sub-message is specified in the last position of the field mask for an
-    # update operation, then the existing sub-message in the target resource is
-    # overwritten. Given the target message:
+    # update operation, then new value will be merged into the existing sub-message
+    # in the target resource.
+    #
+    # For example, given the target message:
     #
     #     f {
     #       b {
-    #         d : 1
-    #         x : 2
+    #         d: 1
+    #         x: 2
     #       }
-    #       c : 1
+    #       c: [1]
     #     }
     #
     # And an update message:
     #
     #     f {
     #       b {
-    #         d : 10
+    #         d: 10
     #       }
+    #       c: [2]
     #     }
     #
     # then if the field mask is:
     #
-    #  paths: "f.b"
+    #  paths: ["f.b", "f.c"]
     #
     # then the result will be:
     #
     #     f {
     #       b {
-    #         d : 10
+    #         d: 10
+    #         x: 2
     #       }
-    #       c : 1
+    #       c: [1, 2]
     #     }
     #
-    # However, if the update mask was:
-    #
-    #  paths: "f.b.d"
-    #
-    # then the result would be:
-    #
-    #     f {
-    #       b {
-    #         d : 10
-    #         x : 2
-    #       }
-    #       c : 1
-    #     }
+    # An implementation may provide options to override this default behavior for
+    # repeated and message fields.
     #
     # In order to reset a field's value to the default, the field must
     # be in the mask and set to the default value in the provided resource.

data/lib/google/cloud/dialogflow/v2/doc/google/protobuf/struct.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/cloud/dialogflow/v2/doc/google/rpc/status.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,24 +15,25 @@
 
 module Google
   module Rpc
-    # The `Status` type defines a logical error model that is suitable for different
-    # programming environments, including REST APIs and RPC APIs. It is used by
-    # [gRPC](https://github.com/grpc). The error model is designed to be:
+    # The `Status` type defines a logical error model that is suitable for
+    # different programming environments, including REST APIs and RPC APIs. It is
+    # used by [gRPC](https://github.com/grpc). The error model is designed to be:
     #
     # * Simple to use and understand for most users
     # * Flexible enough to meet unexpected needs
     #
     # = Overview
     #
-    # The `Status` message contains three pieces of data: error code, error message,
-    # and error details. The error code should be an enum value of
-    # {Google::Rpc::Code}, but it may accept additional error codes if needed.  The
-    # error message should be a developer-facing English message that helps
-    # developers *understand* and *resolve* the error. If a localized user-facing
-    # error message is needed, put the localized message in the error details or
-    # localize it in the client. The optional error details may contain arbitrary
-    # information about the error. There is a predefined set of error detail types
-    # in the package `google.rpc` that can be used for common error conditions.
+    # The `Status` message contains three pieces of data: error code, error
+    # message, and error details. The error code should be an enum value of
+    # {Google::Rpc::Code}, but it may accept additional error codes
+    # if needed.  The error message should be a developer-facing English message
+    # that helps developers *understand* and *resolve* the error. If a localized
+    # user-facing error message is needed, put the localized message in the error
+    # details or localize it in the client. The optional error details may contain
+    # arbitrary information about the error. There is a predefined set of error
+    # detail types in the package `google.rpc` that can be used for common error
+    # conditions.
     #
     # = Language mapping
     #
@@ -69,12 +70,14 @@ module Google
     #   be used directly after any stripping needed for security/privacy reasons.
     # @!attribute [rw] code
     #   @return [Integer]
-    #     The status code, which should be an enum value of {Google::Rpc::Code}.
+    #     The status code, which should be an enum value of
+    #     {Google::Rpc::Code}.
     # @!attribute [rw] message
     #   @return [String]
     #     A developer-facing error message, which should be in English. Any
     #     user-facing error message should be localized and sent in the
-    #     {Google::Rpc::Status#details} field, or localized by the client.
+    #     {Google::Rpc::Status#details} field, or localized
+    #     by the client.
     # @!attribute [rw] details
     #   @return [Array<Google::Protobuf::Any>]
     #     A list of messages that carry the error details.  There is a common set of

data/lib/google/cloud/dialogflow/v2/doc/google/type/latlng.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -20,40 +20,6 @@ module Google
     # specified otherwise, this must conform to the
     # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
     # standard</a>. Values must be within normalized ranges.
-    #
-    # Example of normalization code in Python:
-    #
-    #     def NormalizeLongitude(longitude):
-    #       """Wraps decimal degrees longitude to [-180.0, 180.0]."""
-    #       q, r = divmod(longitude, 360.0)
-    #       if r > 180.0 or (r == 180.0 and q <= -1.0):
-    #         return r - 360.0
-    #       return r
-    #
-    #     def NormalizeLatLng(latitude, longitude):
-    #       """Wraps decimal degrees latitude and longitude to
-    #       [-90.0, 90.0] and [-180.0, 180.0], respectively."""
-    #       r = latitude % 360.0
-    #       if r <= 90.0:
-    #         return r, NormalizeLongitude(longitude)
-    #       elif r >= 270.0:
-    #         return r - 360, NormalizeLongitude(longitude)
-    #       else:
-    #         return 180 - r, NormalizeLongitude(longitude + 180.0)
-    #
-    #     assert 180.0 == NormalizeLongitude(180.0)
-    #     assert -180.0 == NormalizeLongitude(-180.0)
-    #     assert -179.0 == NormalizeLongitude(181.0)
-    #     assert (0.0, 0.0) == NormalizeLatLng(360.0, 0.0)
-    #     assert (0.0, 0.0) == NormalizeLatLng(-360.0, 0.0)
-    #     assert (85.0, 180.0) == NormalizeLatLng(95.0, 0.0)
-    #     assert (-85.0, -170.0) == NormalizeLatLng(-95.0, 10.0)
-    #     assert (90.0, 10.0) == NormalizeLatLng(90.0, 10.0)
-    #     assert (-90.0, -10.0) == NormalizeLatLng(-90.0, -10.0)
-    #     assert (0.0, -170.0) == NormalizeLatLng(-180.0, 10.0)
-    #     assert (0.0, -170.0) == NormalizeLatLng(180.0, 10.0)
-    #     assert (-90.0, 10.0) == NormalizeLatLng(270.0, 10.0)
-    #     assert (90.0, 10.0) == NormalizeLatLng(-270.0, 10.0)
     # @!attribute [rw] latitude
     #   @return [Float]
     #     The latitude in degrees. It must be in the range [-90.0, +90.0].

data/lib/google/cloud/dialogflow/v2/entity_type_pb.rb

@@ -5,6 +5,7 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/resource_pb'
 require 'google/longrunning/operations_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'

data/lib/google/cloud/dialogflow/v2/entity_type_services_pb.rb

@@ -1,7 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/cloud/dialogflow/v2/entity_type.proto for package 'google.cloud.dialogflow.v2'
 # Original file comments:
-# Copyright 2018 Google Inc.
+# Copyright 2019 Google LLC.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,6 +15,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
+#
 
 
 require 'grpc'
@@ -51,7 +52,8 @@ module Google
           #     represented by the [SessionEntityType][google.cloud.dialogflow.v2.SessionEntityType] type.
           #
           # For more information about entity types, see the
-          # [Dialogflow documentation](https://dialogflow.com/docs/entities).
+          # [Dialogflow
+          # documentation](https://cloud.google.com/dialogflow-enterprise/docs/entities-overview).
           class Service
 
             include GRPC::GenericService
@@ -72,29 +74,25 @@ module Google
             rpc :DeleteEntityType, DeleteEntityTypeRequest, Google::Protobuf::Empty
             # Updates/Creates multiple entity types in the specified agent.
             #
-            # Operation <response: [BatchUpdateEntityTypesResponse][google.cloud.dialogflow.v2.BatchUpdateEntityTypesResponse],
-            #            metadata: [google.protobuf.Struct][google.protobuf.Struct]>
+            # Operation <response: [BatchUpdateEntityTypesResponse][google.cloud.dialogflow.v2.BatchUpdateEntityTypesResponse]>
             rpc :BatchUpdateEntityTypes, BatchUpdateEntityTypesRequest, Google::Longrunning::Operation
             # Deletes entity types in the specified agent.
             #
-            # Operation <response: [google.protobuf.Empty][google.protobuf.Empty],
-            #            metadata: [google.protobuf.Struct][google.protobuf.Struct]>
+            # Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
             rpc :BatchDeleteEntityTypes, BatchDeleteEntityTypesRequest, Google::Longrunning::Operation
-            # Creates multiple new entities in the specified entity type (extends the
-            # existing collection of entries).
+            # Creates multiple new entities in the specified entity type.
             #
             # Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
             rpc :BatchCreateEntities, BatchCreateEntitiesRequest, Google::Longrunning::Operation
-            # Updates entities in the specified entity type (replaces the existing
-            # collection of entries).
+            # Updates or creates multiple entities in the specified entity type. This
+            # method does not affect entities in the entity type that aren't explicitly
+            # specified in the request.
             #
-            # Operation <response: [google.protobuf.Empty][google.protobuf.Empty],
-            #            metadata: [google.protobuf.Struct][google.protobuf.Struct]>
+            # Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
             rpc :BatchUpdateEntities, BatchUpdateEntitiesRequest, Google::Longrunning::Operation
             # Deletes entities in the specified entity type.
             #
-            # Operation <response: [google.protobuf.Empty][google.protobuf.Empty],
-            #            metadata: [google.protobuf.Struct][google.protobuf.Struct]>
+            # Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
             rpc :BatchDeleteEntities, BatchDeleteEntitiesRequest, Google::Longrunning::Operation
           end
 

data/lib/google/cloud/dialogflow/v2/entity_types_client.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -60,7 +60,8 @@ module Google
         #   represented by the {Google::Cloud::Dialogflow::V2::SessionEntityType SessionEntityType} type.
         #
         # For more information about entity types, see the
-        # [Dialogflow documentation](https://dialogflow.com/docs/entities).
+        # [Dialogflow
+        # documentation](https://cloud.google.com/dialogflow-enterprise/docs/entities-overview).
         #
         # @!attribute [r] entity_types_stub
         #   @return [Google::Cloud::Dialogflow::V2::EntityTypes::Stub]
@@ -91,7 +92,8 @@ module Google
           # The scopes needed to make gRPC calls to all of the methods defined in
           # this service.
           ALL_SCOPES = [
-            "https://www.googleapis.com/auth/cloud-platform"
+            "https://www.googleapis.com/auth/cloud-platform",
+            "https://www.googleapis.com/auth/dialogflow"
           ].freeze
 
           # @private
@@ -100,26 +102,17 @@ module Google
             self::GRPC_INTERCEPTORS = EntityTypesClient::GRPC_INTERCEPTORS
           end
 
-          PROJECT_AGENT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "projects/{project}/agent"
-          )
-
-          private_constant :PROJECT_AGENT_PATH_TEMPLATE
-
           ENTITY_TYPE_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "projects/{project}/agent/entityTypes/{entity_type}"
           )
 
           private_constant :ENTITY_TYPE_PATH_TEMPLATE
 
-          # Returns a fully-qualified project_agent resource name string.
-          # @param project [String]
-          # @return [String]
-          def self.project_agent_path project
-            PROJECT_AGENT_PATH_TEMPLATE.render(
-              :"project" => project
-            )
-          end
+          PROJECT_AGENT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+            "projects/{project}/agent"
+          )
+
+          private_constant :PROJECT_AGENT_PATH_TEMPLATE
 
           # Returns a fully-qualified entity_type resource name string.
           # @param project [String]
@@ -132,6 +125,15 @@ module Google
             )
           end
 
+          # Returns a fully-qualified project_agent resource name string.
+          # @param project [String]
+          # @return [String]
+          def self.project_agent_path project
+            PROJECT_AGENT_PATH_TEMPLATE.render(
+              :"project" => project
+            )
+          end
+
           # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
           #   Provides the means for authenticating requests made by the client. This parameter can
           #   be many types.
@@ -247,52 +249,82 @@ module Google
             @list_entity_types = Google::Gax.create_api_call(
               @entity_types_stub.method(:list_entity_types),
               defaults["list_entity_types"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @get_entity_type = Google::Gax.create_api_call(
               @entity_types_stub.method(:get_entity_type),
               defaults["get_entity_type"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @create_entity_type = Google::Gax.create_api_call(
               @entity_types_stub.method(:create_entity_type),
               defaults["create_entity_type"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @update_entity_type = Google::Gax.create_api_call(
               @entity_types_stub.method(:update_entity_type),
               defaults["update_entity_type"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'entity_type.name' => request.entity_type.name}
+              end
             )
             @delete_entity_type = Google::Gax.create_api_call(
               @entity_types_stub.method(:delete_entity_type),
               defaults["delete_entity_type"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @batch_update_entity_types = Google::Gax.create_api_call(
               @entity_types_stub.method(:batch_update_entity_types),
               defaults["batch_update_entity_types"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @batch_delete_entity_types = Google::Gax.create_api_call(
               @entity_types_stub.method(:batch_delete_entity_types),
               defaults["batch_delete_entity_types"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @batch_create_entities = Google::Gax.create_api_call(
               @entity_types_stub.method(:batch_create_entities),
               defaults["batch_create_entities"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @batch_update_entities = Google::Gax.create_api_call(
               @entity_types_stub.method(:batch_update_entities),
               defaults["batch_update_entities"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @batch_delete_entities = Google::Gax.create_api_call(
               @entity_types_stub.method(:batch_delete_entities),
               defaults["batch_delete_entities"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
           end
 
@@ -306,9 +338,10 @@ module Google
           # @param language_code [String]
           #   Optional. The language to list entity synonyms for. If not specified,
           #   the agent's default language is used.
-          #   [More than a dozen
-          #   languages](https://dialogflow.com/docs/reference/language) are supported.
-          #   Note: languages must be enabled in the agent, before they can be used.
+          #   [Many
+          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   are supported. Note: languages must be enabled in the agent before they can
+          #   be used.
           # @param page_size [Integer]
           #   The maximum number of resources contained in the underlying API
           #   response. If page streaming is performed per-resource, this
@@ -369,9 +402,10 @@ module Google
           # @param language_code [String]
           #   Optional. The language to retrieve entity synonyms for. If not specified,
           #   the agent's default language is used.
-          #   [More than a dozen
-          #   languages](https://dialogflow.com/docs/reference/language) are supported.
-          #   Note: languages must be enabled in the agent, before they can be used.
+          #   [Many
+          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   are supported. Note: languages must be enabled in the agent before they can
+          #   be used.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -412,9 +446,10 @@ module Google
           # @param language_code [String]
           #   Optional. The language of entity synonyms defined in `entity_type`. If not
           #   specified, the agent's default language is used.
-          #   [More than a dozen
-          #   languages](https://dialogflow.com/docs/reference/language) are supported.
-          #   Note: languages must be enabled in the agent, before they can be used.
+          #   [Many
+          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   are supported. Note: languages must be enabled in the agent before they can
+          #   be used.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -452,15 +487,15 @@ module Google
           #
           # @param entity_type [Google::Cloud::Dialogflow::V2::EntityType | Hash]
           #   Required. The entity type to update.
-          #   Format: `projects/<Project ID>/agent/entityTypes/<EntityType ID>`.
           #   A hash of the same form as `Google::Cloud::Dialogflow::V2::EntityType`
           #   can also be provided.
           # @param language_code [String]
           #   Optional. The language of entity synonyms defined in `entity_type`. If not
           #   specified, the agent's default language is used.
-          #   [More than a dozen
-          #   languages](https://dialogflow.com/docs/reference/language) are supported.
-          #   Note: languages must be enabled in the agent, before they can be used.
+          #   [Many
+          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   are supported. Note: languages must be enabled in the agent before they can
+          #   be used.
           # @param update_mask [Google::Protobuf::FieldMask | Hash]
           #   Optional. The mask to control which fields get updated.
           #   A hash of the same form as `Google::Protobuf::FieldMask`
@@ -530,8 +565,7 @@ module Google
 
           # Updates/Creates multiple entity types in the specified agent.
           #
-          # Operation <response: {Google::Cloud::Dialogflow::V2::BatchUpdateEntityTypesResponse BatchUpdateEntityTypesResponse},
-          #            metadata: {Google::Protobuf::Struct}>
+          # Operation <response: {Google::Cloud::Dialogflow::V2::BatchUpdateEntityTypesResponse BatchUpdateEntityTypesResponse}>
           #
           # @param parent [String]
           #   Required. The name of the agent to update or create entity types in.
@@ -542,15 +576,16 @@ module Google
           #   EntityBatch type) or a JSON object. Note: The URI must start with
           #   "gs://".
           # @param entity_type_batch_inline [Google::Cloud::Dialogflow::V2::EntityTypeBatch | Hash]
-          #   The collection of entity type to update or create.
+          #   The collection of entity types to update or create.
           #   A hash of the same form as `Google::Cloud::Dialogflow::V2::EntityTypeBatch`
           #   can also be provided.
           # @param language_code [String]
           #   Optional. The language of entity synonyms defined in `entity_types`. If not
           #   specified, the agent's default language is used.
-          #   [More than a dozen
-          #   languages](https://dialogflow.com/docs/reference/language) are supported.
-          #   Note: languages must be enabled in the agent, before they can be used.
+          #   [Many
+          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   are supported. Note: languages must be enabled in the agent before they can
+          #   be used.
           # @param update_mask [Google::Protobuf::FieldMask | Hash]
           #   Optional. The mask to control which fields get updated.
           #   A hash of the same form as `Google::Protobuf::FieldMask`
@@ -621,8 +656,7 @@ module Google
 
           # Deletes entity types in the specified agent.
           #
-          # Operation <response: {Google::Protobuf::Empty},
-          #            metadata: {Google::Protobuf::Struct}>
+          # Operation <response: {Google::Protobuf::Empty}>
           #
           # @param parent [String]
           #   Required. The name of the agent to delete all entities types for. Format:
@@ -691,8 +725,7 @@ module Google
             operation
           end
 
-          # Creates multiple new entities in the specified entity type (extends the
-          # existing collection of entries).
+          # Creates multiple new entities in the specified entity type.
           #
           # Operation <response: {Google::Protobuf::Empty}>
           #
@@ -700,15 +733,16 @@ module Google
           #   Required. The name of the entity type to create entities in. Format:
           #   `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`.
           # @param entities [Array<Google::Cloud::Dialogflow::V2::EntityType::Entity | Hash>]
-          #   Required. The collection of entities to create.
+          #   Required. The entities to create.
           #   A hash of the same form as `Google::Cloud::Dialogflow::V2::EntityType::Entity`
           #   can also be provided.
           # @param language_code [String]
           #   Optional. The language of entity synonyms defined in `entities`. If not
           #   specified, the agent's default language is used.
-          #   [More than a dozen
-          #   languages](https://dialogflow.com/docs/reference/language) are supported.
-          #   Note: languages must be enabled in the agent, before they can be used.
+          #   [Many
+          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   are supported. Note: languages must be enabled in the agent before they can
+          #   be used.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -772,25 +806,26 @@ module Google
             operation
           end
 
-          # Updates entities in the specified entity type (replaces the existing
-          # collection of entries).
+          # Updates or creates multiple entities in the specified entity type. This
+          # method does not affect entities in the entity type that aren't explicitly
+          # specified in the request.
           #
-          # Operation <response: {Google::Protobuf::Empty},
-          #            metadata: {Google::Protobuf::Struct}>
+          # Operation <response: {Google::Protobuf::Empty}>
           #
           # @param parent [String]
-          #   Required. The name of the entity type to update the entities in. Format:
-          #   `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`.
+          #   Required. The name of the entity type to update or create entities in.
+          #   Format: `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`.
           # @param entities [Array<Google::Cloud::Dialogflow::V2::EntityType::Entity | Hash>]
-          #   Required. The collection of new entities to replace the existing entities.
+          #   Required. The entities to update or create.
           #   A hash of the same form as `Google::Cloud::Dialogflow::V2::EntityType::Entity`
           #   can also be provided.
           # @param language_code [String]
           #   Optional. The language of entity synonyms defined in `entities`. If not
           #   specified, the agent's default language is used.
-          #   [More than a dozen
-          #   languages](https://dialogflow.com/docs/reference/language) are supported.
-          #   Note: languages must be enabled in the agent, before they can be used.
+          #   [Many
+          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   are supported. Note: languages must be enabled in the agent before they can
+          #   be used.
           # @param update_mask [Google::Protobuf::FieldMask | Hash]
           #   Optional. The mask to control which fields get updated.
           #   A hash of the same form as `Google::Protobuf::FieldMask`
@@ -862,8 +897,7 @@ module Google
 
           # Deletes entities in the specified entity type.
           #
-          # Operation <response: {Google::Protobuf::Empty},
-          #            metadata: {Google::Protobuf::Struct}>
+          # Operation <response: {Google::Protobuf::Empty}>
           #
           # @param parent [String]
           #   Required. The name of the entity type to delete entries for. Format:
@@ -875,9 +909,10 @@ module Google
           # @param language_code [String]
           #   Optional. The language of entity synonyms defined in `entities`. If not
           #   specified, the agent's default language is used.
-          #   [More than a dozen
-          #   languages](https://dialogflow.com/docs/reference/language) are supported.
-          #   Note: languages must be enabled in the agent, before they can be used.
+          #   [Many
+          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   are supported. Note: languages must be enabled in the agent before they can
+          #   be used.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.