REST Resource: projects.locations.datasets.annotationStores.annotations

Resource: Annotation

An annotation record.

JSON representation
{
  "name": string,
  "annotationSource": {
    object(AnnotationSource)
  },
  "customData": {
    string: string,
    ...
  },

  // Union field data can be only one of the following:
  "resourceAnnotation": {
    object(ResourceAnnotation)
  },
  "imageAnnotation": {
    object(ImageAnnotation)
  },
  "textAnnotation": {
    object(SensitiveTextAnnotation)
  }
  // End of list of possible types for union field data.
}
Fields
name

string

Identifier. Resource name of the Annotation, of the form projects/{projectId}/locations/{locationId}/datasets/{datasetId}/annotationStores/{annotationStoreId}/annotations/{annotationId}.

annotationSource

object(AnnotationSource)

Required. Details of the source.

customData

map (key: string, value: string)

Additional information for this annotation record, such as annotator and verifier information or study campaign.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Union field data.

data can be only one of the following:

resourceAnnotation

object(ResourceAnnotation)

Annotations for resource. For example, classification tags.

imageAnnotation

object(ImageAnnotation)

Annotations for images. For example, bounding polygons.

textAnnotation

object(SensitiveTextAnnotation)

Annotations for sensitive texts. For example, a range that describes the location of sensitive text.

AnnotationSource

AnnotationSource holds the source information of the annotation.

JSON representation
{

  // Union field source can be only one of the following:
  "cloudHealthcareSource": {
    object(CloudHealthcareSource)
  }
  // End of list of possible types for union field source.
}
Fields

Union field source.

source can be only one of the following:

cloudHealthcareSource

object(CloudHealthcareSource)

Cloud Healthcare API resource.

CloudHealthcareSource

Cloud Healthcare API resource.

JSON representation
{
  "name": string
}
Fields
name

string

Full path of a Cloud Healthcare API resource.

ResourceAnnotation

Resource level annotation.

JSON representation
{
  "label": string
}
Fields
label

string

A description of the annotation record.

ImageAnnotation

Image annotation.

JSON representation
{
  "boundingPolys": [
    {
      object(BoundingPoly)
    }
  ],
  "frameIndex": integer
}
Fields
boundingPolys[]

object(BoundingPoly)

The list of polygons outlining the sensitive regions in the image.

frameIndex

integer

0-based index of the image frame. For example, an image frame in a DICOM instance.

BoundingPoly

A bounding polygon for the detected image annotation.

JSON representation
{
  "vertices": [
    {
      object(Vertex)
    }
  ],
  "label": string
}
Fields
vertices[]

object(Vertex)

List of the vertices of this polygon.

label

string

A description of this polygon.

Vertex

A 2D coordinate in an image. The origin is the top-left.

JSON representation
{
  "x": number,
  "y": number
}
Fields
x

number

X coordinate.

y

number

Y coordinate.

SensitiveTextAnnotation

A TextAnnotation specifies a text range that includes sensitive information.

JSON representation
{
  "details": {
    string: {
      object(Detail)
    },
    ...
  }
}
Fields
details

map (key: string, value: object(Detail))

Maps from a resource slice. For example, FHIR resource field path to a set of sensitive text findings. For example, Appointment.Narrative text1 --> {findings_1, findings_2, findings_3}

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Detail

Contains multiple sensitive information findings for each resource slice.

JSON representation
{
  "findings": [
    {
      object(Finding)
    }
  ]
}
Fields
findings[]

object(Finding)

Finding

JSON representation
{
  "infoType": string,
  "start": string,
  "end": string,
  "quote": string
}
Fields
infoType

string

The type of information stored in this text range. For example, HumanName, BirthDate, or Address.

start

string (int64 format)

Zero-based starting index of the found text, inclusively.

end

string (int64 format)

Zero-based ending index of the found text, exclusively.

quote

string

The snippet of the sensitive text. This field is only populated during deidentification if storeQuote is set to true in DeidentifyConfig.

Methods

create

Creates a new Annotation record.

delete

Deletes an Annotation or returns NOT_FOUND if it does not exist.

get

Gets an Annotation.

list

Lists the Annotations in the given Annotation store for a source resource.

patch

Updates the Annotation.