photos

photos.createAlbum

Создает пустой альбом для фотографий.

Для вызова метода можно использовать:
• ключ доступа пользователя (требуется право доступа: photos — выдаётся в исключительных случаях через запрос в поддержку по электронной почте devsupport@corp.vk.com)

Параметры

title

string

Название альбома.

Обязательный параметр Мин. длина = 2

group_id

integer

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

description

string

Текст описания альбома.

privacy

integer

Уровень доступа к альбому (только для альбома пользователя). Возможные значения:

  • •
    0 — все пользователи,
  • •
    1 — только друзья,
  • •
    2 — друзья и друзья друзей,
  • •
    3 — только я.
comment_privacy

integer

Уровень доступа к комментированию альбома (только для альбома пользователя). Возможные значения:

  • •
    0 — все пользователи,
  • •
    1 — только друзья,
  • •
    2 — друзья и друзья друзей,
  • •
    3 — только я.
privacy_view

string

Настройки приватности просмотра альбома в специальном формате.

privacy_comment

string

Настройки приватности комментирования альбома в специальном формате.

upload_by_admins_only

checkbox

Кто может загружать фотографии в альбом (только для альбома сообщества). Возможные значения:

  • •
    0 — фотографии могут добавлять все пользователи;
  • •
    1 — фотографии могут добавлять только редакторы и администраторы.
comments_disabled

checkbox

Отключено ли комментирование альбома (только для альбома сообщества). Возможные значения:

  • •
    0 — комментирование включено;
  • •
    1 — комментирование отключено.

Результат

После успешного выполнения возвращает объект, который содержит следующие поля:

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

Коды ошибок

302
Albums number limit is reached

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

Связанные методы

photos.editAlbum

Редактирует данные альбома для фотографий.

photos.deleteAlbum

Удаляет указанный альбом для фотографий у текущего пользователя

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

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

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