wall

wall.post

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

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

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

Параметры

owner_id

string

Идентификатор пользователя или сообщества, на стене которого должна быть опубликована запись.

Обратите внимание, идентификатор сообщества в параметре owner_id необходимо указывать со знаком «-» — например, owner_id=-1 соответствует идентификатору сообщества ВКонтакте API (club1).

friends_only

string

1 — запись будет доступна только друзьям, 0 — всем пользователям. По умолчанию публикуемые записи доступны всем пользователям.

from_group

string

Данный параметр учитывается, если owner_id < 0 (запись публикуется на стене группы). 1 — запись будет опубликована от имени группы, 0 — запись будет опубликована от имени пользователя (по умолчанию).

message

string

Текст сообщения (является обязательным, если не задан параметр attachments).

attachments

string

Объект или несколько объектов, приложенных к записи. К записи можно приложить медиа или ссылку на внешнюю страницу. Если объектов несколько, их нужно указать через запятую «,».

Формат описания медиа-приложения:

<type><owner_id>_<media_id>

<type> — тип медиа-приложения:

  • photo — фотография;
  • video — видеозапись;
  • audio — аудиозапись;
  • doc — документ;
  • page — wiki-страница;
  • note — заметка;
  • poll — опрос;
  • album — альбом;
  • market — товар;
  • market_album — подборка товаров;
  • audio_playlist — плейлист с аудио.

<owner_id> — идентификатор владельца медиа-приложения (обратите внимание, если объект находится в сообществе, значение должно быть отрицательным числом).

<media_id> — идентификатор медиа-приложения.

Формат описания ссылки:

<protocol><URL>

<protocol> — протокол HTTP или HTTPS. <URL> — оставшаяся часть URL.

Формат для перечисления объектов:

<type><owner_id>_<media_id>,<type><owner_id>_<media_id>,<protocol<URL>

Обратите внимание, можно указать несколько медиа-приложений, но только одну ссылку. Если указать больше одной ссылки, будет возвращена ошибка.

Примеры:

photo100172_166443618,photo-1_265827614
photo66748_265827614,https://example.ru
https://example.ru

Параметр attachments является обязательным, если не задано значение message.

services

string

Список сервисов или сайтов, на которые необходимо экспортировать запись, в случае если пользователь настроил соответствующую опцию. Например, twitter, facebook.

signed

string

1 — у записи, размещенной от имени сообщества, будет добавлена подпись (имя пользователя, разместившего запись), 0 — подписи добавлено не будет. Параметр учитывается только при публикации на стене сообщества и указании параметра from_group. По умолчанию подпись не добавляется.

publish_date

string

Дата публикации записи в формате unixtime. Если параметр указан, публикация записи будет отложена до указанного времени.

lat

string

Географическая широта отметки, заданная в градусах (от -90 до 90).

long

string

Географическая долгота отметки, заданная в градусах (от -180 до 180).

place_id

string

Идентификатор места, в котором отмечен пользователь.

post_id

string

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

guid

string

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

mark_as_ads

string

1 — у записи, размещенной от имени сообщества, будет добавлена метка Это реклама, 0 — метки добавлено не будет. В сутки может быть опубликовано не более пяти рекламных записей, из которых не более трёх — вне Биржи ВКонтакте.

close_comments

string

1 — комментарии к записи отключены, 0 — комментарии к записи включены.

donut_paid_duration

string

Период времени в течение которого запись будет доступна для донов — платных подписчиков VK Donut. Возможные значения:

  • -1 — исключительно для донов;
  • 86400 — на 1 день;
  • 172800 — на 2 дня;
  • 259200 — на 3 дня;
  • 345600 — на 4 дня;
  • 432000 — на 5 дней;
  • 518400 — на 6 дней;
  • 604800 — на 7 дней.
mute_notifications

string

1 — уведомления к записи отключены; 0 — уведомления к записи включены.

copyright

string

Источник материала. Поддерживаются внешние и внутренние ссылки.

topic_id

string

При публикации отложенной записи все параметры, кроме owner_id и post_id, игнорируются.

Результат

После успешного выполнения возвращает идентификатор созданной записи (post_id).

Коды ошибок

214
Access to adding post denied
219
Advertisement post was recently added
220
Too many recipients
222
Hyperlinks are forbidden
224
Too many ads posts
225
Donut is disabled

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