Method: videos.lookupVideo

Ruft ein Video anhand seiner Adresse oder videoId ab. Die Antwort ist entweder ein Video mit einer Reihe von Wiedergabe-URIs für AKTIVE Videos, den Status PROCESSING für ausstehende Videos oder ein 404-Fehler, wenn das Video nicht vorhanden ist. Der Empfang eines Videos ist kostenpflichtig. Daher sollten die Aufrufer dieser Methode in der Lage sein, die zurückgegebenen URIs zum Zeitpunkt der Anfrage zu verwenden.

HTTP-Anfrage

GET https://aerialview.googleapis.com/v1/videos:lookupVideo

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
Union-Parameter key. Erforderlich. Schlüssel zum Suchen eines Videos. Für key ist nur einer der folgenden Werte zulässig:
videoId

string

Eine von videos.renderVideo zurückgegebene ID.

address

string

Eine US-Postadresse.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Ein Objekt, das alle Daten zu einem Video zusammenfasst.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "uris": {
    string: {
      object (Uris)
    },
    ...
  },
  "state": enum (State),
  "metadata": {
    object (VideoMetadata)
  }
}
Felder
uris

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

Eine Zuordnung von Medientypen zu ihren URIs. Dieses Feld ist nur bei ACTIVE Videos enthalten. Der Schlüssel ist ein ENUM-Wert aus MediaFormat.

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

state

enum (State)

Aktueller Status der Renderinganfrage.

metadata

object (VideoMetadata)

Enthält die Metadaten des Videos, wird aber nur festgelegt, wenn der Status ACTIVE ist.

URIs

Enthält alle URIs für ein bestimmtes Videoformat.

JSON-Darstellung
{
  "landscapeUri": string,
  "portraitUri": string
}
Felder
landscapeUri

string

Ein signierter kurzlebiger URI für das Medium im Querformat.

portraitUri

string

Ein signierter kurzlebiger URI für die Medien im Hochformat.