Настройки приватности
Настройки приватности представляют собой массив, который может содержать следующие значения:
- •
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.
privacy_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.
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
.