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

リソース: Annotation

アノテーションは、アセット内のリソースです。アセット内のコンテンツの Key-Value マッピングを表します。

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「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
endTime

string (Timestamp format)

パーティションの終了時刻。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "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 で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。
endOffset

string (Duration format)

パーティションの終了時刻オフセット。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。

メソッド

create

 アセット内にアノテーションを作成します。

delete

 アセット内のアノテーションを削除します。

get

 アセット内のアノテーションを読み取ります。

list

 アセット内のアノテーションのリストを表示します。

patch

 アセット内のアノテーションを更新します。