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 '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)

파티션의 시작 시간 오프셋입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
endOffset

string (Duration format)

파티션의 종료 시간 오프셋입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

메서드

create

 애셋 내에 주석을 만듭니다.

delete

 저작물 내의 주석을 삭제합니다.

get

 애셋 내의 주석을 읽습니다.

list

 저작물 내의 주석 목록을 나열합니다.

patch

 저작물 내 주석을 업데이트합니다.