Method: videos.lookupVideo

Extrait une vidéo en fonction de son adresse ou de son ID vidéo. La réponse est soit une vidéo avec un ensemble d'URI de lecture pour les vidéos ACTIVES, un état en cours de traitement pour les vidéos en attente, soit une erreur 404 si la vidéo n'existe pas. La réception d'une vidéo est un événement facturable. Les appelants de cette méthode doivent donc ê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 avec leurs URI. Ce champ n'est inclus que pour ACTIVE vidéos. La clé est une valeur d'énumération issue 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éfinies 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 mode portrait.