photos.getComments

Возвращает список комментариев к фотографии.

Этот метод можно вызвать с ключом доступа пользователя.

Параметры

owner_id

string

Идентификатор пользователя или сообщества, которому принадлежит фотография.

Обратите внимание, идентификатор сообщества в параметре owner_id необходимо указывать со знаком «-» — например, owner_id=-1 соответствует идентификатору сообщества ВКонтакте API (club1).

photo_id

string

Идентификатор фотографии.

need_likes

string

1 — будет возвращено дополнительное поле likes. По умолчанию: 0.

start_comment_id

string

Идентификатор комментария, начиная с которого нужно вернуть список (подробности см. ниже).

offset

string

Смещение, необходимое для выборки определенного подмножества комментариев. По умолчанию: 0.

count

string

Количество комментариев, которое необходимо получить.

skip_before_id

string

Идентификатор последнего полученного комментания, при подгрузке более новых комментариев. (этот и более старые комментарии получены не будут)

skip_after_id

string

Идентификатор последнего полученного комментания, при подгрузке более старых комментариев. (этот и более новые комментарии получены не будут)

sort

string

Порядок сортировки комментариев. Возможные значения:

•
asc — от старых к новым;
•
desc — от новых к старым.

access_key

string

Ключ доступа к фотографии.

extended

string

1 — в ответе будут возвращены дополнительные поля profiles и groups, содержащие информацию о пользователях и сообществах. По умолчанию: 0.

fields

string

Список дополнительных полей профилей, которые необходимо вернуть. См. подробное описание. Доступные значения:

•
about,
•
activities,
•
bdate,
•
blacklisted,
•
blacklisted_by_me,
•
books,
•
can_post,
•
can_see_all_posts,
•
can_see_audio,
•
can_send_friend_request,
•
can_write_private_message,
•
career,
•
city,
•
common_count,
•
connections,
•
contacts,
•
country,
•
crop_photo,
•
domain,
•
education,
•
exports,
•
followers_count,
•
friend_status,
•
games,
•
has_mobile,
•
has_photo,
•
home_town,
•
interests,
•
is_favorite,
•
is_friend,
•
is_hidden_from_feed,
•
last_seen,
•
lists,
•
maiden_name,
•
military,
•
movies,
•
music,
•
nickname,
•
occupation,
•
online,
•
personal,
•
photo_100,
•
photo_200,
•
photo_200_orig,
•
photo_400_orig,
•
photo_50,
•
photo_id,
•
photo_max,
•
photo_max_orig,
•
quotes,
•
relation,
•
relatives,
•
schools,
•
screen_name,
•
sex,
•
site,
•
status,
•
timezone,
•
tv,
•
universities,
•
verified,
•
wall_comments.

Если был передан параметр start_comment_id, будет найдена позиция комментария в списке (или ближайший к нему более ранний). Начиная с этой позиции будет возвращено count комментариев. Смещение offset в этом случае будет отсчитываться от этой позиции (оно может быть отрицательным).

Результат

После успешного выполнения возвращает объект, содержащий число результатов в поле count и массив объектов комментариев в поле items.

Если был задан параметр extended=1, возвращает число результатов в поле count, отдельно массив объектов комментариев в поле items, пользователей в поле profiles и сообществ в поле groups.

Если был задан параметр need_like=1, у объектов комментариев возвращается дополнительное поле likes:

•
count — число пользователей, которым понравился комментарий;
•
user_likes — наличие отметки «Мне нравится» от текущего пользователя (1 — есть, 0 — нет)(1 — есть, 0 — нет)`;
•
can_like — информация о том, может ли текущий пользователь поставить отметку «Мне нравится» (1 — может, 0 — не может).

Если был передан параметр start_comment_id, будет также возвращено поле real_offset – итоговое смещение данного подмножества комментариев (оно может быть отрицательным, если был указан отрицательный offset).

Коды ошибок

В ходе выполнения могут произойти общие ошибки.