google-api-client 0.41.1 → 0.43.0

data/generated/google/apis/healthcare_v1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/healthcare
     module HealthcareV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200612'
+      REVISION = '20200723'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/healthcare_v1beta1/classes.rb

@@ -1075,8 +1075,8 @@ module Google
         end
       end
       
-      # Response for failed annotation export operations. This structure is
-      # included in error
+      # Response for failed annotation export operations. This structure
+      # is included in error
       # details upon operation completion.
       class ExportAnnotationsErrorDetails
         include Google::Apis::Core::Hashable
@@ -1144,7 +1144,8 @@ module Google
       class ExportAnnotationsResponse
         include Google::Apis::Core::Hashable
       
-        # The annotation_store used for the export operation, in the format of
+        # The annotation_store used for the export operation,
+        # in the format of
         # `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
         # annotationStores/`annotation_store_id``.
         # Corresponds to the JSON property `annotationStore`
@@ -1176,7 +1177,7 @@ module Google
       class ExportDicomDataRequest
         include Google::Apis::Core::Hashable
       
-        # The BigQuery table where the server writes the output.
+        # The BigQuery table where the server writes output.
         # Corresponds to the JSON property `bigqueryDestination`
         # @return [Google::Apis::HealthcareV1beta1::GoogleCloudHealthcareV1beta1DicomBigQueryDestination]
         attr_accessor :bigquery_destination
@@ -1611,6 +1612,39 @@ module Google
         end
       end
       
+      # Specifies the configuration for importing data from Cloud Storage.
+      class GcsSource
+        include Google::Apis::Core::Hashable
+      
+        # Points to a Cloud Storage URI containing file(s) to import.
+        # The URI must be in the following format: `gs://`bucket_id`/`object_id``.
+        # The URI can include wildcards in `object_id` and thus identify multiple
+        # files. Supported wildcards:
+        # *  `*` to match 0 or more non-separator characters
+        # *  `**` to match 0 or more characters (including separators). Must be used
+        # at the end of a path and with no other wildcards in the
+        # path. Can also be used with a file extension (such as .ndjson), which
+        # imports all files with the extension in the specified directory and
+        # its sub-directories. For example, `gs://my-bucket/my-directory/**.ndjson`
+        # imports all files with `.ndjson` extensions in `my-directory/` and its
+        # sub-directories.
+        # *  `?` to match 1 character
+        # Files matching the wildcard are expected to contain content only, no
+        # metadata.
+        # Corresponds to the JSON property `uri`
+        # @return [String]
+        attr_accessor :uri
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @uri = args[:uri] if args.key?(:uri)
+        end
+      end
+      
       # The BigQuery table for export.
       class GoogleCloudHealthcareV1beta1AnnotationBigQueryDestination
         include Google::Apis::Core::Hashable
@@ -1750,14 +1784,13 @@ module Google
         end
       end
       
-      # The BigQuery table where the server writes the output.
+      # The BigQuery table where the server writes output.
       class GoogleCloudHealthcareV1beta1DicomBigQueryDestination
         include Google::Apis::Core::Hashable
       
-        # If the destination table already exists and this flag is `TRUE`, the table
-        # is overwritten by the contents of the DICOM store. If the flag is not
-        # set and the destination table already exists, the export call returns an
-        # error.
+        # This flag is being replaced by write_disposition which provides additional
+        # options. force=false is equivalent to WRITE_EMPTY and force=true is
+        # equivalent to WRITE_TRUNCATE.
         # Corresponds to the JSON property `force`
         # @return [Boolean]
         attr_accessor :force
@@ -1885,9 +1918,9 @@ module Google
         # @return [String]
         attr_accessor :dataset_uri
       
-        # If this flag is `TRUE`, all tables will be deleted from the dataset before
-        # the new exported tables are written. If the flag is not set and the
-        # destination dataset contains tables, the export call returns an error.
+        # This flag is being replaced by write_disposition which provides additional
+        # options. force=false is equivalent to WRITE_EMPTY and force=true is
+        # equivalent to WRITE_TRUNCATE.
         # Corresponds to the JSON property `force`
         # @return [Boolean]
         attr_accessor :force
@@ -2510,16 +2543,16 @@ module Google
       class ImportAnnotationsResponse
         include Google::Apis::Core::Hashable
       
-        # The annotation_store that the annotations were imported to. The name
-        # is in the format
+        # The annotation_store that the annotations were imported to,
+        # in the format
         # `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
         # annotationStores/`annotation_store_id``.
         # Corresponds to the JSON property `annotationStore`
         # @return [String]
         attr_accessor :annotation_store
       
-        # The number of the input annotations. All input have been imported
-        # successfully.
+        # The number of the input annotations. All input have been
+        # imported successfully.
         # Corresponds to the JSON property `successCount`
         # @return [Fixnum]
         attr_accessor :success_count
@@ -2591,6 +2624,41 @@ module Google
         end
       end
       
+      # Request to import messages.
+      class ImportMessagesRequest
+        include Google::Apis::Core::Hashable
+      
+        # Specifies the configuration for importing data from Cloud Storage.
+        # Corresponds to the JSON property `gcsSource`
+        # @return [Google::Apis::HealthcareV1beta1::GcsSource]
+        attr_accessor :gcs_source
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @gcs_source = args[:gcs_source] if args.key?(:gcs_source)
+        end
+      end
+      
+      # Final response of importing messages.
+      # This structure is included in the
+      # response to describe the detailed
+      # outcome. It is only included when the operation finishes successfully.
+      class ImportMessagesResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Request to import resources.
       class ImportResourcesRequest
         include Google::Apis::Core::Hashable
@@ -3722,7 +3790,7 @@ module Google
         # @return [Array<Google::Apis::HealthcareV1beta1::Hl7SchemaConfig>]
         attr_accessor :schemas
       
-        # Determines how messages that don't parse successfully are handled.
+        # Determines how messages that fail to parse are handled.
         # Corresponds to the JSON property `schematizedParsingType`
         # @return [String]
         attr_accessor :schematized_parsing_type

data/generated/google/apis/healthcare_v1beta1/representations.rb

@@ -280,6 +280,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GcsSource
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudHealthcareV1beta1AnnotationBigQueryDestination
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -454,6 +460,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ImportMessagesRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ImportMessagesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ImportResourcesRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1129,6 +1147,13 @@ module Google
         end
       end
       
+      class GcsSource
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :uri, as: 'uri'
+        end
+      end
+      
       class GoogleCloudHealthcareV1beta1AnnotationBigQueryDestination
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1375,6 +1400,20 @@ module Google
         end
       end
       
+      class ImportMessagesRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :gcs_source, as: 'gcsSource', class: Google::Apis::HealthcareV1beta1::GcsSource, decorator: Google::Apis::HealthcareV1beta1::GcsSource::Representation
+      
+        end
+      end
+      
+      class ImportMessagesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class ImportResourcesRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/generated/google/apis/healthcare_v1beta1/service.rb

@@ -547,7 +547,8 @@ module Google
         # Errors are logged to Cloud Logging
         # (see [Viewing logs](/healthcare/docs/how-tos/logging)).
         # @param [String] eval_store
-        #   The Annotation store to compare against `golden_store`, in the format of
+        #   The Annotation store to compare against `golden_store`, in the
+        #   format of
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
         #   annotationStores/`annotation_store_id``.
         # @param [Google::Apis::HealthcareV1beta1::EvaluateAnnotationStoreRequest] evaluate_annotation_store_request_object
@@ -720,8 +721,8 @@ module Google
         # Errors are also logged to Cloud Logging
         # (see [Viewing logs](/healthcare/docs/how-tos/logging)).
         # @param [String] annotation_store
-        #   The name of the Annotation store to which the server imports annotations,
-        #   in the format
+        #   The name of the Annotation store to which the server imports
+        #   annotations, in the format
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
         #   annotationStores/`annotation_store_id``.
         # @param [Google::Apis::HealthcareV1beta1::ImportAnnotationsRequest] import_annotations_request_object
@@ -3003,17 +3004,29 @@ module Google
         # [STU3](http://www.hl7.org/fhir/stu3/compartmentdefinition-patient.html),
         # [R4](https://hl7.org/fhir/R4/compartmentdefinition-patient.html)), which
         # details the eligible resource types and referencing search parameters.
+        # For samples that show how to call `Patient-everything`, see
+        # [Getting all patient compartment
+        # resources](/healthcare/docs/how-tos/fhir-resources#
+        # getting_all_patient_compartment_resources).
         # @param [String] name
         #   Name of the `Patient` resource for which the information is required.
         # @param [Fixnum] _count
         #   Maximum number of resources in a page. Defaults to 100.
         # @param [String] _page_token
         #   Used to retrieve the next or previous page of results
-        #   when using pagination. Value should be set to the value of `page_token` set
-        #   in next or previous page links' URLs. Next and previous page are returned
+        #   when using pagination. Set `_page_token` to the value of _page_token set
+        #   in next or previous page links' url. Next and previous page are returned
         #   in the response bundle's links field, where `link.relation` is "previous"
         #   or "next".
-        #   Omit `page_token` if no previous request has been made.
+        #   Omit `_page_token` if no previous request has been made.
+        # @param [String] _since
+        #   If provided, only resources updated after this time are
+        #   returned. The time uses the format YYYY-MM-DDThh:mm:ss.sss+zz:zz.
+        #   For example, `2015-02-07T13:28:17.239+02:00` or `2017-01-01T00:00:00Z`.
+        #   The time must be specified to the second and include a time zone.
+        # @param [String] _type
+        #   String of comma-delimited FHIR resource types. If provided, only resources
+        #   of the specified resource type(s) are returned.
         # @param [String] end_
         #   The response includes records prior to the end date. If no end date is
         #   provided, all records subsequent to the start date are in scope.
@@ -3037,13 +3050,15 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def patient_project_location_dataset_fhir_store_fhir_everything(name, _count: nil, _page_token: nil, end_: nil, start: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def patient_project_location_dataset_fhir_store_fhir_everything(name, _count: nil, _page_token: nil, _since: nil, _type: nil, end_: nil, start: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1beta1/{+name}/$everything', options)
           command.response_representation = Google::Apis::HealthcareV1beta1::HttpBody::Representation
           command.response_class = Google::Apis::HealthcareV1beta1::HttpBody
           command.params['name'] = name unless name.nil?
           command.query['_count'] = _count unless _count.nil?
           command.query['_page_token'] = _page_token unless _page_token.nil?
+          command.query['_since'] = _since unless _since.nil?
+          command.query['_type'] = _type unless _type.nil?
           command.query['end'] = end_ unless end_.nil?
           command.query['start'] = start unless start.nil?
           command.query['fields'] = fields unless fields.nil?
@@ -3055,6 +3070,10 @@ module Google
         # version) from the FHIR store. To remove all versions of a resource, first
         # delete the current version and then call this method.
         # This is not a FHIR standard operation.
+        # For samples that show how to call `Resource-purge`, see
+        # [Deleting historical versions of a FHIR
+        # resource](/healthcare/docs/how-tos/fhir-resources#
+        # deleting_historical_versions_of_a_fhir_resource).
         # @param [String] name
         #   The name of the resource to purge.
         # @param [String] fields
@@ -3146,6 +3165,10 @@ module Google
         # purge method.
         # This method requires the`healthcare.fhirStores.searchResources` and
         # `healthcare.fhirResources.delete` permissions on the parent FHIR store.
+        # For samples that show how to call `conditionalDelete`, see
+        # [Conditionally deleting a FHIR
+        # resource](/healthcare/docs/how-tos/fhir-resources#
+        # conditionally_deleting_a_fhir_resource).
         # @param [String] parent
         #   The name of the FHIR store this resource belongs to.
         # @param [String] type
@@ -3205,6 +3228,10 @@ module Google
         # This method requires the`healthcare.fhirStores.searchResources` permission
         # on the parent FHIR store and the `healthcare.fhirResources.patch`
         # permission on the requested FHIR store resource.
+        # For samples that show how to call `conditionalPatch`, see
+        # [Conditionally patching a FHIR
+        # resource](/healthcare/docs/how-tos/fhir-resources#
+        # conditionally_patching_a_fhir_resource).
         # @param [String] parent
         #   The name of the FHIR store this resource belongs to.
         # @param [String] type
@@ -3271,6 +3298,10 @@ module Google
         # GCP error might be returned instead.
         # This method requires the`healthcare.fhirStores.searchResources` and
         # `healthcare.fhirResources.update` permissions on the parent FHIR store.
+        # For samples that show how to call `conditionalUpdate`, see
+        # [Conditionally updating a FHIR
+        # resource](/healthcare/docs/how-tos/fhir-resources#
+        # conditionally_updating_a_fhir_resource).
         # @param [String] parent
         #   The name of the FHIR store this resource belongs to.
         # @param [String] type
@@ -3333,6 +3364,9 @@ module Google
         # `OperationOutcome` resource describing the reason for the error. If the
         # request cannot be mapped to a valid API method on a FHIR store, a generic
         # GCP error might be returned instead.
+        # For samples that show how to call `create`, see
+        # [Creating a FHIR
+        # resource](/healthcare/docs/how-tos/fhir-resources#creating_a_fhir_resource).
         # @param [String] parent
         #   The name of the FHIR store this resource belongs to.
         # @param [String] type
@@ -3384,6 +3418,9 @@ module Google
         # repository that can still be retrieved through vread
         # and related methods, unless they are removed by the
         # purge method.
+        # For samples that show how to call `delete`, see
+        # [Deleting a FHIR
+        # resource](/healthcare/docs/how-tos/fhir-resources#deleting_a_fhir_resource).
         # @param [String] name
         #   The name of the resource to delete.
         # @param [String] fields
@@ -3444,6 +3481,9 @@ module Google
         # individual requests in the bundle. For example, if the bundle contains a
         # `create` request, you must have permission to execute the `create` request.
         # Logging is available for the `executeBundle` permission.
+        # For samples that show how to call `executeBundle`, see
+        # [Managing FHIR resources using FHIR
+        # bundles](/healthcare/docs/how-tos/fhir-bundles).
         # @param [String] parent
         #   Name of the FHIR store in which this bundle will be executed.
         # @param [Google::Apis::HealthcareV1beta1::HttpBody] http_body_object
@@ -3489,6 +3529,10 @@ module Google
         # `OperationOutcome` resource describing the reason for the error. If the
         # request cannot be mapped to a valid API method on a FHIR store, a generic
         # GCP error might be returned instead.
+        # For samples that show how to call `history`, see
+        # [Listing FHIR resource
+        # versions](/healthcare/docs/how-tos/fhir-resources#
+        # listing_fhir_resource_versions).
         # @param [String] name
         #   The name of the resource to retrieve.
         # @param [String] _at
@@ -3561,6 +3605,9 @@ module Google
         # `OperationOutcome` resource describing the reason for the error. If the
         # request cannot be mapped to a valid API method on a FHIR store, a generic
         # GCP error might be returned instead.
+        # For samples that show how to call `patch`, see
+        # [Patching a FHIR
+        # resource](/healthcare/docs/how-tos/fhir-resources#patching_a_fhir_resource).
         # @param [String] name
         #   The name of the resource to update.
         # @param [Google::Apis::HealthcareV1beta1::HttpBody] http_body_object
@@ -3610,6 +3657,9 @@ module Google
         # `OperationOutcome` resource describing the reason for the error. If the
         # request cannot be mapped to a valid API method on a FHIR store, a generic
         # GCP error might be returned instead.
+        # For samples that show how to call `read`, see
+        # [Getting a FHIR
+        # resource](/healthcare/docs/how-tos/fhir-resources#getting_a_fhir_resource).
         # @param [String] name
         #   The name of the resource to retrieve.
         # @param [String] fields
@@ -3689,6 +3739,9 @@ module Google
         # Note: FHIR resources are indexed asynchronously, so there might be a slight
         # delay between the time a resource is created or changes and when the change
         # is reflected in search results.
+        # For samples and detailed information, see [Searching for FHIR
+        # resources](/healthcare/docs/how-tos/fhir-search) and [Advanced FHIR search
+        # features](/healthcare/docs/how-tos/fhir-advanced-search).
         # @param [String] parent
         #   Name of the FHIR store to retrieve resources from.
         # @param [Google::Apis::HealthcareV1beta1::SearchResourcesRequest] search_resources_request_object
@@ -3740,6 +3793,9 @@ module Google
         # `OperationOutcome` resource describing the reason for the error. If the
         # request cannot be mapped to a valid API method on a FHIR store, a generic
         # GCP error might be returned instead.
+        # For samples that show how to call `update`, see
+        # [Updating a FHIR
+        # resource](/healthcare/docs/how-tos/fhir-resources#updating_a_fhir_resource).
         # @param [String] name
         #   The name of the resource to update.
         # @param [Google::Apis::HealthcareV1beta1::HttpBody] http_body_object
@@ -3784,6 +3840,10 @@ module Google
         # `OperationOutcome` resource describing the reason for the error. If the
         # request cannot be mapped to a valid API method on a FHIR store, a generic
         # GCP error might be returned instead.
+        # For samples that show how to call `vread`, see
+        # [Retrieving a FHIR resource
+        # version](/healthcare/docs/how-tos/fhir-resources#
+        # retrieving_a_fhir_resource_version).
         # @param [String] name
         #   The name of the resource version to retrieve.
         # @param [String] fields
@@ -3955,6 +4015,70 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Import messages to the HL7v2 store by loading data from the specified
+        # sources. This method is optimized to load large quantities of data using
+        # import semantics that ignore some HL7v2 store configuration options and are
+        # not suitable for all use cases. It is primarily intended to load data into
+        # an empty HL7v2 store that is not being used by other clients.
+        # An existing message will be overwritten if a duplicate message is imported.
+        # A duplicate message is a message with the same raw bytes as a message that
+        # already exists in this HL7v2 store. When a message is overwritten, its
+        # labels will also be overwritten.
+        # The import operation is idempotent unless the input data contains multiple
+        # valid messages with the same raw bytes but different labels. In that case,
+        # after the import completes, the store contains exactly one message
+        # with those raw bytes but there is no ordering guarantee on which version
+        # of the labels it has. The operation result counters do not count
+        # duplicated raw bytes as an error and count one success for each message in
+        # the input, which might result in a success count larger than the number
+        # of messages in the HL7v2 store.
+        # If some messages fail to import, for example due to parsing errors,
+        # successfully imported messages are not rolled back.
+        # This method returns an Operation that can
+        # be used to track the status of the import by calling
+        # GetOperation.
+        # Immediate fatal errors appear in the
+        # error field, errors are also logged
+        # to Cloud Logging (see [Viewing
+        # logs](/healthcare/docs/how-tos/logging)). Otherwise, when the operation
+        # finishes, a response of type ImportMessagesResponse is returned in the
+        # response field.
+        # The metadata field type for this
+        # operation is OperationMetadata.
+        # @param [String] name
+        #   The name of the target HL7v2 store, in the format
+        #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        #   hl7v2Stores/`hl7v2_store_id``
+        # @param [Google::Apis::HealthcareV1beta1::ImportMessagesRequest] import_messages_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::HealthcareV1beta1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::HealthcareV1beta1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def import_hl7_v2_store_messages(name, import_messages_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta1/{+name}:import', options)
+          command.request_representation = Google::Apis::HealthcareV1beta1::ImportMessagesRequest::Representation
+          command.request_object = import_messages_request_object
+          command.response_representation = Google::Apis::HealthcareV1beta1::Operation::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::Operation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Lists the HL7v2 stores in the given dataset.
         # @param [String] parent
         #   Name of the dataset.
@@ -4112,12 +4236,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a message and sends a notification to the Cloud Pub/Sub topic. If
-        # configured, the MLLP adapter listens to messages created by this method and
-        # sends those back to the hospital. A successful response indicates the
-        # message has been persisted to storage and a Cloud Pub/Sub notification has
-        # been sent. Sending to the hospital by the MLLP adapter happens
-        # asynchronously.
+        # Parses and stores an HL7v2 message. This method triggers an asynchronous
+        # notification to any Cloud Pub/Sub topic configured in
+        # projects.locations.datasets.hl7V2Stores.Hl7V2NotificationConfig, if the
+        # filtering matches the message. If an MLLP adapter is configured to listen
+        # to a Cloud Pub/Sub topic, the adapter transmits the message when a
+        # notification is received.
         # @param [String] parent
         #   The name of the dataset this message belongs to.
         # @param [Google::Apis::HealthcareV1beta1::CreateMessageRequest] create_message_request_object
@@ -4214,9 +4338,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Ingests a new HL7v2 message from the hospital and sends a notification to
-        # the Cloud Pub/Sub topic. Return is an HL7v2 ACK message if the message was
-        # successfully stored. Otherwise an error is returned.
+        # Parses and stores an HL7v2 message. This method triggers an asynchronous
+        # notification to any Cloud Pub/Sub topic configured in
+        # projects.locations.datasets.hl7V2Stores.Hl7V2NotificationConfig, if the
+        # filtering matches the message. If an MLLP adapter is configured to listen
+        # to a Cloud Pub/Sub topic, the adapter transmits the message when a
+        # notification is received. This method also generates a response
+        # containing an HL7v2 acknowledgement (`ACK`) message when successful or a
+        # negative acknowledgement (`NACK`) message in case of error, suitable for
+        # replying to HL7v2 interface systems that expect these acknowledgements.
         # @param [String] parent
         #   The name of the HL7v2 store this message belongs to.
         # @param [Google::Apis::HealthcareV1beta1::IngestMessageRequest] ingest_message_request_object