Настройки приватности

Настройки приватности представляют собой массив, который может содержать следующие значения:

  • •
    all — доступно всем пользователям.
  • •
    friends — доступно друзьям текущего пользователя.
  • •
    friends_of_friends — доступно друзьям и друзьям друзей.
  • •
    friends_of_friends_only — доступно друзьям друзей текущего пользователя. Доступно с версии API 5.32.
  • •
    nobody — недоступно никому.
  • •
    only_me — доступно только мне.
  • •
    list{list_id} — доступно друзьям текущего пользователя из списка с идентификатором {list_id}.
  • •
    {user_id} — доступно другу с идентификатором {user_id}.
  • •
    -list{list_id} — недоступно друзьям текущего пользователя из списка с идентификатором {list_id}.
  • •
    -{user_id} — недоступно другу с идентификатором {user_id}.

Виды приватностей сообществ

Видео имеет приватность сообщества, если владелец видео — сообщество, а не пользователь. Приватность можно указывать как текстом, так и числом.

Ограничения

  • •
    all (0) — доступно только для открытых сообществ.
  • •
    donut (5) — доступно только для сообществ, в которых включён параметр «VK Donut».

Приватность просмотра (privacy_view)

  • •
    all (0) — доступно всем пользователям.
  • •
    members (1) — доступно участникам.
  • •
    editors (2) — доступно редакторам и администраторам.
  • •
    by_link (3) — доступно тем, у кого есть ссылка.
  • •
    donut (5) — доступно донам.

Приватность комментирования (privacy_comment)

  • •
    all (0) — доступно всем пользователям.
  • •
    members (1) — доступно участникам.
  • •
    editors (2) — доступно редакторам и администраторам.
  • •
    nobody (4) — недоступно никому.

Пример

Доступно всем пользователям, кроме друзей из списка №2 и кроме друга с идентификатором 743784474.

JSON
privacy_view: ['all', '-list2', -743784474],

Версии API ниже 5.30

Получение приватности

Для версий ниже 5.30 названия полей и их структура отличаются от приведённых выше. Приватность возвращается в API в виде объекта, содержащего следующие поля:

type

string Тип приватности. Возможные значения:

  • •
    nobody — никто.
  • •
    all — все пользователи.
  • •
    friends — друзья текущего пользователя.
  • •
    friends_of_friends — друзья друзей текущего пользователя.
  • •
    users — определенный список пользователей, переданный в поле users.

lists

array[integer] Массив из пользовательских списков, которые добавляются к пользователям, принадлежащим к типу в поле type.

except_lists

array[integer] Массив из пользовательских списков, которые исключаются из пользователей, принадлежащих к типу в поле type.

users

array[integer] Массив из идентификаторов пользователей, которые добавляются к пользователям, принадлежащим к типу в поле type.

except_users

array[integer] Массив из идентификаторов пользователей, которые исключаются из пользователей, принадлежащих к типу в поле type.

Пример

Доступно друзьям пользователя, кроме друзей из списков №25 и №27.

JSON
privacy_view: { type: 'friends', except_lists: [25, 27] },

Указание приватности

Некоторые методы позволяют устанавливать приватность на объекты, для этого предусмотрен специальный формат значений, передаваемых в соответствующий параметр приватности.

Простые значения приватности

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

Пример

Только друзья
1
Некоторые друзья

Чтобы разрешить доступ только определённым друзьям, необходимо указать значение параметра в формате:

users: friendId, friendId, ...
 users: 1, 6492
Некоторые списки друзей

Чтобы разрешить доступ только определённым спискам друзей, необходимо указать значение параметра в формате:

lists: listId, flistId, ...
 lists: 1, 2

Списки друзей можно получить используя метод friends.getLists.