Method: videos.lookupVideo
Извлекает видео по его адресу или идентификатору видео. Ответом будет либо видео с набором URI воспроизведения для АКТИВНЫХ видео, состояние ОБРАБОТКИ для ожидающих видео, либо ошибка 404, если видео не существует. Получение видео является платным событием, поэтому вызывающие этот метод должны быть готовы использовать возвращенные URI во время запроса.
HTTP-запрос
GET https://aerialview.googleapis.com/v1/videos:lookupVideo
URL-адрес использует синтаксис транскодирования gRPC .
Параметры запроса
Параметры |
---|
key параметра объединения. Необходимый. Ключ, используемый для поиска видео. key может быть только одним из следующих: |
videoId | string Идентификатор, возвращенный из videos.renderVideo . |
address | string Почтовый адрес США. |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
Объект, инкапсулирующий все данные о видео.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"uris": {
string: {
object (Uris )
},
...
},
"state": enum (State ),
"metadata": {
object (VideoMetadata )
}
} |
Поля |
---|
uris | map (key: string, value: object ( Uris )) Сопоставление типов мультимедиа с их URI. Это поле включается только для ACTIVE видео. Ключ — это значение перечисления из MediaFormat . Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } . |
state | enum ( State ) Текущее состояние запроса на рендеринг. |
metadata | object ( VideoMetadata ) Содержит метаданные видео, устанавливаются только в том случае, если состояние ACTIVE . |
Урис
Содержит все URI для данного видеоформата.
JSON-представление |
---|
{
"landscapeUri": string,
"portraitUri": string
} |
Поля |
---|
landscapeUri | string Подписанный кратковременный URI для средств массовой информации в альбомной ориентации. |
portraitUri | string Подписанный кратковременный URI для мультимедиа в портретной ориентации. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-11-13 UTC.
[null,null,["Последнее обновление: 2024-11-13 UTC."],[[["Fetches a video using its address or videoId, returning playback URIs for active videos or a processing state for pending ones."],["The response includes a set of URIs for different media types if the video is active, along with its current state and metadata."],["A 404 error is returned if the video does not exist, and receiving a video is a billable event."],["The request utilizes a `GET` method with the endpoint `https://aerialview.googleapis.com/v1/videos:lookupVideo` and requires either a `videoId` or `address` as a query parameter."],["The response body provides the video's URIs (if active), state, and metadata."]]],["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"]]