newsfeed.getRecommended
Получает список новостей, рекомендованных пользователю.
Этот метод можно вызвать с ключом доступа пользователя.
Требуются права доступа: wallfriends.
Параметры
string
Время в формате unixtime
, начиная с которого следует получить новости для текущего пользователя. Если параметр не задан, то он считается равным значению времени, которое было сутки назад.
string
Время в формате unixtime
, до которого следует получить новости для текущего пользователя. Если параметр не задан, то он считается равным текущему времени.
string
Максимальное количество фотографий, информацию о которых необходимо вернуть. По умолчанию 5.
string
Значение, полученное в поле new_from
при последней загрузке новостей. Помогает избавляться от дубликатов при реализации автоподгрузки.
string
Указывает, начиная с какого элемента в данном промежутке времени необходимо получить новости. По умолчанию 0. Для автоподгрузки Вы можете использовать возвращаемый данным методом параметр new_offset
.
string
Идентификатор, необходимый для получения следующей страницы результатов. Значение, необходимое для передачи в этом параметре, возвращается в поле ответа next_from
.
string
Указывает, какое максимальное число новостей следует возвращать, но не более 100. По умолчанию 50.
string
Список дополнительных полей профилей, которые необходимо вернуть. См. подробное описание. Доступные значения:
- •
sex
- •
bdate
- •
city
- •
country
- •
photo_50
- •
photo_100
- •
photo_200_orig
- •
photo_200
- •
photo_400_orig
- •
photo_max
- •
photo_max_orig
- •
online
- •
online_mobile
- •
domain
- •
has_mobile
- •
contacts
- •
connections
- •
site
- •
education
- •
universities
- •
schools
- •
can_post
- •
can_see_all_posts
- •
can_see_audio
- •
can_write_private_message
- •
status
- •
last_seen
- •
common_count
- •
relation
- •
relatives
- •
counters
- •
screen_name
- •
maiden_name
- •
timezone
- •
occupation
- •
activities
- •
interests
- •
music
- •
movies
- •
tv
- •
books
- •
games
- •
about
- •
quotes
Результат
После успешного выполнения возвращает объект, содержащий следующие поля:
- •
items
— массив новостей для текущего пользователя; - •
profiles
— информация о пользователях, которые находятся в списке новостей; - •
groups
— информация о группах, которые находятся в списке новостей; - •
next_from
— содержит значениие, которое необходимо передать в параметрstart_from
, для того, чтобы получить следующую часть новостей;
Описание поля items
Поле items
содержит массив объектов, каждый из которых соответствует одной новости в ленте. Каждый из объектов содержит поля:
- •
type
— тип списка новости, соответствующий одному из значений параметраfilters
; - •
source_id
— идентификатор источника новости (положительный — новость пользователя, отрицательный — новость группы); - •
date
— время публикации новости в форматеunixtime
; - •
post_id
— находится в записях со стен и содержит идентификатор записи на стене владельца; - •
copy_owner_id
— находится в записях со стен, если сообщение является копией сообщения с чужой стены, и содержит идентификатор владельца стены, у которого было скопировано сообщение; - •
copy_post_id
— находится в записях со стен, если сообщение является копией сообщения с чужой стены, и содержит идентификатор скопированного сообщения на стене его владельца; - •
copy_post_date
— находится в записях со стен, если сообщение является копией сообщения с чужой стены, и содержит дату скопированного сообщения; - •
text
— находится в записях со стен и содержит текст записи; - •
comments
— находится в записях со стен и содержит информацию о комментариях к записи, содержит поля:- •
count
— количество комментариев, - •
can_post
— информация о том, может ли текущий пользователь комментировать запись (1
— может,0
— не может);
- •
- •
likes
— находится в записях со стен и содержит информацию о числе людей, которым понравилась данная запись, содержит поля:- •
count
— число пользователей, которым понравилась запись, - •
user_likes
— наличие отметки «Мне нравится» от текущего пользователя (1
— есть,0
— нет), - •
can_like
— информация о том, может ли текущий пользователь поставить отметку«Мне нравится»
(1
— может,0
— не может), - •
can_publish
— информация о том, может ли текущий пользователь сделать репост записи (1
— может,0
— не может);
- •
- •
reposts
— находится в записях со стен и содержит информацию о числе людей, которые скопировали данную запись на свою страницу, содержит поля:- •
count
— число пользователей, сделавших репост; - •
user_reposted
— наличие репоста от текущего пользователя (0
— нет,1
— есть);
- •
- •
attachments
— находится в записях со стен и содержит массив объектов, которые прикреплены к текущей новости (фотография, ссылка и т.п.). Более подробная информация представлена на странице Описание поляattachments
. - •
geo
— находится в записях со стен, в которых имеется информация о местоположении, содержит поля:- •
place_id
— идентификатор места; - •
title
— название места; - •
type
— тип места; - •
country_id
— идентификатор страны; - •
city_id
— идентификатор города; - •
address
— строка с указанием адреса места в городе; - •
showmap
— данный параметр указывается, если местоположение является прикреплённой картой.
- •
- •
photos
,photo_tags
,notes
,friends
— находятся в объектах соответствующих типов (кроме записей со стен) и содержат информацию о количестве объектов и до 5 последних объектов, связанных с данной новостью.
Каждый из элементов массива в полях photos
и photo_tags
содержит поля:
- •
id
— идентификатор фотографии - •
owner_id
— идентификатор владельца фотографии - •
album_id
— идентификатор альбома - •
photo_75
- адрес изображения размером 75 пикселей - •
photo_130
- адрес изображения размером 130 пикселей - •
photo_604
- адрес изображения размером 604 пикселей - •
photo_807
- адрес изображения размером 807 пикселей - •
photo_1280
- адрес изображения размером 1280 пикселей
Каждый из элементов массива в поле notes
содержит поля:
- •
id
— идентификатор заметки - •
owner_id
— идентификатор владельца заметки - •
title
— заголовок заметки - •
comments
— количество комментариев к заметке
Каждый из элементов массива в поле friends
содержит поля:
- •
uid
— идентификатор пользователя
Описание поля profiles
Поле profiles
содержит массив объектов user
с информацией о данных пользователей, которые присутствуют в новостях. Каждый из объектов содержит следующие поля:
- •
id
— идентификатор пользователя; - •
first_name
— имя пользователя; - •
last_name
— фамилия пользователя; - •
photo
— адрес фотографии пользователя размером 50x50px; - •
photo_medium_rec
— адрес фотографии пользователя размером 100x100px; - •
screen_name
— короткий адрес страницы пользователя (например, andrew или id6492).
Описание поля groups
Поле groups
содержит массив объектов group
с информацией о сообществах, которые присутствуют в новостях. Каждый из объектов содержит следующие поля:
- •
id
— идентификатор сообщества; - •
name
— название сообщества; - •
is_closed
— флаг, определяющий является ли группа закрытой; - •
photo
— адрес логотипа группы шириной 50px; - •
photo_medium
— адрес логотипа группы шириной 100px; - •
photo_big
— адрес логотипа группы шириной 200px; - •
screen_name
— короткий адрес страницы сообщества (например, apiclub или club1).
Примечание
Вы можете получить полный список фотографий, полученных с типом photo
или photo_tag
методом photos.get, указав параметры feed
(дата события в поле date
) и feed_type
(тип события, photo
или photo_tag
) и uid
— идентификатор пользователя, с которым произошло событие (поле source_id
).
Коды ошибок
В ходе выполнения могут произойти общие ошибки.