Method: videos.lookupVideo

Extrait une vidéo à partir de son adresse ou de son ID vidéo. La réponse sera soit une vidéo avec un ensemble d'URI de lecture pour les vidéos ACTIVES, un état de TRAITEMENT pour les vidéos en attente ou une erreur 404 si la vidéo n'existe pas. La réception d'une vidéo est un événement facturable. Par conséquent, les appelants de cette méthode doivent être prêts à utiliser les URI renvoyés au moment de la requête.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
Paramètre d'union key. Obligatoire. Clé utilisée pour rechercher une vidéo. key ne peut être qu'un des éléments suivants :
videoId

string

ID renvoyé par videos.renderVideo.
address

string

Adresse postale aux États-Unis.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Objet qui encapsule toutes les données concernant une vidéo.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "uris": {
    string: {
      object (Uris)
    },
    ...
  },
  "state": enum (State),
  "metadata": {
    object (VideoMetadata)
  }
}
Champs
uris

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

Mappage des types de médias sur leurs URI. Ce champ n'est inclus que pour ACTIVE vidéos. La clé est une valeur d'énumération de MediaFormat.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
state

enum (State)

État actuel de la requête de rendu.
metadata

object (VideoMetadata)

Contient les métadonnées de la vidéo (définie uniquement si l'état est ACTIVE).

URI

Contient tous les URI d'un format vidéo donné.

Représentation JSON 
{
  "landscapeUri": string,
  "portraitUri": string
}
Champs
landscapeUri

string

URI éphémère signé pour le contenu multimédia en mode paysage.
portraitUri

string

URI éphémère signé pour le contenu multimédia en orientation portrait.