For details on the implementation of frames.retrieveFrames, see DICOM frames in the Cloud Healthcare API conformance statement.
For samples that show how to call frames.retrieveFrames, see Retrieve DICOM data.
HTTP request
GET https://healthcare.googleapis.com/v1/{parent=projects/*/locations/*/datasets/*/dicomStores/*}/dicomWeb/{dicomWebPath=studies/*/series/*/instances/*/frames/*}
Required. The name of the DICOM store that is being accessed. For example, projects/{projectId}/locations/{locationId}/datasets/{datasetId}/dicomStores/{dicomStoreId}.
Authorization requires the following IAM permission on the specified resource parent:
healthcare.dicomStores.dicomWebRead
dicomWebPath
string
Required. The path of the frames.retrieveFrames DICOMweb request. For example, studies/{studyUid}/series/{seriesUid}/instances/{instanceUid}/frames/{frame_list}.
Request body
The request body must be empty.
Response body
If successful, the response is a generic HTTP response whose format is defined by the method.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-27 UTC."],[[["The `frames.retrieveFrames` method retrieves DICOM instances associated with a specific study, series, SOP Instance UID, and frame numbers, as detailed in the DICOM RetrieveTransaction specification."],["Accessing this method requires a `GET` request to a specific URL structured using gRPC Transcoding syntax, including parameters for project, location, dataset, DICOM store, study, series, instance, and frame."],["The request must include a `parent` path parameter specifying the DICOM store and a `dicomWebPath` parameter defining the path to the frames being retrieved."],["Authorization to use `frames.retrieveFrames` requires either the `healthcare.dicomStores.dicomWebRead` IAM permission or one of the specified OAuth scopes (`https://www.googleapis.com/auth/cloud-healthcare` or `https://www.googleapis.com/auth/cloud-platform`)."],["The request body for this method must be empty, and a successful request will return a generic HTTP response, the format of which is defined by the method."]]],[]]
