REST Resource: projects.locations.corpora.assets.annotations

资源：注释

注释是素材资源中的资源。它表示素材资源中内容的键值对映射。

JSON 表示法 
{
  "name": string,
  "userSpecifiedAnnotation": {
    object (UserSpecifiedAnnotation)
  }
}
字段
name

string

注释的资源名称。格式：projects/{project_number}/locations/{location}/corpora/{corpus}/assets/{asset}/annotations/{annotation}
userSpecifiedAnnotation

object (UserSpecifiedAnnotation)

用户提供的注释。

UserSpecifiedAnnotation

用户提供的注释。

JSON 表示法 
{
  "key": string,
  "value": {
    object (AnnotationValue)
  },
  "partition": {
    object (Partition)
  }
}
字段
key

string

必需。注解的键。必须通过 CreateDataSchema 设置键的类型。
value

object (AnnotationValue)

注释的值。该值必须能够根据数据架构转换为该类型。
partition

object (Partition)

子资产级注释的时间和空间分区信息。

AnnotationValue

注解的值，包括数据架构中提供的所有类型。

JSON 表示法 
{

  // Union field value can be only one of the following:
  "intValue": string,
  "floatValue": number,
  "strValue": string,
  "datetimeValue": string,
  "geoCoordinate": {
    object (GeoCoordinate)
  },
  "protoAnyValue": {
    "@type": string,
    field1: ...,
    ...
  },
  "boolValue": boolean,
  "customizedStructDataValue": {
    object
  },
  "listValue": {
    object (AnnotationList)
  },
  "customizedStructValue": {
    object (AnnotationCustomizedStruct)
  }
  // End of list of possible types for union field value.
}
字段

联合字段 value。

value 只能是下列其中一项：
intValue

string (int64 format)

int 类型注解的值。
floatValue

number

浮点类型注解的值。
strValue

string

字符串类型注解的值。
datetimeValue

string

日期时间类型注解的值。
geoCoordinate

object (GeoCoordinate)

地理坐标类型注释的值。
protoAnyValue

object

任何 proto 值的值。

此对象可以包含任意类型的字段。附加字段 "@type" 包含用于标示相应类型的 URI。示例：{ "id": 1234, "@type": "types.example.com/standard/id" }。
boolValue

boolean

布尔类型注解的值。
customizedStructDataValue

object (Struct format)

自定义结构体注解的值。此字段没有任何影响。请改用 customizedStructValue 来进行自定义结构体注解。
listValue

object (AnnotationList)

列表类型注解的值。
customizedStructValue

object (AnnotationCustomizedStruct)

自定义结构体类型注解的值。

GeoCoordinate

位置坐标表示法

JSON 表示法 
{
  "latitude": number,
  "longitude": number
}
字段
latitude

number

纬度坐标。度数 [-90 到 90]
longitude

number

经度坐标。度数 [-180 到 180]

AnnotationList

注释中的列表表示法。

JSON 表示法 
{
  "values": [
    {
      object (AnnotationValue)
    }
  ]
}
字段
values[]

object (AnnotationValue)

LIST 数据类型注解的值。

AnnotationCustomizedStruct

注解中的自定义结构体表示法。

JSON 表示法 
{
  "elements": {
    string: {
      object (AnnotationValue)
    },
    ...
  }
}
字段
elements

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

从元素键到元素注解值的映射。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

分区

分区，用于指定子资产级注释的时间和空间分区。

JSON 表示法 
{
  "temporalPartition": {
    object (TemporalPartition)
  },
  "spatialPartition": {
    object (SpatialPartition)
  },
  "relativeTemporalPartition": {
    object (RelativeTemporalPartition)
  }
}
字段
temporalPartition

object (TemporalPartition)

按时间对资产进行分区。
spatialPartition

object (SpatialPartition)

空间中资产的分区。
relativeTemporalPartition

object (RelativeTemporalPartition)

按时间对资产进行分区。

TemporalPartition

资产的分区，采用世界协调时间 (UTC) 纪元时间。STREAM_VIDEO 语料库类型支持此属性。

JSON 表示法 
{
  "startTime": string,
  "endTime": string
}
字段
startTime

string (Timestamp format)

分区的开始时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
endTime

string (Timestamp format)

分区的结束时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

SpatialPartition

空间中资产的分区。

JSON 表示法 
{
  "xMin": string,
  "yMin": string,
  "xMax": string,
  "yMax": string
}
字段
xMin

string (int64 format)

最小 x 坐标值。
yMin

string (int64 format)

最小 y 坐标值。
xMax

string (int64 format)

最大 x 坐标值。
yMax

string (int64 format)

最大 y 坐标值。

RelativeTemporalPartition

按相对时间对资产进行分区。受 VIDEO_ON_DEMAND 语料库类型支持。

JSON 表示法 
{
  "startOffset": string,
  "endOffset": string
}
字段
startOffset

string (Duration format)

分区的开始时间偏移量。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。
endOffset

string (Duration format)

分区的结束时间偏移量。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。

方法

create

 在资源中创建注释。

delete

 删除资产中的注释。

get

 读取资产内的注解。

list

 列出资源中的注释列表。

patch

 更新了资源中的注解。