https vk com dev messages gethistory

На чтение 4 мин. Опубликовано

Обратите внимание, текст обрезается по словам, точное число символов может не совпадать с указанным значением.

last_message_id идентификатор сообщения, полученного перед тем, которое нужно вернуть последним (при условии, что после него было получено не более count сообщений, иначе необходимо использовать с параметром offset).

Метод wall.getComments возвращает новые поля: comment_ >(integer) , current_level_count (integer) .
Метод wall.createComment возвращает новое поле parents_stack (array) .
Добавлен метод wall.getComment.

В объекте комментария к записи на стене возвращаются новые поля parents_stack (array) , thread (object) . Может возвращаться поле deleted (boolean) , говорящее о том, что комментарий был удалён.

В объекте сообщения разделены ответы и пересланные сообщения (reply_message и fwd_messages).

В объектах записи на стене, видеозаписи, товара может возвращаться поле is_favorite (boolean) .

Метод secure.sendSMSNotification отправляет несколько сообщений. Изменился формат ответа.

Метод с docs.search с параметром search_own перестает возвращать массив local. Вместо этого в items сначала возвращаются документы пользователя, а потом документы из глобального поиска.

В поле action объекта сообщения может возвращаться значение chat_invite_user_by_link.

В объекте сообщения добавлено поле update_time.

Методы wall.post, wall.editAdsStealth, wall.edit, wall.repost могут возвращать новую ошибку 224 — превышен лимит рекламных записей.

В Callback API добавлено новое событие — message_edit.

Для групповой беседы:
2000000000 + id беседы. (недоступно для вызовов от имени сообщества)

start_message_id если значение > 0, то это идентификатор сообщения, начиная с которого нужно вернуть историю переписки, если передано значение 0 то вернутся сообщения с самого начала переписки, если же передано значение -1, то к значению параметра offset прибавляется количество входящих непрочитанных сообщений в конце диалога (подробности см. ниже) rev 1 – возвращать сообщения в хронологическом порядке. 0 – возвращать сообщения в обратном хронологическом порядке (по умолчанию). extended Если указать в качестве этого параметра 1, то будет возвращена информация о пользователях, являющихся авторами сообщений. По умолчанию 0. fields список дополнительных полей профилей, которые необходимо вернуть. См. подробное описание. group_id идентификатор сообщества (для сообщений сообщества с ключом доступа пользователя).

Параметр start_message_ > 0 позволяет получить интервал истории сообщений вокруг данного сообщения или вокруг начала отрезка непрочитанных входящих сообщений.

Для start_message_id >= 0 и к значению параметра offset прибавляется количество сообщений, чей идентификатор строго больше данного start_message_id (при offset равном 0 вернутся сообщения начиная с данного включительно и более старые, count штук).

После успешного выполнения возвращает список объектов сообщений.

В случае наличия в этом диалоге непрочитанных входящих сообщений, дополнительно (после поля count, перед полем items) в список будет добавлено поле unread с количеством непрочитанных входящих сообщений.

Поля in_read и out_read являются идентификаторами прочтения. in_read возвращает идентификатор последнего прочитанного сообщения текущим пользователем, а out_read возвращает идентификатор последнего прочитанного сообщения собеседником.

При переданном start_message_id в случае, если не было возвращено последнее сообщение в истории переписки (то есть сколько-то сообщений было пропущено), количество пропущенных сообщений (то есть реальное значение offset, которое использовалось для получения интервала истории) будет возвращено в поле skipped (вместе с count, items и иногда unread).

Вконтакте API для .NET (C#)

Возвращает историю сообщений для указанного пользователя.

Страница документации ВКонтакте messages.getHistory.

Содержание
  1. Синтаксис
  2. Параметры
  3. Результат

Синтаксис

Параметры

Класс MessagesGetHistoryParams содержит следующие свойства:

  • Offset — Смещение, необходимое для выборки определенного подмножества сообщений, должен быть >= 0, если не передан параметр start_message_ > 0, то это идентификатор сообщения, начиная с которого нужно вернуть историю переписки, если же передано значение -1, то к значению параметра offset прибавляется количество входящих непрочитанных сообщений в конце диалога (подробности см. ниже) целое число
  • Rev — 1 – возвращать сообщения в хронологическом порядке. 0 – возвращать сообщения в обратном хронологическом порядке (по умолчанию), недоступен при переданном start_message_id. целое число

Результат

После успешного выполнения возвращает список объектов сообщений. В случае наличия в этом диалоге непрочитанных входящих сообщений, дополнительно (после поля count, перед полем items) в список будет добавлено поле unread с количеством непрочитанных входящих сообщений. Поля in_read и out_read являются идентификаторами прочтения. in_read возвращает идентификатор последнего прочитанного сообщения текущим пользователем, а out_read возвращает идентификатор последнего прочитанного сообщения собеседником. При переданном start_message_id в случае, если не было возвращено последнее сообщение в истории переписки (то есть сколько-то сообщений было пропущено), количество пропущенных сообщений (то есть реальное значение offset, которое использовалось для получения интервала истории) будет возвращено в поле skipped (вместе с count, items и иногда unread).

Оцените статью