Изменения в методах API
Добавлено: 10 июл 2010, 16:12
friends.get
friends.get - расширенный метод getFriends.
Теперь при использовании параметра fields, возвращает расширенную информацию о друзьях пользователя, без параметра fields - список идентификаторов друзей текущего пользователя, как раньше возвращал метод getFriends.
Появились новые поля: online, lists, domain.
Поле online
Показывает, находится ли этот пользователь сейчас на сайте.
Возвращаемые значения: 1 - находится, 0 - не находится.
Поле lists
Список, содержащий id списков друзей, в которых состоит текущий друг пользователя. Метод получения id и названий списков: friends.getLists. Поле доступно только при вызове метода, возвращающего список друзей пользователя. Если текущий друг не состоит ни в одном списке, то при приёме данных в формате XML в узле <user> отсутствует тег lists.
Поле domain
Возвращает короткий адрес страницы (возвращается только имя адреса, например vitaliy2). Если пользователь не менял адрес своей страницы, возвращается 'id'+uid, например id35828305.
Склонения имени и фамилии пользователя
Указав параметр name_case, можно получить имя пользователя в нужном падеже.
Возможные значения: именительный – nom, родительный – gen, дательный – dat, винительный – acc, творительный – ins, предложный – abl. По умолчанию nom.
friends.getAppUsers
friends.getAppUsers - вместо метода getAppFriends
friends.getLists
friends.getLists - возвращает id и названия списков друзей текущего пользователя. Например: Дом, Работа.
getProfiles
В методе getProfiles, уже достаточно давно появились поля contacts и education.
Если в параметре fields было указано поле contacts, то будут доступны также поля: home_phone, mobile_phone.
Если в параметре fields было указано поле education, то будут доступны также поля: university, university_name, faculty, faculty_name, graduation.
Поле home_phone
Возвращает домашний телефон пользователя (если он указан и доступен).
Поле mobile_phone
Возвращает мобильный телефон пользователя (если он указан и доступен).
Поле university
Возвращает код университета пользователя.
Поле university_name
Возвращает название университета пользователя.
Поле faculty
Возвращает код факультета пользователя.
Поле faculty_name
Возвращает название факультета пользователя.
Поле graduation
Возвращает год выпуска.
friends.get - расширенный метод getFriends.
Теперь при использовании параметра fields, возвращает расширенную информацию о друзьях пользователя, без параметра fields - список идентификаторов друзей текущего пользователя, как раньше возвращал метод getFriends.
Появились новые поля: online, lists, domain.
Поле online
Показывает, находится ли этот пользователь сейчас на сайте.
Возвращаемые значения: 1 - находится, 0 - не находится.
Поле lists
Список, содержащий id списков друзей, в которых состоит текущий друг пользователя. Метод получения id и названий списков: friends.getLists. Поле доступно только при вызове метода, возвращающего список друзей пользователя. Если текущий друг не состоит ни в одном списке, то при приёме данных в формате XML в узле <user> отсутствует тег lists.
Поле domain
Возвращает короткий адрес страницы (возвращается только имя адреса, например vitaliy2). Если пользователь не менял адрес своей страницы, возвращается 'id'+uid, например id35828305.
Склонения имени и фамилии пользователя
Указав параметр name_case, можно получить имя пользователя в нужном падеже.
Возможные значения: именительный – nom, родительный – gen, дательный – dat, винительный – acc, творительный – ins, предложный – abl. По умолчанию nom.
friends.getAppUsers
friends.getAppUsers - вместо метода getAppFriends
friends.getLists
friends.getLists - возвращает id и названия списков друзей текущего пользователя. Например: Дом, Работа.
getProfiles
В методе getProfiles, уже достаточно давно появились поля contacts и education.
Если в параметре fields было указано поле contacts, то будут доступны также поля: home_phone, mobile_phone.
Если в параметре fields было указано поле education, то будут доступны также поля: university, university_name, faculty, faculty_name, graduation.
Поле home_phone
Возвращает домашний телефон пользователя (если он указан и доступен).
Поле mobile_phone
Возвращает мобильный телефон пользователя (если он указан и доступен).
Поле university
Возвращает код университета пользователя.
Поле university_name
Возвращает название университета пользователя.
Поле faculty
Возвращает код факультета пользователя.
Поле faculty_name
Возвращает название факультета пользователя.
Поле graduation
Возвращает год выпуска.