newsfeed.getComments
Возвращает данные, необходимые для показа раздела комментариев в новостях пользователя.
Этот метод можно вызвать с ключом доступа пользователя, полученным в Standalone-приложении через Implicit Flow.
Требуются права доступа: wall.
Параметры
string
Значение, полученное в поле new_from
при последней загрузке новостей. Помогает избавляться от дубликатов при реализации автоподгрузки.
string
Указывает, какое максимальное число новостей следует возвращать, но не более 100
. По умолчанию 30
. Для автоподгрузки вы можете использовать возвращаемый данным методом параметр new_offset
.
string
Перечисленные через запятую типы объектов, изменения комментариев к которым нужно вернуть. В данный момент поддерживаются следующие списки новостей:
- •
post
— новые комментарии к записям со стен; - •
photo
— новые комментарии к фотографиям; - •
video
— новые комментарии к видеозаписям; - •
topic
— новые сообщения в обсуждениях; - •
market
— новые комментарии к товарам; - •
note
— новые комментарии к заметкам.
Если параметр не задан, то будут получены все возможные списки новостей.
string
Идентификатор объекта, комментарии к репостам которого необходимо вернуть, например wall1_45486
. Если указан данный параметр, параметр filters
указывать необязательно.
string
Время в формате unixtime
, начиная с которого следует получить новости для текущего пользователя. Если параметр не задан, то он считается равным значению времени, которое было сутки назад.
string
Время в формате unixtime
, до которого следует получить новости для текущего пользователя. Если параметр не задан, то он считается равным текущему времени.
string
1
— возвращать последние комментарии к записям. 0
— не возвращать последние комментарии.
string
Количество комментариев к записям, которые нужно получить.
string
Идентификатор, необходимый для получения следующей страницы результатов. Значение, необходимое для передачи в этом параметре, возвращается в поле ответа next_from
.
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
— содержит текстовое поле, которое необходимо передать при подгрузке следующего блока обсуждений.
Описание поля items
Поле items
содержит массив объектов, каждый из которых соответствует одной новости в ленте. Каждый из объектов содержит поля:
- •
type
— тип списка новости, соответствующий одному из значений параметраfilters
; - •
source_id
— идентификатор источника новости (положительный — новость пользователя, отрицательный — новость сообщества) - •
date
— время публикации новости в форматеunixtime
; - •
post_id
— находится в записях со стен и содержит идентификатор записи на стене владельца; - •
copy_owner_id
— находится в записях со стен, если сообщение является копией сообщения с чужой стены, и содержит идентификатор владельца стены, у которого было скопировано сообщение; - •
copy_post_id
— находится в записях со стен, если сообщение является копией сообщения с чужой стены, и содержит идентификатор скопированного сообщения на стене его владельца; - •
text
— находится в записях со стен и содержит текст записи. - •
comments
— находится в записях со стен и содержит информацию о комментариях к записи, содержит поля:- •
count
— количество комментариев, - •
can_post
— информация о том, может ли текущий пользователь комментировать запись (1
— может,0
— не может);
- •
- •
likes
— находится в записях со стен и содержит информацию о числе людей, которым понравилась данная запись, содержит поля:- •
count
— число пользователей, которым понравилась запись, - •
user_likes
— наличие отметки «Мне нравится» от текущего пользователя (1
— есть,0
— нет), - •
can_like
— информация о том, может ли текущий пользователь поставить отметку «Мне нравится» (1
— может,0
— не может), - •
can_publish
— информация о том, может ли текущий пользователь сделать репост записи (1
— может,0
— не может);
- •
- •
attachment
— находится в записях со стен и содержит объект, который присоединен к текущей новости (фотография, ссылка и т.п.). Более подробная информация представлена на странице Описание поляattachment
. - •
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, 130, 604, 807, 1280, 2560 px)
Каждый из элементов массива в поле notes
содержит поля:
- •
id
— идентификатор заметки; - •
owner_id
— идентификатор владельца заметки; - •
title
— заголовок заметки; - •
ncom
— количество комментариев к заметке.
Каждый из элементов массива в поле friends
содержит единственное поле
- •
uid
— идентификатор пользователя.
Описание поля profiles
Поле profiles
содержит массив объектов с информацией о данных пользователей, которые присутствуют в новостях.
Каждый из объектов содержит поля:
- •
id
— идентификатор пользователя; - •
first_name
— имя пользователя; - •
last_name
— фамилия пользователя; - •
photo
— адрес фотографии пользователя размером 50x50px.
Описание поля groups
Поле groups
содержит массив объектов с информацией о сообществах, которые присутствуют в новостях. Каждый из объектов содержит поля:
- •
id
— идентификатор сообщества; - •
name
— название сообщества; - •
photo
— адрес логотипа группы шириной 50px.
Коды ошибок
В ходе выполнения могут произойти общие ошибки.