Method: videos.lookupVideo

Recupera un video in base all'indirizzo o all'ID video. La risposta potrà essere un video con un insieme di URI di riproduzione per i video ATTIVI, uno stato IN ELABORAZIONE per i video in attesa o un errore 404 se il video non esiste. La ricezione di un video è un evento fatturabile, quindi i chiamanti di questo metodo devono essere pronti a utilizzare gli URI restituiti al momento della richiesta.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
Parametro di unione key. Obbligatorio. Chiave utilizzata per cercare un video. key può essere solo uno dei seguenti:
videoId

string

Un ID restituito da videos.renderVideo.

address

string

Un indirizzo postale statunitense.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Un oggetto che incapsula tutti i dati relativi a un video.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "uris": {
    string: {
      object (Uris)
    },
    ...
  },
  "state": enum (State),
  "metadata": {
    object (VideoMetadata)
  }
}
Campi
uris

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

Una mappatura dei tipi di media ai relativi URI. Questo campo è incluso solo per i video ACTIVE. La chiave è un valore enum di MediaFormat.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

state

enum (State)

Stato attuale della richiesta di rendering.

metadata

object (VideoMetadata)

Contiene i metadati del video, impostati solo se lo stato è ACTIVE.

URI

Contiene tutti gli URI di un determinato formato video.

Rappresentazione JSON
{
  "landscapeUri": string,
  "portraitUri": string
}
Campi
landscapeUri

string

Un URI firmato di breve durata per i contenuti multimediali in un orientamento orizzontale.

portraitUri

string

Un URI firmato di breve durata per i contenuti multimediali in orientamento verticale.