notifications.get

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

items array Массив оповещений для текущего пользователя.

profiles array Информация о пользователях, которые находятся в списке оповещений.

groups array Информация о сообществах, которые находятся в списке оповещений.

last_viewed integer Время последнего просмотра пользователем раздела оповещений в формате unixtime.

Описание поля items

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

type string Тип оповещения. Подробнее см. ниже.

date integer Время появления ответа в формате unixtime.

parent object (отсутствует, если type=follow, mention или wall) Информация о материале, к которому появился ответ (запись на стене, комментарий, фотографию, видеозапись или обсуждение). Подробнее см. в описании поля type ниже.

feedback object, array Объект (или массив объектов, если type равно follow, like_* или copy_*), описывающий поступивший ответ. Оповещения о новых подписчиках, пометках «Мне нравится» и скопированных записях могут быть сгруппированы в виде массива.

reply object Объект, описывающий комментарий текущего пользователя, отправленный в ответ на данное оповещение. Отсутствует, если пользователь ещё не давал ответа.

Описание поля type

Поле type описывает тип оповещения. От данного типа зависит наличие и содержание полей parent и feedback. В данный момент поддерживаются следующие типы оповещений:

Описание поля parent (post)

Содержит информацию о записи на стене:

• •
  id — идентификатор записи;
• •
  to_id — идентификатор владельца записи;
• •
  from_id — идентификатор пользователя, создавшего запись;
• •
  date — время публикации записи в формате unixtime;
• •
  text — текст записи;
• •
  attachments — содержит массив объектов, которые присоединены к текущей записи (фотографии, ссылки и т.п.). Более подробная информация представлена на странице Описание поля attachments.
• •
  geo — находится в записях со стен, в которых имеется информация о местоположении, содержит поляgeo — находится в записях со стен, в которых имеется информация о местоположении, содержит пол:

  • •
    place_id — идентификатор места;
  • •
    title — название места;
  • •
    type — тип места;
  • •
    country_id — идентификатор страны;
  • •
    city_id — идентификатор города;
  • •
    address — строка с указанием адреса места в городе;
  • •
    showmap — данный параметр указывается, если местоположение является прикреплённой картой.
• •
  copy_owner_id — если запись является копией записи с чужой стены, то в поле содержится идентификатор владельца стены у которого была скопирована запись;
• •
  copy_post_id — если запись является копией записи с чужой стены, то в поле содержится идентификатор скопированной записи на стене ее владельца.

Описание поля parent (comment)

Содержит информацию о комментарии:

• •
  id — идентификатор комментария;
• •
  owner_id — идентификатор автора комментария;
• •
  date — время публикации комментария в формате unixtime;
• •
  text — текст комментария;
• •
  post — запись, к которой оставлен комментарий (для типов reply_comment и like_comment);
• •
  photo — фотография, к которой оставлен комментарий (для типов reply_comment_photo и like_comment_photo);
• •
  video — видеозапись, к которой оставлен комментарий (для типов reply_comment_video и like_comment_video);
• •
  topic — обсуждение, в котором оставлен комментарий (для типа like_comment_topic).

Описание поля parent (photo)

Содержит информацию о фотографии:

• •
  id — идентификатор фотографии;
• •
  owner_id — идентификатор владельца фотографии;
• •
  aid — идентификатор альбома фотографии;
• •
  src — ссылка на изображение в разрешении 130 пикселей по большей стороне;
• •
  src_big — ccылка на изображение в разрешении 604 пикселя по большей стороне;
• •
  src_small — ссылка на изображение в разрешении 75 пикселей по большей стороне;
• •
  text — текст описания фотографии;
• •
  created — дата загрузки фотографии в формате unixtime.

Описание поля parent (video)

Содержит информацию о видеозаписи:

• •
  id — идентификатор видеозаписи;
• •
  owner_id — идентификатор владельца видеозаписи;
• •
  title — название видеозаписи;
• •
  description — описание видеозаписи;
• •
  duration — продолжительность видеозаписи в секундах;
• •
  link — ссылка на видео;
• •
  image — ссылка на изображение в разрешении 320 пикселей в ширину;
• •
  image_medium — ссылка на изображение в разрешении 160 пикселей в ширину;
• •
  date — дата добавления видеозаписи в формате unixtime;
• •
  views — количество просмотров;
• •
  player — ссылка на встраиваемый i_frame-видеоплеер.

Описание поля parent (topic)

Содержит информацию о теме в обсуждениях сообщества:

• •
  id — идентификатор темы;
• •
  owner_id — идентификатор сообщества, содержащего тему в обсуждениях (со знаком «минус»);
• •
  title — заголовок темы;
• •
  created — дата создания темы в формате unixtime;
• •
  created_by — идентификатор пользователя, создавшего тему;
• •
  updated — дата последнего сообщения в формате unixtime;
• •
  updated_by — идентификатор пользователя, оставившего последнее сообщение;
• •
  is_closed — 1, если тема является закрытой (в ней нельзя оставлять сообщения);
• •
  is_fixed — 1, если тема является прилепленной (находится в начале списка тем);
• •
  comments — число сообщений в теме.

Описание поля feedback

Cодержит информацию об оповещении:

• •
  id (отсутствует, если type равно follow или like_*) — идентификатор записи-ответа;
• •
  to_id — идентификатор владельца стены, на которой размещена запись;
• •
  from_id — идентификатор автора ответа;
• •
  text (отсутствует, если type равно follow, like_* или copy_*) — текст ответа;
• •
  likes — находится в записях со стен и содержит информацию о числе людей, которым понравилась данная запись, содержит поля:
• •
  count — число пользователей, которым понравилась запись,
• •
  user_likes — наличие отметки «Мне нравится» от текущего пользователя (1 — есть, 0 — нет),
• •
  can_like — информация о том, может ли текущий пользователь поставить отметку «Мне нравится» (1 — может, 0 — не может),
• •
  can_publish — информация о том, может ли текущий пользователь сделать репост записи (1 — может, 0 — не может);

В случае, если ответ является записью на стене (тип post в таблице выше), в объекте feedback также содержатся следующие поля:

• •
  attachments — содержит массив объектов, которые присоединены к текущей записи (фотографии, ссылки и т.п.). Более подробная информация представлена на странице Описание поля attachments.
• •
  geo — находится в записях со стен, в которых имеется информация о местоположении, содержит поля:

  • •
    place_id — идентификатор места;
  • •
    title — название места;
  • •
    type — тип места;
  • •
    country_id — идентификатор страны;
  • •
    city_id — идентификатор города;
  • •
    address — строка с указанием адреса места в городе;
  • •
    showmap — данный параметр указывается, если местоположение является прикреплённой картой.

Описание поля reply

Cодержит информацию об ответе пользователя на оповещение:

• •
  id — идентификатор комментария;
• •
  date — время публикации комментария в формате unixtime;
• •
  text — текст комментария.

Описание поля profiles

Поле profiles содержит массив объектов user с информацией о данных пользователей, которые присутствуют в новостях. Каждый из объектов содержит следующие поля:

• •
  uid — идентификатор пользователя;
• •
  first_name — имя пользователя;
• •
  last_name — фамилия пользователя;
• •
  photo — адрес фотографии пользователя размером 50x50px;
• •
  photo_medium_rec — адрес фотографии пользователя размером 100x100px;
• •
  screen_name — короткий адрес страницы пользователя (например, andrew или id6492).