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

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

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

Пример

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

JSONprivacy_view: ['all', '-list2', -1234],

Версии 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.

JSONprivacy_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.