video

video.get

Возвращает информацию о видеозаписях.

Этот метод можно вызвать с ключом доступа пользователя.

Требуются права доступа: video.

Параметры

owner_id

string

Идентификатор пользователя или сообщества, которому принадлежат видеозаписи.

Обратите внимание, идентификатор сообщества в параметре owner_id необходимо указывать со знаком «-» — например, owner_id=-1 соответствует идентификатору сообщества ВКонтакте API (club1).

videos

string

Перечисленные через запятую идентификаторы — идущие через знак подчеркивания id пользователей, которым принадлежат видеозаписи, и id самих видеозаписей. Если видеозапись принадлежит сообществу, то в качестве первого параметра используется -id сообщества.

Пример значения videos:

-4363_136089719,13245770_137352259

Некоторые видеозаписи, идентификаторы которых могут быть получены через API, закрыты приватностью, и не будут получены. В этом случае следует использовать ключ доступа access_key в её идентификаторе.

Пример значения videos:

1_129207899_220df2876123d3542f, 6492_135055734_e0a9bcc31144f67fbd

Поле access_key будет возвращено вместе с остальными данными видеозаписи в методах, которые возвращают видеозаписи, закрытые приватностью, но доступные в данном контексте. Например, данное поле имеют видеозаписи, возвращаемые методом messages.get.

album_id

string

Идентификатор альбома, видеозаписи из которого нужно вернуть. Если параметр не передан, возвращаются видео из альбома "Добавленные".

count

string

Количество возвращаемых видеозаписей.

offset

string

Смещение относительно первой найденной видеозаписи для выборки определённого подмножества.

extended

string

Определяет, возвращать ли информацию о настройках приватности видео для текущего пользователя, а так же дополнительные поля profiles и groups.

fields

string

Учитывается, если передан параметр extended. Дополняет поля profiles и groups.

Результат

После успешного выполнения возвращает объект, содержащий число результатов в поле count и массив объектов видеозаписей с дополнительным полем comments, содержащим число комментариев у видеозаписи, в поле items.

Если был задан параметр extended=1, возвращаются дополнительные поля:

  • privacy_view — настройки приватности в формате настроек приватности (приходит только для текущего пользователя).
  • privacy_comment — настройки приватности в формате настроек приватности (приходит только для текущего пользователя).
  • can_comment — может ли текущий пользователь оставлять комментарии к ролику (1 — может, 0 — не может).
  • can_repost — может ли текущий пользователь скопировать ролик с помощью функции «Рассказать друзьям» (1 — может, 0 — не может).
  • likes — информация об отметках «Мне нравится».
    • user_likes — есть ли отметка «Мне нравится» от текущего пользователя.
    • count — число отметок «Мне нравится»;
  • repeat — зацикливание воспроизведения видеозаписи (1 — зацикливается, 0 — не зацикливается).

Коды ошибок

204
Access denied

В ходе выполнения могут произойти общие ошибки.