5.199
Изменения во внутренних алгоритмах обработки некоторых запросов.
Изменений в составе API-методов, их параметров и возвращаемых значений нет.
Изменения во внутренних алгоритмах обработки некоторых запросов.
Изменений в составе API-методов, их параметров и возвращаемых значений нет.
video.edit изменён формат ответа.ads.createClients и ads.updateClients добавлен параметр ord_data для сохранения данных клиента по объекту оператора рекламных данных (ОРД).getClients возвращает данные клиента по ОРД в поле ord_data.messages.getChatPreview возвращает поле chat_settings.state со значением out и поле joined со значением false, если пользователь никогда не был участником чата.messages.markAsRead параметр start_cmid переименован в up_to_cmid.database.getSchoolClasses изменён формат ответа.messages.* добавлен тип вложения — сюжет (narrative).is_viewed_by_admin.В методе groups.getById изменён формат ответа. В response возвращаются:
groups с информацией о необходимых сообществах.profiles c описанием пользователей, отметивших сообщество отметкой «Нравится».Также в объект группы добавлено поле like.
Полностью поменялся формат метода market.getCategories. В response возвращается вложенное дерево категорий (вложенность бесконечная). Поля offset и count стали deprecated — дерево возвращается полностью.
В методе market.getById изменился формат поля category: у поля был обязательное поле section, сейчас — поле parent (необязательное), указывающее на родителя. В parent может быть ещё parent, который указывает на его родителя. Вложенность бесконечная. Если родителя нет, то поле parent не возвращается.
wall.getById изменён формат ответа, если параметр extended имеет значение 0: теперь для однородности результат обёрнут в поле items, как в случае запроса с параметром extended, равным 1.messages.send параметр user_ids помечен как deprecated. Используйте вместо него параметр peer_ids.newsfeed.ignoreItem изменился формат ответа. Теперь в response возвращаются поля status (обязательное, boolean) и message (необязательное, string) с сообщением о скрытии блока.icon объекта store_product теперь содержит объект типа stickers_image_set.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 с текстовым представлением старой цены.donut.isDon, donut.getFriends, donut.getSubscription, donut.getSubscriptionsgroups.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 (integer[1,0]), определяющее, что у сообщества включены сообщения.keyboard возвращаются inline-клавиатуры.price теперь возвращается новое поле old_amount (string), которое содержит старую стоимость товара.ads.getStatistics из ответа убрали поле goals, вместо него возвращается поле lead_form_sends.apps.getActivity для типа achievement добавлен новый объект media, содержащий по ключу images картинки для данного достижения. Если картинок нет, то поле media будет отсутствовать.apps.get и объект приложения добавлены 2 новых поля: mobile_controls_type и mobile_view_support_type, которые описывают, как отображаются элементы управления для игр в WebView и в нативных клиентах:
mobile_controls_type = 0, то отображается чёрная полоса над областью с игрой.mobile_controls_type = 1, то отображается прозрачный элемент управления поверх области с игрой.mobile_controls_type = 2, элементы управления не отображаются (только для мини-приложений).mobile_view_support_type = 0, то игра не использует нижнюю часть экрана на iPhoneX, черная полоса есть.mobile_view_support_type = 1, то игра использует нижнюю часть экрана на iPhoneX, черной полосы нет.app_buttons не возвращается, если в группе включено меню.ads.getPostsReach изменилось поведение при ошибках, они будут возвращаться для каждого объявления отдельно.ads.getAdsPostsReach отключён, вместо него следует использовать ads.getPostsReach.message_new вместо { object: message } будет приходить { object: { message, client_info } }.client_info содержится информация о клиенте, полезная для формирования сообщений ботами.messages.* доступен метод для получения материалов диалога или беседы.is_cropped. В случае обрезания остается одно пересланное сообщение или ответ и только одно вложение на каждое сообщение.ads.createTargetGroup и ads.updateTargetGroup параметр lifetime стал обязательным. Параметр принимает значения от 1 до 720.stories.get в рамках одного автора теперь приходят в хронологическом порядке. Раньше приходили в обратном.stories.getPhotoUploadServer и stories.getVideoUploadServer добавлен параметр clickable_stickers.events.image и first_frame в виде массивов объектов video_image.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.createComment возвращает новое поле parents_stack (array).wall.getComment.parents_stack (array), thread (object). Может возвращаться поле deleted (boolean), говорящее о том, что комментарий был удалён.account.getBanned возвращает поля profiles (array) и groups (array) с данными пользователей и сообществ.docs.save.random_id в методе messages.send теперь обязательный.В объекте пользователя добавлены новые обязательные поля:
is_closed (boolean) — включена ли приватность профиля.can_access_closed (boolean) — есть ли у текущего пользователя возможность видеть профиль пользователя при is_closed = true.messages.removeChatUser возвращает ошибку 935: User not found in chat, если пользователя нет в чате.wall поменялись значения. Для сообществ возвращаются значения:
2 – стена ограничена (было 1).3 – стена закрытая (было 0).stats.get:
date_from и date_to устарели, вместо них используются timestamp_from и timestamp_to — целые числа, представляющее собой время в Unixtime.stats_groups, который позволяет фильтровать по отдельным блокам в статистике. Возможные значения: visitors, reach, activity.period_from и period_to являются целыми числами и так же представляют собой время в Unixtime.type приходят новые значения.
app — социальное приложение.game — игра.site — подключенный сайт.standalone — отдельное приложение (для мобильного устройства).vk_app — мини-приложение.community_app — приложение сообщества.html5_game — HTML5 игра.is_html5_app.messages.getConversationMembers возвращает новую ошибку 917.polls.create поддерживает новые параметры для опросов с мультивыбором и фоном.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).messages.deleteConversation в ответе возвращает поле last_deleted_id, содержащее идентификатор последнего удалённого сообщения.message, а также появился объект conversation и связанные с ним методы.messages.getDialogs, messages.getChat, messages.getChatUsers, messages.get, messages.searchDialogs объявлены устаревшими и больше обновляться не будут.
messages.markAsRead больше не поддерживается параметр message_ids.secure.sendSMSNotification теперь отправляет несколько сообщений. Изменился формат ответа.Метод groups.getSettings возвращает поле events.
Добавлен новый формат объекта photo.
stats.get.docs.search с параметром search_own теперь не возвращает массив local. Вместо этого в items сначала возвращаются документы пользователя, а потом документы из глобального поиска.Ошибка 29: Rate limit reachedpost возвращается поле access_key.groups.getBanned возвращает информацию о сообществах из чёрного списка.update_time.wall.post, wall.editAdsStealth, wall.edit, wall.repost могут возвращать новую ошибку 224 — превышен лимит рекламных записей.message_edit.messages.getLongPollHistory возвращает информацию о сообществах в отдельном массиве groups.newsfeed.search и search.getHints возвращают в ответе поле suggested_queries с подсказками для поиска.friends.getRequests возвращает новое поле count_unread.search.getHints принимает новый параметр offset.user_block и user_unblock.groups_can_post с информацией о том, могут ли сообщества комментировать запись.messages.send возвращает массив статусов отправки при использовании параметра user_ids и вызове с ключом доступа сообщества.groups.getCallbackServerSettings, groups.setCallbackServerSettings и groups.setCallbackServer устарели.В метод wall.createComment добавлен новый параметр from_group. Он позволяет указать идентификатор сообщества, от лица которого будет опубликован комментарий.
Метод messages.getChat не добавляет в возвращаемые объекты chat поле users, если оно пустое.
В метод auth.signup добавлен обязательный параметр birthday.
В метод auth.restore добавлен обязательный параметр last_name.
В метод messages.getLongPollServer добавлен параметр lp_version.
Метод ads.getCategories возвращает результат в новом формате.
Метод wall.edit больше нельзя использовать для редактирования рекламной записи, вместо него нужно использовать метод wall.editAdsStealth.
Методы audio.getAlbums, audio.addAlbum, audio.editAlbum, audio.deleteAlbum и audio.moveToAlbum устарели.
В ответ метода messages.getDialogs добавлены поля unanswered и important. Они используются в объектах, описывающих сообщения сообществ.
В ответ метода groups.getCallbackSettings добавлено поле wall_repost, которое содержит информацию о настройках уведомления о репосте.
Метод video.save возвращает ошибку 15, если в вызове указан параметр wallpost = 1, и приложение не запрашивало права доступа wall.
В объекты, описывающие запись на стене, добавлено поле views, которое содержит количество просмотров записи.
В методы wall.getComments и video.getComments добавлен параметр fields.
Метод utils.getShortLink возвращает новый тип объекта, описывающего ссылку. Этот объект содержит следующие поля:
access_key — ключ для доступа к приватной статистике ссылки.key — содержательная часть ссылки, то есть та, что идёт после "vk.cc".url — оригинальный URL.Метод messages.getHistoryAttachments возвращает поле message_id для вложений.
Добавлено новое значение семейного положения 8 — «в гражданском браке» в объекты, описывающие пользователей.
В объектах, описывающих сообщества появилось новое поле cover.
Параметр filter метода account.getCounters может принимать новое значение friends_suggestions.
Метод pages.get теперь выполняет проверку на наличие прав администратора при использовании параметра need_source.
Метод account.getInfo возвращает поле 2fa_required для аккаунтов с включенной двухфакторной аутентификацией.
В метод photos.get добавлено ограничение на значение параметра feed: не более месяца с текущей даты.
Изменение в методах wall.getById, wall.get и newsfeed.get: в медиаложениях вида link поле button содержит объект нового формата.
Обновлены требования к размерам изображений в рекламных объявлениях. Подробности.
В возвращаемых объектах, описывающих сообщества, появилось новое поле is_messages_blocked.
В Callback API добавлены новые события: message_allow и message_deny. Метод groups.setCallbackSettings принимает два новых параметра, а метод groups.getCallbackSettings возвращает два новых поля, соответственно.
В возвращаемом объекте app, описывающем приложение, изменились названия полей и размеры изображений иконок и баннеров.
Делать запросы к api.vk.com, начиная с этой версии, можно только по протоколу HTTPS. Подробности перехода на поддержку HTTPS.
Если в параметрах вызова метода не была указана дата окончания, возвращаемые объекты, которые описывают сообщество, теперь не содержат поле finish_data. Ранее это поле присутствовало в ответе и содержало по умолчанию, равное start_date + 2 часа.
В объектах, описывающих сообщества, следующие поля возвращаются только запросами с передачей access_token:
can_messageban_infocan_postcan_upload_doccan_upload_videocan_see_all_postscan_create_topicis_favoriteis_hidden_from_feedМетоды, возвращающие информацию о медиавложениях сообщений и записей, теперь также возвращают медиавложения типов market и market_album.
Изменения в методе 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_specification.ad_platform.
Поле disclaimer в ad_specification заменено на поля disclaimer_medical, disclaimer_specialist, disclaimer_supplements.
Параметр ad_specification.ad_format метода ads.createAds стал обязательным.
Параметр ad_format метода ads.getUploadURL стал обязательным.
Метод account.setInfo теперь принимает универсальные параметры name и value вместо раздельных параметров.
Метод messages.getHistory принимает параметр rev вместе с 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 в сообщениях, добавлены новые поля:
captionis_externalproductapplicationratingbuttonМетоды docs.get, docs.getById возвращают поле preview вместо полей photo_100 и photo_130.
Метод messages.searchDialogs возвращает сообщества в результате поиска.
В методе messages.get введены ограничения на параметры out, time_offset, filters. Теперь их значения могут быть только положительными числами.
В методе messages.getById параметр message_ids стал обязательным.
Метод 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 возвращают объект photo для полей screenshots.
В ответы методов messages.getDialogs и messages.getHistory добавлены поля in_read и out_read.
В методы messages.send, messages.sendSticker, messages.deleteDialog, messages.setActivity и messages.getHistory добавлен параметр peer_id.
Для медиавложений типа link вместо полей image_src и image_big возвращается объект photo.
В метод apps.get добавлены параметры app_ids, return_friends.
В объект app, который описывает приложения и который метод apps.get возвращает, добавлены поля installed и screenshots.
Добавлены методы для работы с активностями приложений.
Теперь метод video.getComments возвращает ошибку при запросе комментариев к видео, если доступ к этим комментариям ограничен.
В методы, возвращающие комментарии, добавлен параметр start_comment_id, который указывает начальный комментарий для возврата.
Объект приватности теперь поддерживает возможное значение friends_of_friends_only.
Параметр device_id является обязательным. Изменён формат настроек приватности.
Изменён формат данных, описывающих приватность.
В метод messages.getLongPollHistory добавлен параметр fields.
Изменён формат результата метода friends.delete.
В метод notifications.get добавлен новый параметры start_from. В возвращаемый методом объект добавлено поле next_from.
Метод newsfeed.getSuggestedSources теперь возвращает результат в виде списка.
Изменения в методе notifications.get. Возвращаемое поле items.type может иметь новое значение wall_publish, которое означает, что предложенная запись размещена на стене.
При использовании параметра 'photo_sizes' метод photos.saveOwnerPhoto вернёт ссылки на все размеры фотографии.
Метод newsfeed.getComments поддерживает параметр last_comments_count, который указывает какое количество комментариев к записям нужно вернуть.
Параметр filter метода groups.getMembers теперь поддерживает значение unsure. Его можно использовать для получения информации о возможных участниках мероприятия, то есть тех, кто выбрал «Возможно пойду».
Убрано ошибочное разделение параметра schools на два. В запросах теперь снова используется один параметр schools.
Список идентификаторов для этого параметра следует получать с помощью метода 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.
Новые возможные значения в поле items.type, которое возвращает метод notifications.get: mention_comment_photo и mention_comment_video.
Параметр schools разделён на два: schools и universities. Теперь id этих объектов такие же, как и в методах database.
В метод newsfeed.search добавлен параметр extended, при передаче которого возвращаются полные результаты со всеми необходимыми для вывода данными о сообществах и пользователях.
В методе friends.areFriends изменён алгоритм генерации поля sign. Теперь он учитывает id пользователя.
Объекты в массиве notes, который возвращают методы newsfeed.get и newsfeed.getRecommeded, теперь содержат поля id и comments.
В метод messages.getDialogs добавлен параметр unread. Если он использован в вызове, метод вернёт информацию о диалогах с непрочитанными входящими сообщениями. Возвращаемый объект будет содержать поле unread_dialogs, которое указывает количество таких диалогов (если оно больше нуля). Для каждого диалога будет возвращено поле unread, которое содержит количество непрочитанных входящих сообщений (если оно больше нуля).
Изменения в методе messages.getHistory.
Параметр rev игнорируется, если в вызове используется start_message_id.
Значение параметра start_message_id и его связь с offset изменены.
Если start_message_id больше нуля, то в возвращаемое значение будет добавлено поле unread, которое указывает количество непрочитанных входящих сообщений (если оно больше нуля), а также поле skipped, которое содержит количество пропущенных сообщений (если оно больше нуля).
Методы newsfeed.getComments, newsfeed.get, newsfeed.getRecommended и newsfeed.search используют пару значений start_from-next_from для постраничного вывода элементов.
start_from — параметр вызова, который указывает начало диапазона возвращаемых элементов.next_from — значение, которое приходит в результатах вызова метода и которое обозначает начало следующего диапазона.Для постраничного вывода надо передать значение next_from из предыдущего вызова в параметр start_from в последующем вызове.
audio.get и video.get возвращают более подробную информацию об ошибках.В случае успешной смены имени метод account.saveProfileInfo возвращает поле name_request, которое содержит объект, описывающий замену. Поле status этого объекта равно success.
В методе messages.get для параметра filters разрешены только значения 0 (все входящие или все исходящие сообщения, по полю out) и 8 (важные сообщения), остальные значения игнорируются.
Метод messages.markAsNew больше не поддерживается.
В методе newsfeed.getComments поле cid было переименовано в id.
Метод notifications.get возвращает объект video в новом формате.
Метод friends.getLists возвращает список в виде объекта с полем count, а поле list_id в ответе заменено на id.
Метод board.getTopics возвращает информацию об опросах в новом формате.
В объектах, которые описывают альбомы и которые возвращаются методами audio.getAlbums и video.getAlbums, поле album_id было заменено на id.
Методы audio.getRecommendations, friends.getSuggestions, groups.getMembers возвращают данные в форме списка.
В объектах заметок, которые возвращает метод places.getCheckins, поле user_id было заменено на uid.
Поля city и country объекта, который описывает пользователя, теперь содержат объект, а не идентификатор.
Переименование полей в объектах, которые включены в возвращаемый объект copy_history:
owner_id переименовано в to_id.reply_to переименовано в reply_post_id.Поле post_type в возвращаемом объекте использует значение post вместо copy для репостов.
Для группируемых оповещений, например, когда пользователи оценили, поделились, подписались, в поле feedback кроме идентификаторов последних пользователей, совершивших действие, возвращается также полное количество пользователей, совершивших это действие за последние сутки.
В объекте описывающем пользователя, поля photo и photo_medium_rec переименованы в photo_50 и photo_100.
Во вложении wall в сообщениях поля from и copy_owner возвращают объект пользователя или сообщества, вместо массива.
В возвращаемом объекте, описывающем вики-страницу, поле pid переименовано в id, поля edited и created имеют новый формат.
В возвращаемом объекте items.feedback поле owner_id заменено на from_id. Также, был исправлен баг со строкой в owner_id.
photos_list (было photo_list).video.getUserVideos, добавлены поля photo_160, photo_320.photos.getTags удалены устаревшие поля uid и tag_id.notifications.getу возвращаемых объектов, которые описывают темы, полеtidзаменено наid`.Большое обновление, затрагивающее почти все методы API ВКонтакте.
Возвращаемые объекты, которые описывают медиавложения, поддерживают новый тип вложений photos_list.
Метод likes.isLiked поддерживает новые формат ответа — объект с полями liked и copied.
Возвращаемые объекты содержат информацию о репостах в новом формате. Кроме того, методы возвращают информацию о последующих репостах.
Если к записи прикреплён альбом, ссылка на альбом не передаётся в тексте записи.
При получении сообщения о смене или удалении фотографии, диалоговое окно больше не содержит пояснение действия.
Новый метод audio.setBroadcast добавляет информацию об аудиозаписи в строку статуса пользователя или администрируемых им сообществ.
Первый элемент возвращаемого массива теперь содержит число возвращаемых альбомов.
В возвращаемых объектах удалены поля online и reply_count.
Первый элемент возвращаемого массива содержит количество результатов.
Информация о ссылках, прикрепленных к личным сообщениям, теперь возвращается в виде объекта.
В возвращаемом объекте поле users переименовано в items, а uid в item.
Первые элемент возвращаемого массива содержит количество возвращаемых результатов.
Изменено значение возвращаемого поля uid. Теперь оно указывает отправителя сообщения.
Ответ метода содержит информацию о подарке в виде объекта, а не документа.
Изменяет формат описания комментариев в возвращаемых объектах, делая его аналогичным формату, используемому в других методах.
Помечает анонимные опросы полем anonymous, не добавляя информации к заголовкам публичных опросов.
Изменён формат результатов методов subscriptions.get и subscriptions.getFollowers. Первый элемент возвращаемого массива указывает количество возвращаемых элементов.
Методы newsfeed.getComments и wall.getComments возвращают информацию об объектах, прикреплённых к комментариям.
Возвращает результат в виде объекта, содержащего информацию пользователях и сообществах, необходимых для отображения найденных записей.
Изменён формат поля chat_active в возвращаемом объекте. Теперь оно представлено массивом, а не строкой.
Первый элемент возвращаемого массива содержит количество возвращаемых изображений.
Параметр count должен быть положительным числом. Параметр offset должен быть неотрицательным.
Вносим кое-какие изменения в код. Постараемся возобновить работу как можно скорее.