Method: messages.ingest

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

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.

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 Google 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.