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, der Status PROCESSING (Verarbeitung läuft) für ausstehende Videos oder ein 404-Fehler, wenn das Video nicht vorhanden ist. Der Empfang eines Videos ist ein kostenpflichtiges Ereignis. Die Aufrufer dieser Methode sollten daher zum Zeitpunkt der Anfrage bereit sein, die zurückgegebenen URIs 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. Ein 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 Postanschrift in den USA.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Ein Objekt, das alle Daten zu einem Video einschließt.

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 für 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 und wird nur festgelegt, wenn der Status ACTIVE lautet.

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 die Medien im Querformat.
portraitUri

string

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