Method: videos.lookupVideo
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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.
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eFetches a video using its address or videoId, returning playback URIs for active videos or a processing state for pending ones.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a set of URIs for different media types if the video is active, along with its current state and metadata.\u003c/p\u003e\n"],["\u003cp\u003eA 404 error is returned if the video does not exist, and receiving a video is a billable event.\u003c/p\u003e\n"],["\u003cp\u003eThe request utilizes a \u003ccode\u003eGET\u003c/code\u003e method with the endpoint \u003ccode\u003ehttps://aerialview.googleapis.com/v1/videos:lookupVideo\u003c/code\u003e and requires either a \u003ccode\u003evideoId\u003c/code\u003e or \u003ccode\u003eaddress\u003c/code\u003e as a query parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe response body provides the video's URIs (if active), state, and metadata.\u003c/p\u003e\n"]]],["The core action is fetching a video using a `GET` request to `https://aerialview.googleapis.com/v1/videos:lookupVideo`. The request requires a `key` parameter, either a `videoId` or an `address`. The request body must be empty. A successful response returns a video object with `uris`, `state`, and `metadata`. `uris` map media types to URIs, `state` indicates the video's status, and `metadata` contains video details. The video can also be in `PROCESSING` or result in a 404 error.\n"],null,["# Method: videos.lookupVideo\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.Video.SCHEMA_REPRESENTATION)\n- [Uris](#Uris)\n - [JSON representation](#Uris.SCHEMA_REPRESENTATION)\n\nFetches a video given its address or videoId. The response will either be a video with a set of playback URIs for ACTIVE videos, a PROCESSING state for pending videos, or a 404 error if the video does not exist. Receiving a video is a billable event, so callers of this method should be ready to use the returned URIs at the time of request.\n\n### HTTP request\n\n`GET https://aerialview.googleapis.com/v1/videos:lookupVideo`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-----------|----------------------------------------------------|\n| Union parameter `key`. Required. A key used to look-up a video. `key` can be only one of the following: ||\n| `videoId` | `string` An ID returned from `videos.renderVideo`. |\n| `address` | `string` A US postal address. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nAn object that encapsulates all of the data about a video.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"uris\": { string: { object (/maps/documentation/aerial-view/reference/rest/v1/videos/lookupVideo#Uris) }, ... }, \"state\": enum (/maps/documentation/aerial-view/reference/rest/v1/State), \"metadata\": { object (/maps/documentation/aerial-view/reference/rest/v1/VideoMetadata) } } ``` |\n\n| Fields ||\n|------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `uris` | `map (key: string, value: object (`[Uris](/maps/documentation/aerial-view/reference/rest/v1/videos/lookupVideo#Uris)`))` A mapping of media types to their URIs. This field is only included for `ACTIVE` videos. The key is an enum value from `MediaFormat`. An object containing a list of `\"key\": value` pairs. Example: `{ \"name\": \"wrench\", \"mass\": \"1.3kg\", \"count\": \"3\" }`. |\n| `state` | `enum (`[State](/maps/documentation/aerial-view/reference/rest/v1/State)`)` Current state of the render request. |\n| `metadata` | `object (`[VideoMetadata](/maps/documentation/aerial-view/reference/rest/v1/VideoMetadata)`)` Contains the video's metadata, only set if the state is `ACTIVE`. |\n\nUris\n----\n\nContains all the uris for a given video format.\n\n| JSON representation |\n|-----------------------------------------------------------|\n| ``` { \"landscapeUri\": string, \"portraitUri\": string } ``` |\n\n| Fields ||\n|----------------|-----------------------------------------------------------------------------|\n| `landscapeUri` | `string` A signed short-lived URI for the media in a landscape orientation. |\n| `portraitUri` | `string` A signed short-lived URI for the media in a portrait orientation. |"]]
