Method: assets.get
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Получает метаданные для указанного актива. Обратите внимание: если в запросе указан ресурс, который был объединен с другим ресурсом, то есть YouTube определил запрошенный ресурс как дубликат, тогда запрос получает объединенный или синтезированный ресурс.
HTTP-запрос
GET https://youtubepartner.googleapis.com/youtube/partner/v1/assets/{assetId}
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры |
|---|
assetId | string Параметр assetId указывает идентификатор извлекаемого ресурса YouTube. |
Параметры запроса
| Параметры |
|---|
fetchMatchPolicy | string Параметр fetchMatchPolicy указывает версию политики сопоставления ресурса, которая должна быть возвращена в ответе API. Параметр fetchMatchPolicy указывает разделенный запятыми список версий политики сопоставления ресурса, который должен быть возвращен в ответе API. Устаревшее поле matchPolicy устанавливается только в том случае, если указано ровно одно значение fetchMatchPolicy . Приемлемые значения: -
effective – получение политики совпадения, которую YouTube применяет к активу. -
mine — получить политику совпадения, установленную владельцем контента по умолчанию для текущего аутентифицированного пользователя. -
none — не получать политику сопоставления актива. Это значение по умолчанию.
|
fetchMetadata | string Параметр fetchMetadata указывает версию метаданных ресурса, которые должны быть возвращены в ответе API. В некоторых случаях YouTube получает метаданные для объекта из нескольких источников, например, когда объектом владеют разные партнеры на разных территориях. |
fetchOwnership | string Параметр fetchOwnership указывает версию данных о владельце актива, которые должны быть возвращены в ответе API. Как и в случае с метаданными объектов, YouTube может получать данные о владельцах объектов из нескольких источников. Параметр fetchOwnership указывает разделенный запятыми список версий данных о владельце актива, которые должны быть возвращены в ответе API. Как и в случае с метаданными объектов, YouTube может получать данные о владельцах объектов из нескольких источников.
ownership устаревшим полем устанавливается только в том случае, если указано ровно одно значение fetchOwnership .
Приемлемые значения: -
canonical – этот параметр устарел . Смотрите effective . -
effective – получение данных о владельце, которые YouTube алгоритмически определил как наиболее точные для объекта. -
mine — получить данные о владельце, предоставленные владельцем контента по умолчанию, связанным с текущим аутентифицированным пользователем. -
none — не получать никаких данных о владельце. Это значение по умолчанию.
|
fetchOwnershipConflicts | boolean Параметр fetchOwnershipConflicts позволяет получить информацию о конфликтах владения. |
onBehalfOfContentOwner | string Параметр onBehalfOfContentOwner определяет владельца контента, от имени которого действует пользователь. Этот параметр поддерживает пользователей, чьи учетные записи связаны с несколькими владельцами контента. |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
В случае успеха тело ответа содержит экземпляр Asset .
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/youtubepartner
Для получения дополнительной информации см.OAuth 2.0 Overview .
Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-21 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-08-21 UTC."],[],["This document details how to retrieve metadata for a specific YouTube asset using a `GET` request. The request URL structure includes the asset's ID as a path parameter. Optional query parameters allow specification of the desired version of match policy (`fetchMatchPolicy`), metadata (`fetchMetadata`), ownership data (`fetchOwnership`), and ownership conflicts (`fetchOwnershipConflicts`). The `onBehalfOfContentOwner` parameter allows specifying a content owner. The request body must be empty, and the successful response returns an `Asset` instance. The user needs to be authorized using `https://www.googleapis.com/auth/youtubepartner` scope.\n"]]