В методах market.add, market.edit добавлено поле sku — артикул товара; В методах market.getOrderItems, market.getOrderById и market.get, в объект item, добалено поле sku, обозначающее артикул товара; В методе market.getOrderItems добавлен новый опциональный параметр user_id. При этом метод сохраняет предыдущую логику поведения при отсутствии указания user_id.
В методе market.editOrder добавлены поля, которые может изменять администратор сообщества: delivery_price — стоимость доставки; track_number — трек-номер; payment_status — статус оплаты.
Так же появились новые поля для редактирования габаритов и веса заказа: width — ширина; length — длина; height — высота; weight — вес.
Также поле merchant_comment теперь сохраняет комментарий продавца.
В объекте товара, в объекте цены возвращается old_amount_text с текстовым представлением старой цены.
Появились методы для работы с VK Donut: donut.isDon donut.getFriends donut.getSubscription donut.getSubscriptions
В объекте записи появилась информация о VK Donut. В объекте комментария появилась информация о VK Donut.
В методе groups.get в объекте 'market' приходит поле type (string), которое может иметь значения basic и advanced в зависимости от типа магазина. Поле приходит, если в группе включен раздел "Товары".
В объекте товара поля date и views_count теперь возвращаются только администратору группы, которой принадлежит товар.
В объекте заказа информация о доставке и заказчике вынесена из основного объекта в новые подобъекты: delivery и recepient.
В объекте товара появился объект dimensions – габариты и вес товара. Возвращаются, если они были указаны при редактировании или сохранении товара.
stories.save: изменен процесс загрузки историй. Начиная с этой версии, у методов stories.getPhotoUploadServer и stories.getVideoUploadServer в ответе upload-сервера будет только один параметр upload_result (string). Для сохранения загруженных историй нужно дополнительно вызвать stories.save, передав туда полученный ранее upload_result.
В stories.getViewers изменился ответ: в items теперь возвращается массив объектов. В объекте есть следующие поля: is_liked (bool) и user_id (int).
В пересланных сообщениях и ответах теперь возвращается payload.
В методах stories.get, stories.getReplies, stories.search возвращается новый формат ленты историй. Вместо массива массивов историй, теперь — массив объектов блока ленты историй.
В объекте сообщения появилось поле template.
Формат ответа storage.get для одного ключа key изменился, теперь возвращается объект того же типа, что и при передаче keys.
В объекте market, который возвращает groups.getSettings, появилось поле can_message integer1,0, определяющее, что у сообщества включены сообщения.
Клавиатуры бесед больше не приходят в объекте сообщения. В объекте сообщения в поле keyboard стали приходить inline-клавиатуры.
В объекте товара возвращается новое поле old_amount (string) внутри объекта price — содержит старую стоимость товара.
ads.getStatistics - из ответа убрано поле goals, вместо него возвращается поле lead_form_sends.
apps.getActivity - для типа achievement появляется новый объект media, содержащий по ключу images картинки для данной ачивки. Если картинок нет, то поле media будет отсутствовать.
apps.get и объект приложения добавлены 2 новых поля: mobile_controls_type и mobile_view_support_type, которые описывают, как отображаются элементы управления для игр в вебвью в нативных клиентах.
mobile_controls_type = 0 — чёрная полоска над областью с игрой; mobile_controls_type = 1 — прозрачный элемент управления поверх области с игрой; mobile_controls_type = 2 — только для vk apps, без контроллов.
mobile_view_support_type = 0 — игра не использует нижнюю часть экрана на iPhoneX, черная полоса есть. mobile_view_support_type = 1 — игра использует нижнюю часть экрана на iPhoneX, черной полосы нет.
В объекте groups поле app_buttons не возвращается, если в группе включено меню.
Новый формат прикрепления photos_list.
Для метода ads.getPostsReach изменилось поведение при ошибках, они будут возвращаться для каждого объявления отдельно. Метод ads.getAdsPostsReach отключён, вместо него следует использовать ads.getPostsReach.
Поддержка новых типов клавиш в клавиатуре ботов.
В Callback API и LongPoll API у события message_new вместо { object: message } будет приходить { object: { message, client_info } }. В client_info содержится информация о клиенте полезная для формирования сообщений ботами.
В методах секции messages доступен аттач-история.
Сообщения, которые не влезают в Bots Long Poll API или Callback API будут обрезаны и иметь пометку is_cropped. В случае обрезания остается одно пересланное сообщение или ответ и только одно вложение на каждое сообщение.
Для методов ads.createTargetGroup и ads.updateTargetGroup параметр lifetime станет обязательным. Параметр будет принимать значения от 1 до 720.
Истории в stories.get в рамках одного автора приходят в хронологическом порядке. Раньше приходили в обратном.
Добавлен параметр clickable_stickers в методы stories.getPhotoUploadServer и stories.getVideoUploadServer
Методы работы со стеной возвращают новый аттач-сниппет для событий с типом events
Обложки в объекте видео теперь передаются в полях image и first_frame в виде массивов объектов video_image.
Обложки в объекте альбома видео теперь передается в поле image в виде массива объектов video_image.
Параметры limit, count и offset в методе messages.deleteConversation объявлены устаревшими.
Метод wall.edit в случае успеха возвращает post_id — идентификатор отредактированного поста.
В методах wall.getComments, market.getComments, , video.getComments, board.getComments граффити вынесен в отдельный тип attach.
Методы market.add, market.edit принимают параметр url. Объект market теперь может возвращать url и button_title.
Метод wall.createComment возвращает новую ошибку 222
Метод wall.getComments возвращает новые поля: comment_id (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).
Метод account.getBanned возвращает поля profiles (array) и groups (array) с данными пользователей и сообществ.
Новый формат ответа метода docs.save.
Параметр random_id в методе messages.send обязателен.
В объекте пользователя добавлены новые обязательные поля:
Метод messages.removeChatUser возвращает ошибку "935: User not found in chat", если пользователя нет в чате.
В объекте сообщества у поля wall поменялись значения. Для пабликов возвращаются значения:
Метод messages.search при использовании параметра extended = 1 возвращает массив объектов бесед.
Изменения в методе stats.get:
В объекте приложения в поле type приходят новые значения.
В объекте приложения больше не приходит поле is_html5_app.
Метод messages.getConversationMembers возвращает новую ошибку 917.
Изменения в API опросов:
В методе groups.getLongPollServer изменился тип поля ts — теперь это string, а не integer.
Метод messages.getChatPreview теперь возвращает максимум 5 участников из чата. Метод messages.getConversationMembers возвращает поле can_kick (boolean) для участников беседы.
В объекте записи на стене для комментариев могут вернуться поля can_close (boolean) и can_open (boolean).
В объекте беседы возвращается новое поле is_group_channel (boolean) для каналов сообществ. Метод stories.get возвращает истории в реверсивном порядке.
Метод messages.removeChatUser принимает новый параметр member_id (integer). В Callback API и Bots Longpoll добавлено новое событие — платёж через VK Pay.
Метод messages.deleteConversation в ответе возвращает поле last_deleted_id, содержащее идентификатор последнего удалённого сообщения.
Новый API для сообщений. Изменился объект message, а также появился объект conversation и связанные с ним методы messages.getConversations, messages.getConversationsById, messages.getConversationMembers и messages.searchConversations, messages.getByConversationMessageId.
messages.getDialogs, messages.getChat, messages.getChatUsers, messages.get, messages.searchDialogs объявлены устаревшими и больше обновляться не будут.
messages.markAsRead больше не поддерживает параметр message_ids
И несколько методов переехало. Старые названия будут перенаправлять на новую версию. messages.markAsImportantDialog → messages.markAsImportantConversation, messages.markAsAnsweredDialog → messages.markAsAnsweredConversation, messages.deleteDialog → messages.deleteConversation.
Метод secure.sendSMSNotification отправляет несколько сообщений. Изменился формат ответа.
Метод groups.getSettings возвращает поле events.
Новый формат объекта photo.
Прекращение поддержки ответов в XML формате.
Новый формат ответа в методе stats.get.
В настройках Callback-сервера и Long Poll API появилась возможность указывать версию API. От нее зависит формат получаемых событий.
Новый формат стикеров.
Метод с docs.search с параметром search_own перестает возвращать массив local. Вместо этого в items сначала возвращаются документы пользователя, а потом документы из глобального поиска.
Появилась новая ошибка: ошибка 29: Rate limit reached
В объекте post возвращается поле access_key.
Метод groups.getBanned возвращает информацию о сообществах из чёрного списка.
В поле action объекта сообщения может возвращаться значение chat_invite_user_by_link.
В объекте сообщения добавлено поле update_time.
Методы wall.post, wall.editAdsStealth, wall.edit, wall.repost могут возвращать новую ошибку 224 — превышен лимит рекламных записей.
В Callback API добавлено новое событие — message_edit.
Метод messages.getLongPollHistory возвращает информацию о сообществах в отдельном массиве groups.
Методы newsfeed.search и search.getHints возвращают в ответе поле suggested_queries с подсказками для поиска.
Метод messages.send может вернуть новые ошибки 913 и 921.
Метод friends.getRequests возвращает новое поле count_unread.
Метод search.getHints принимает новый параметр offset.
В объекте пользователя и сообщества может возвращаться дополнительное поле trending («огонёк»).
В поле action объекта сообщения могут возвращаться значения chat_pin_message/chat_unpin_message.
В Callback API добавлены новые события — добавление пользователя в черный список и удаление из него, user_block и user_unblock.
В объекте записи на стене добавлено поле groups_can_post с информацией о том, могут ли сообщества комментировать запись. Метод messages.send возвращает массив статусов отправки при использовании параметра user_ids и вызове с ключом доступа сообщества. Методы groups.getCallbackServerSettings, groups.setCallbackServerSettings и groups.setCallbackServer устарели. В методах groups.setCallbackSettings, groups.getCallbackSettings добавлен параметр server_id.
Метод wall.createComment поддерживает идентификатор группы в параметре from_group.
В объекте chat, если массив users пустой, то он не возвращается.
В методе auth.signup добавлен обязательный параметр birthday.
Методы Аудиозапись, Аудиозапись, Аудиозапись, Аудиозапись, Аудиозапись и Аудиозапись устарели.
В методе auth.restore добавлен обязательный параметр last_name. В методе messages.getLongPollServer добавлен параметр lp_version. Метод ads.getCategories возвращает результат в новом формате. Метод wall.edit больше нельзя использовать для редактирования промопоста, вместо него нужно использовать метод wall.editAdsStealth.
Метод messages.getDialogs возвращает поля unanswered и important для сообщений сообществ.
Метод groups.getCallbackSettings возвращает поле wall_repost, настройка уведомления о репосте.
Метод video.save возвращает ошибку 15, если используется параметр wallpost = 1, и приложение не запрашивало права доступа wall.
В объектах, описывающих запись на стене, добавлено поле views, в котором находится информация о количестве просмотров поста.
Поддержка параметра fields в методах wall.getComments и video.getComments.
Сокращенная ссылка в методе utils.getShortLink возвращается в новом формате с полями:
Метод messages.getHistoryAttachments возвращает поле message_id для вложений. Добавлено новое значение семейного положения (8 — «в гражданском браке») в объекте пользователя.
В объекте сообщества возвращается новое поле cover. Метод account.getCounters принимает в параметре filter новое значение friends_suggestions. В методе pages.get добавлена проверка на наличие прав администратора для использования параметра need_source.
Метод account.getInfo возвращает дополнительное поле 2fa_required для аккаунтов с включенной 2FA. В методе добавлено ограничение на параметр feed (не более месяца с текущей даты).
Для вложений с типом link поле button возвращается с новой структурой: reference/objects/button.
Обновлены требования к размерам изображений в рекламных объявлениях. Подробнее см. на этой странице.
В объектах, описывающих сообщество, добавлено поле is_messages_blocked.
В Callback API добавлены два новых события — message_allow и message_deny. Метод groups.setCallbackSettings принимает два новых параметра, а метод groups.getCallbackSettings возвращает два новых поля, соответственно.
В объекте приложения изменились названия полей и размеры изображений иконок и баннеров.
HTTPS-only. Делать запросы к api.vk.com с этой версии можно только по протоколу https.
В объектах, описывающих сообщество, поле finish_date не возвращается, если дата окончания не задана (ранее возвращалось значение по умолчанию, равное start_date + 2 часа).
В объектах, описывающих сообщество, поля can_message, ban_info, can_post, can_upload_doc, can_upload_video, can_see_all_posts, can_create_topic, is_favorite, is_hidden_from_feed возвращаются только для запросов с передачей access_token.
В методе ads.getAds: возвращаемое поле impressions_limit было разделено на два поля: impressions_limit и impressions_limited, изменено возвращаемое поле ad_platform, убрано возвращаемое поле disclaimer, добавлены поля disclaimer_medical, disclaimer_specialist, disclaimer_supplements. В методах ads.createAds и ads.updateAds: параметр impressions_limit в ad_specification был разделён на два параметра: impressions_limit и impressions_limited, изменён параметр ad_platform из ad_specification, убран параметр disclaimer из ad_specification, добавлены параметры disclaimer_medical, disclaimer_specialist, disclaimer_supplements в ad_specification. В методе ads.createAds: параметр ad_format в ad_specification стал обязательным. В методе ads.getUploadURL: параметр ad_format стал обязательным.
Метод account.setInfo принимает универсальные параметры name и value вместо раздельных параметров.
В методе messages.getHistory можно передавать параметр rev вместе с start_message_id и start_message_id равный 0. Метод friends.edit возвращает ошибку Code: 100, Message: invalid list_ids если указан неправильный list_ids.
Методы messages.send и messages.sendSticker принимают параметр random_id вместо guid. Метод account.getPushSettings возвращает поле peer_id вместо chat_id и user_id. Метод account.setSilenceMode принимает параметр peer_id вместо chat_id и user_id. Метод messages.getHistoryAttachments возвращает товары, записи со стены и комментарии в виде ссылок.
Для медиавложений в сообщениях с типом link возвращаются поля caption, is_external, product, application, rating и button.
Методы docs.get, docs.getById возвращают поле preview вместо полей photo_100, photo_130. Метод messages.searchDialogs возвращает сообщества в результате поиска.
Параметры out, time_offset, filters в методе messages.get могут быть только положительными. Параметр message_ids стал обязательным в методе messages.getById.
Метод gifts.get может вернуть отрицательный from_id. Метод notifications.get возвращает уведомления об упоминаниях в описаниях фотографий.
Метод notifications.get возвращает уведомления о новых ответах к комментариям в товарах. Метод newsfeed.getComments возвращает комментарии к товарам. Методы wall.get, wall.search, wall.getById возвращают market_album в медиа-вложениях.
Добавлена поддержка параметра fields для профилей
Для медиавложений с типом link возвращаются поля caption, is_external, product, application, rating и button.
Методы apps.get и apps.getCatalog возвращают объект для полей screenshots. Добавлены поля in_read, out_read в ответы методов messages.getDialogs и messages.getHistory. Добавлен параметр peer_id для методов messages.send, messages.sendSticker, messages.deleteDialog, messages.setActivity и messages.getHistory.
Для медиавложений с типом link вместо полей image_src и image_big возвращается объект photo.
Добавлены параметры app_ids, return_friends. Добавлены поля installed, ** screenshots**.
Добавлены методы для работы с активностями приложений.
Если доступ к комментариям видео ограничен, при запросе комментариев вернется ошибка.
Добавлен параметр start_comment_id для получения комментариев, начиная с указанного.
В объекте приватности добавлено возможное значение friends_of_friends_only.
Параметр device_id является обязательным. Изменен формат настроек приватности.
Изменен формат приватности.
messages.getLongPollHistory поддерживает поле fields.
Новый формат результата метода friends.delete
Переход на параметры start_from, next_from в методе notifications.get
newsfeed.getSuggestedSources возвращает результат в виде списка
Возвращаются более корректные ошибки в методе apps.sendRequest
Добавлен тип wall_publish, который означает, что предложенный пост пользователя размещен.
При передаче параметра 'photo_sizes' в методе будут возвращены все размеры фотографии.
Изменен параметр метода newsfeed.getComments: теперь можно ограничить количество комментариев к записям.
В метод groups.getMembers добавлена возможность получать возможных участников события.
Убрано ошибочное разделение параметра schools на два, теперь снова используется один параметр schools. Список ID для этого параметра следует получать в методе ads.getSuggestions.
Поле uid в ответе метода video.getTags заменено на user_id.
Вики-страница вложенная в пост теперь приходит в виде объекта вики-страницы. В методе pages.get был добавлен параметр need_source, поле source теперь по умолчанию не возвращается.
В объекте группа поля start_date и finish_date стали числами вместо строк. При установленном фильтре friend для новостей возвращается user_id вместо uid. В методе fave.getLinks изображения возвращаются с именами photo_50 и photo_100 вместо image_src и image_middle.
Заменены возвращаемые переменные: reply_to_uid на reply_to_user, reply_to_cid на reply_to_comment.
Новые типы упоминаний в notifications.get: mention_comment_photo и mention_comment_video.
Параметр schools разделён на два: schools и universities. Теперь id этих объектов такие же, как и в методах database.
В методе newsfeed.search появился параметр extended, при передаче которого возвращаются полные результаты со всеми необходимыми для вывода данными о группах или пользователях. В методе friends.areFriends изменён алгоритм генерации поля sign, в нём теперь есть id пользователя. В методах newsfeed.get и newsfeed.getRecommeded исправлено представление объектов note, теперь возвращается id и comments.
В методе messages.getDialogs появился параметр unread, при передаче которого возвращаются только диалоги с непрочитанными входящими сообщениями, а в результат добавлено количество таких диалогов unread_dialogs (если больше нуля) и в каждом диалоге возвращается количество непрочитанных входящих unread (если больше нуля).
В методе messages.getHistory параметр rev недоступен при передаче start_message_id, поведение start_message_id и его связь с offset изменены, в результат добавлено количество непрочитанных входящих в диалоге unread (если больше нуля) и количество пропущенных сообщений skipped при использовании start_message_id (если оно больше нуля).
Новый параметр для пагинации: start_from, приходящий в виде строки в поле next_from для получения следующей страницы.
Новые типы ошибок в методах audio.get, video.get. Новый параметр для пагинации: start_from, приходящий в виде строки в поле next_from для получения следующей страницы.
В случае успешной смены имени также возвращается поле name_request co значением status равным success.
В методе messages.get для параметра filter разрешены только значения 0 (все входящие или все исходящие сообщения, по полю out) или 8 (важные сообщения), остальные значения игнорируются. Метод messages.markAsNew больше не поддерживается.
Изменение поля cid на id в newsfeed.getComments. в notifications.get объект video в новом формате. friends.getLists список теперь возвращается в виде объекта с полем count, list_id заменен на id. board.getTopics опросы приходят в новом формате. audio.getAlbums и video.getAlbums – id вместо album_id. audio.getRecommendations, friends.getSuggestions – возвращается в форме списка. groups.getMembers – результат в виде списка. places.getCheckins – user_id вместо uid в объектах отметок.
Поля city и country в fields возвращают объект вместо идентификатора.
Новый формат записей: to_id вместо owner_id reply_post_id вместо reply_to в copy_history
Поле post_type возвращает post вместо copy для репостов.
Для группируемых оповещений (пользователи оценили, поделились, подписались, ..) в поле feedback кроме идентификаторов последних пользователей, совершивших действие, возвращается полное количество пользователей, совершивших это действие за последние сутки.
Во всех методах, которые возвращают объекты пользователей в profiles, поля photo, photo_medium_rec у пользователей переименованы в photo_50, photo_100. Во вложении wall в сообщениях поля from и copy_owner возвращают объект пользователя или сообщества, вместо массива.
Поле id вместо pid, новый формат полей edited и created
В объекте feedback: owner_id был заменен на from_id, исправлен баг со строкой в owner_id.
Исправлен тип прикрепления photos_list. (было photo_list). Другие исправления, забытые в версии 5.0 video.getUserVideos - поля photo_160, photo_320 photos.getTags - убраны устаревшие поля uid, tag_id notifications.get - у тем tid заменен на id
Глобальное обновление API, затрагивающее почти все методы. Посмотреть список изменений
Новый формат ответа, объект с полями liked и copied.
Новый формат репостов. Поддержка репостов от репостов.
При прикреплении альбома в тексте записи не будет передаваться ссылка на альбом.
При получении сообщения о смене или удалении фотографии в мультидиалоге больше не приходит пояснение действия в тексте сообщения.
Позволяет транслировать аудиозапись в статус пользователя или любой из администрируемых групп.
Возвращает количество результатов первым элементом ответа
Были удалены поля online и reply_count
Возвращает количество результатов первым элементом ответа
Изменен формат комментариев, все методы теперь возвращают их в единообразной форме
Изменен формат ссылок, прикрепленных к личным сообщениями, теперь они возвращаются как отдельные объекты
Изменено название поля users на items, а uid на item
Возвращает количество результатов первым элементом ответа
Изменено значение возвращаемого поля uid, теперь это отправитель сообщения.
Изменен формат возвращения мест, начиная с этой версии не будут возвращаться поля, оставленные для совместимости
Возвращает подарки отдельным объектом, а не в виде документов
Изменяет вид возвращаемых комментариев, делая их структуру аналогичной комментариям в других методах
Помечает анонимные опросы отдельным полем anonymous, не добавляя информации к заголовкам публичных опросов.
Возвращает количество результатов первым элементом ответа
Возвращает прикрепления в комментариях
Возвращает результат в виде объекта, содержащего профили и группы, необходимые для отображения найденных записей
Поле chat_active возвращается в виде массива, а не строки.
Возвращает количество результатов первым элементом ответа.
offset и count могут быть только положительными