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

Ressource: Anmerkung

Eine Anmerkung ist eine Ressource im Asset. Es stellt eine Schlüssel/Wert-Zuordnung von Inhalten im Asset dar.

JSON-Darstellung
{
  "name": string,
  "userSpecifiedAnnotation": {
    object (UserSpecifiedAnnotation)
  }
}
Felder
name

string

Ressourcenname der Anmerkung. Format: projects/{project_number}/locations/{location}/corpora/{corpus}/assets/{asset}/annotations/{annotation}

userSpecifiedAnnotation

object (UserSpecifiedAnnotation)

Vom Nutzer bereitgestellte Anmerkung.

UserSpecifiedAnnotation

Von Nutzern bereitgestellte Anmerkungen.

JSON-Darstellung
{
  "key": string,
  "value": {
    object (AnnotationValue)
  },
  "partition": {
    object (Partition)
  }
}
Felder
key

string

Pflichtangabe. Schlüssel der Anmerkung. Der Schlüssel muss von CreateDataSchema mit dem Typ festgelegt werden.

value

object (AnnotationValue)

Wert der Anmerkung. Der Wert muss gemäß dem Datenschema in den Typ konvertiert werden können.

partition

object (Partition)

Informationen für die Anmerkung auf Unter-Asset-Ebene in Zeit und Raum partitionieren.

AnnotationValue

Wert der Anmerkung, einschließlich aller im Datenschema verfügbaren Typen.

JSON-Darstellung
{

  // 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.
}
Felder

Union-Feld value.

Für value ist nur einer der folgenden Werte zulässig:

intValue

string (int64 format)

Wert der Anmerkung vom Typ „int“.

floatValue

number

Wert der Anmerkung vom Typ „Gleitkommazahl“.

strValue

string

Wert der Anmerkung vom Typ „String“.

datetimeValue

string

Wert der Anmerkung vom Typ „Datum/Uhrzeit“.

geoCoordinate

object (GeoCoordinate)

Wert der Anmerkung zum Typ der geografischen Koordinaten.

protoAnyValue

object

Wert eines beliebigen Proto-Werts.

Ein Objekt, das Felder eines beliebigen Typs enthält. Ein zusätzliches Feld "@type" enthält einen URI zur Identifizierung des Typs. Beispiel: { "id": 1234, "@type": "types.example.com/standard/id" }.

boolValue

boolean

Wert der Anmerkung vom Typ „boolescher Wert“.

customizedStructDataValue

object (Struct format)

Wert der Anmerkung für die benutzerdefinierte Struktur. Dieses Feld hat keine Auswirkungen. Verwenden Sie stattdessen „customizedStructValue“ für die Anmerkung einer benutzerdefinierten Struktur.

listValue

object (AnnotationList)

Wert der Anmerkung für den Listentyp.

customizedStructValue

object (AnnotationCustomizedStruct)

Wert der Anmerkung für benutzerdefinierte Strukturtypen.

GeoCoordinate

Darstellung von Standortkoordinaten

JSON-Darstellung
{
  "latitude": number,
  "longitude": number
}
Felder
latitude

number

Breitengradkoordinate. Grad [−90 .. 90]

longitude

number

Längengradkoordinate. Grad [−180 .. 180]

AnnotationList

Listendarstellung in der Anmerkung.

JSON-Darstellung
{
  "values": [
    {
      object (AnnotationValue)
    }
  ]
}
Felder
values[]

object (AnnotationValue)

Die Werte der Datentyp-Anmerkung LIST.

AnnotationCustomizedStruct

Benutzerdefinierte Strukturdarstellung in Anmerkung

JSON-Darstellung
{
  "elements": {
    string: {
      object (AnnotationValue)
    },
    ...
  }
}
Felder
elements

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

Eine Zuordnung der Schlüssel der Elemente zum Anmerkungswert des Elements.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Partition

Partition, um die Partition in Zeit und Raum für die Anmerkung auf Unter-Asset-Ebene anzugeben.

JSON-Darstellung
{
  "temporalPartition": {
    object (TemporalPartition)
  },
  "spatialPartition": {
    object (SpatialPartition)
  },
  "relativeTemporalPartition": {
    object (RelativeTemporalPartition)
  }
}
Felder
temporalPartition

object (TemporalPartition)

Partitionierung des Assets im Zeitverlauf.

spatialPartition

object (SpatialPartition)

Partitionierung des Assets im Raum.

relativeTemporalPartition

object (RelativeTemporalPartition)

Partitionierung des Assets im Zeitverlauf.

TemporalPartition

Partition des Assets in der UTC-Epochenzeit. Wird vom Corpustyp „STREAM_VIDEO“ unterstützt.

JSON-Darstellung
{
  "startTime": string,
  "endTime": string
}
Felder
startTime

string (Timestamp format)

Startzeit der Partition.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

Endzeit der Partition.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

SpatialPartition

Partitionierung des Assets im Raum.

JSON-Darstellung
{
  "xMin": string,
  "yMin": string,
  "xMax": string,
  "yMax": string
}
Felder
xMin

string (int64 format)

Der minimale Wert der x-Koordinate.

yMin

string (int64 format)

Der minimale Wert der y-Koordinate.

xMax

string (int64 format)

Der maximale Wert der X-Koordinate.

yMax

string (int64 format)

Der maximale Wert der y-Koordinate.

RelativeTemporalPartition

Partitionierung des Assets in relativer Zeit. Wird vom Korpustyp „VIDEO_ON_DEMAND“ unterstützt.

JSON-Darstellung
{
  "startOffset": string,
  "endOffset": string
}
Felder
startOffset

string (Duration format)

Startzeit-Offset der Partition.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

endOffset

string (Duration format)

Endzeitversatz der Partition.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

Methoden

create

Erstellt eine Anmerkung innerhalb des Assets.

delete

Löscht die Anmerkung im Asset.

get

Liest Anmerkungen im Asset.

list

Listet eine Liste von Anmerkungen im Asset auf.

patch

Aktualisiert die Anmerkung im Asset.