messages.getHistoryAttachments

Возвращает материалы диалога или беседы.

Этот метод можно вызвать с ключом доступа пользователя, полученным в Standalone-приложении через Implicit Flow.

Требуются права доступа: messages.

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

Требуются права доступа: messages.

Параметры

peer_id

string

Идентификатор назначения.

Для групповой беседы:

•
2000000000+ id беседы.

Для пользователя:

•
id пользователя.

Для сообщества:

•
-id сообщества.

media_type

string

Тип материалов, который необходимо вернуть.

Доступные значения:

•
photo — фотографии;
•
video — видеозаписи;
•
audio — аудиозаписи;
•
doc — документы;
•
link — ссылки;
•
market — товары;
•
wall — записи;
•
share — ссылки, товары и записи.

Обратите внимание — существует ограничение по дате отправки вложений. Так, для получения доступны вложения типов photo, video, audio, doc , отправленные не ранее 25.03.2013, link — не ранее 20.05.13, market,wall — 01.02.2016.

start_from

string

Смещение, необходимое для выборки определенного подмножества объектов. Значение берется из поля next_from, которое возвращается на вызов messages.getHistoryAttachments.

count

string

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

photo_sizes

string

Параметр, указывающий нужно ли возвращать ли доступные размеры фотографии в специальном формате.

fields

string

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

group_id

string

Идентификатор сообщества (для сообщений сообщества с ключом доступа пользователя).

preserve_order

string

Параметр, указывающий нужно ли возвращать вложения в оригинальном порядке.

max_forwards_level

string

Максимальная глубина вложенности пересланных сообщений.

Результат

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

message_id integer Идентификатор сообщения, в котором было отправлено вложение.

attachment object Информация о вложении. Объект, который содержит следующие поля:

•
type (string) — тип вложения. Возможные значения:
- •
  photo — фотография;
- •
  video — видеозапись;
- •
  audio — аудиозапись;
- •
  doc — документ;
- •
  link — ссылка;
- •
  market — товар;
- •
  wall — запись.
•
photo, video, audio, doc, link, market, wall (название поля зависит от значения поля type) — описание вложения. Содержит, соответственно, объект, описывающий фотографию, видеозапись, аудиозапись, документ, ссылку, товар или запись на стене.

Коды ошибок

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