Method: messages.ingest

Full name: projects.locations.datasets.hl7V2Stores.messages.ingest

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.

HTTP request

POST https://healthcare.googleapis.com/v1beta1/{parent=projects/*/locations/*/datasets/*/hl7V2Stores/*}/messages:ingest

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

The name of the HL7v2 store this message belongs to.

Authorization requires the following IAM permission on the specified resource parent:

  • healthcare.hl7V2Messages.ingest

Request body

The request body contains data with the following structure:

JSON representation
{
  "message": {
    object(Message)
  }
}
Fields
message

object(Message)

HL7v2 message to ingest.

Response body

If successful, the response body contains data with the following structure:

Acknowledges that a message has been ingested into the specified HL7v2 store.

JSON representation
{
  "hl7Ack": string,
  "message": {
    object(Message)
  }
}
Fields
hl7Ack

string (bytes format)

HL7v2 ACK message.

A base64-encoded string.

message

object(Message)

Created message resource.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-healthcare
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.