Quickstart using the Cloud Console

This page shows you how to create a dataset and a DICOM, FHIR, or HL7v2 store using the Cloud Healthcare API with Google Cloud Console.

Before you begin

1. Sign in to your Google Account.

   If you don't already have one, sign up for a new account.

2. In the Google Cloud Console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to the project selector page

3. Make sure that billing is enabled for your Cloud project. Learn how to confirm that billing is enabled for your project.

4. Enable the Cloud Healthcare API.

   Enable the API

Create a dataset

Datasets are the basic containers that hold healthcare data in Google Cloud.

1. In the Cloud Console, go to the Datasets page.

   Go to the Datasets page

2. Click Create dataset.
3. Choose a dataset identifier that's unique in your project and region. If the identifier is not unique, the dataset creation fails.
4. Choose the region where the dataset permanently resides and then click Create.

The new dataset appears in the list.

Creating and managing DICOM, FHIR, and HL7v2 stores

To complete this quickstart, expand the relevant section:

Creating and managing DICOM stores

Create a DICOM store

To create a DICOM store:

1. In the Cloud Console, go to the Datasets page.

   Go to the Datasets page

2. Open the dataset where you want to create a DICOM store.
3. Click Create Data Store.
4. Enter a name of your choice that's unique in your dataset. If the name isn't unique, the data store creation fails.
5. Select DICOM as the Type.
6. If you want to configure a Pub/Sub topic for the data store, type the topic name. When specifying a Pub/Sub topic, enter the qualified URI to the topic, as shown in the following sample:

   projects/PROJECT_ID/topics/PUBSUB_TOPIC
   

7. Click Create.

The new data store appears in the list.

Get DICOM store details

To view details about the DICOM store:

1. In the Cloud Console, go to the Datasets page.

   Go to the Datasets page

2. Click the ID of the dataset that contains the DICOM store.
3. Click the name of the DICOM store.

Update a DICOM store

Cloud Console does not support editing the Pub/Sub topic. Instead, use curl, Windows PowerShell, or your preferred language.

Creating and managing FHIR stores

Create a FHIR store

To create a FHIR store:

1. In the Cloud Console, go to the Datasets page.

   Go to the Datasets page

2. Open the dataset where you want to create a FHIR store.
3. Click Create Data Store.
4. Select FHIR as the Type.
5. Enter a name of your choice that's unique in your dataset. If the name isn't unique, the FHIR store creation fails.
6. Choose the FHIR version for the FHIR store, one of DSTU2, STU3, or R4.
7. If you want to configure a Pub/Sub topic for the FHIR store, type the topic name. When specifying a Pub/Sub topic, enter the qualified URI to the topic, as shown in the following sample:

   projects/PROJECT_ID/topics/PUBSUB_TOPIC
   

8. Click Create.

The new FHIR store appears in the list.

Get FHIR store details

To view details about the FHIR store:

1. In the Cloud Console, go to the Datasets page.

   Go to the Datasets page

2. Click the ID of the dataset that contains the FHIR store.
3. Click the name of the FHIR store.

Update a FHIR store

Cloud Console does not support editing the Pub/Sub topic. Instead, use curl, Windows PowerShell, or your preferred language.

Creating and managing HL7v2 stores

Create an HL7v2 store

To create an HL7v2 store:

1. In the Cloud Console, go to the Datasets page.

   Go to the Datasets page

2. Open the dataset where you want to create an HL7v2 store.
3. Click Create Data Store.
4. Enter a name of your choice that's unique in your dataset. If the name isn't unique, the data store creation fails.
5. Select HL7v2 as the Type.
6. If you want to configure a Pub/Sub topic for the data store, type the topic name. When specifying a Pub/Sub topic, enter the qualified URI to the topic, as shown in the following sample:

   projects/PROJECT_ID/topics/PUBSUB_TOPIC
   

7. Click Create.

The new data store appears in the list.

Get HL7v2 store details

To view details about the HL7v2 store:

1. In the Cloud Console, go to the Datasets page.

   Go to the Datasets page

2. Click the ID of the dataset that contains the HL7v2 store.
3. Click the name of the HL7v2 store.

Update an HL7v2 store

Cloud Console does not support editing the Pub/Sub topic. Instead, use curl, Windows PowerShell, or your preferred language.

Clean up

To avoid incurring charges to your Google Cloud account for the resources used in this tutorial, you can clean up the resources you created on Google Cloud. If you created a new project for this tutorial, follow the steps in Delete the project. Otherwise, follow the steps in Delete the dataset and data store.

Delete the project

Caution: Deleting a project has the following effects:

• Everything in the project is deleted. If you used an existing project for this tutorial, when you delete it, you also delete any other work you've done in the project.
• Custom project IDs are lost. When you created this project, you might have created a custom project ID that you want to use in the future. To preserve the URLs that use the project ID, such as an appspot.com URL, delete selected resources inside the project instead of deleting the whole project.

If you plan to explore multiple tutorials and quickstarts, reusing projects can help you avoid exceeding project quota limits.

1. In the Cloud Console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Delete the dataset and data store

If you no longer need the dataset and data store created in this quickstart, you can delete the dataset. Deleting a dataset permanently deletes the dataset and any FHIR, HL7v2, or DICOM stores it contains.

To delete a dataset:

1. In the Cloud Console, go to the Datasets page.

   Go to the Datasets page

2. Select the dataset to delete.
3. Click Delete, type the identifier for the dataset to confirm, and then click Delete.

What's next

• Read an overview of Cloud Healthcare API concepts.
• Use Cloud Healthcare API with curl or Windows PowerShell
• Learn how to create and manage data stores for the following healthcare modalities:
  • Digital Imaging and Communications in Medicine (DICOM)
  • Fast Healthcare Interoperability Resources (FHIR)
  • Health Level Seven Version 2.x (HL7v2)