photos

photos.getAlbums

Возвращает список фотоальбомов пользователя или сообщества.

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

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

Параметры

owner_id

string

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

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

album_ids

string

Перечисленные через запятую идентификаторы альбомов.

offset

positive

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

count

positive

Количество альбомов, которое нужно вернуть (по умолчанию возвращаются все альбомы).

need_system

checkbox

1 — будут возвращены системные альбомы, имеющие отрицательные идентификаторы.

Обратите внимание, что информация о системных альбомах возвращается даже в том случае, если они не содержат фотографий.

need_covers

checkbox

1 — будет возвращено дополнительное поле thumb_src с адресом изображения-обложки. По умолчанию поле thumb_src не возвращается.

photo_sizes

checkbox

1 — размеры фотографий будут возвращены в специальном формате.

Результат

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

  • id — идентификатор альбома;
  • thumb_id — идентификатор фотографии, которая является обложкой (0, если обложка отсутствует);
  • owner_id — идентификатор владельца альбома;
  • title — название альбома;
  • description — описание альбома (не приходит для системных альбомов);
  • created — дата создания альбома в формате unixtime (не приходит для системных альбомов);
  • updated — дата последнего обновления альбома в формате unixtime (не приходит для системных альбомов);
  • size — количество фотографий в альбоме;
  • can_upload1, если текущий пользователь может загружать фотографии в альбом (при запросе информации об альбомах сообщества);
  • privacy_view* — настройки приватности для альбома в формате настроек приватности (только для альбома пользователя, не приходит для системных альбомов);
  • privacy_comment* — настройки приватности для альбома в формате настроек приватности (только для альбома пользователя, не приходит для системных альбомов);
  • upload_by_admins_only* — кто может загружать фотографии в альбом (только для альбома сообщества, не приходит для системных альбомов);
  • comments_disabled* — отключено ли комментирование альбома (только для альбома сообщества, не приходит для системных альбомов);
  • thumb_src — ссылка на изображение обложки альбома (если был указан параметр need_covers).

* — поля возвращаются только при запросе информации об альбомах текущего пользователя или альбомах администрируемых им сообществ.

Коды ошибок

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

Связанные версии

Перейти на страницу версий API

Изменён формат данных, описывающих приватность.

Первый элемент возвращаемого массива теперь содержит число возвращаемых альбомов.