video

video.getAlbums

The translation was generated automatically and may contain mistakes

Returns a list of albums of the user's or community's video recordings.

To call this method, you can use:
• user access token (access right required: video — this is issued in exceptional cases by a request to support at devsupport@corp.vk.com)

Parameters

owner_id

integer

The ID of the album owner, user, or community. By default, the current user ID. To specify the community ID, put a sign in front of the ID -.

offset

positive

The bias required to sample a specific subset of albums. By default: 0 .

count

positive

Number of albums that need to be returned. By default: no more 50 , maximum value: 100 .

extended

checkbox

1 Return additional fields count , updated_time and array of objects image for each album. If the album is empty, then the array of objects image It will not be returned to him. By default: 0 . Object Fields image :

  • •

    "height" ( integer The height of the image.

  • •

    "url" ( string ) — a reference to the image.

  • •

    "width" ( integer The width of the image.

  • •

    "with_padding" ( integer ) — поле возвращается, если изображение с отбивкой, всегда содержит 1 .

need_system

checkbox

1 Return the system albums.

Result

After successful execution, it returns an object containing the number of results in the field count and an array of album objects in the field items . Each of the objects describing the album contains the following fields:

  • •
    id ID of the album;
  • •
    owner_id ID of the owner of the album;
  • •
    title Name of the album;
  • •
    response_type Type of response: min - if the query has a parameter extended = 0, the answer contains only the fields listed above; full - if extended = 1, the answer contains additional fields.

Error codes

104
Not found
204
Access denied

Common errors may occur during execution

Linked versions

Go to API versions page
5.30

The data format has been changed, describes the privacy .