wall.post
Позволяет создать запись на стене, предложить запись на стене публичной страницы, опубликовать существующую отложенную запись.
Этот метод можно вызвать с ключом доступа пользователя, полученным в Standalone-приложении через Implicit Flow.
Требуются права доступа: wall.
Параметры
string
Идентификатор пользователя или сообщества, на стене которого должна быть опубликована запись.
Обратите внимание, идентификатор сообщества в параметре
owner_id
необходимо указывать со знаком «-» — например,owner_id
=-1
соответствует идентификатору сообщества ВКонтакте API (club1).
string
1
— запись будет доступна только друзьям, 0
— всем пользователям. По умолчанию публикуемые записи доступны всем пользователям.
string
Данный параметр учитывается, если owner_id
< 0
(запись публикуется на стене группы). 1
— запись будет опубликована от имени группы, 0
— запись будет опубликована от имени пользователя (по умолчанию).
string
Текст сообщения (является обязательным, если не задан параметр 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
.
string
Список сервисов или сайтов, на которые необходимо экспортировать запись, в случае если пользователь настроил соответствующую опцию. Например, twitter
, facebook
.
string
1
— у записи, размещенной от имени сообщества, будет добавлена подпись (имя пользователя, разместившего запись), 0
— подписи добавлено не будет. Параметр учитывается только при публикации на стене сообщества и указании параметра from_group
. По умолчанию подпись не добавляется.
string
Дата публикации записи в формате unixtime
. Если параметр указан, публикация записи будет отложена до указанного времени.
string
Географическая широта отметки, заданная в градусах (от -90 до 90).
string
Географическая долгота отметки, заданная в градусах (от -180 до 180).
string
Идентификатор места, в котором отмечен пользователь.
string
Идентификатор записи, которую необходимо опубликовать. Данный параметр используется для публикации отложенных записей и предложенных новостей.
string
Уникальный идентификатор, предназначенный для предотвращения повторной отправки одинаковой записи. Действует в течение одного часа.
string
1
— у записи, размещенной от имени сообщества, будет добавлена метка Это реклама, 0
— метки добавлено не будет. В сутки может быть опубликовано не более пяти рекламных записей, из которых не более трёх — вне Биржи ВКонтакте.
string
1
— комментарии к записи отключены,
0
— комментарии к записи включены.
string
Период времени в течение которого запись будет доступна для донов — платных подписчиков VK Donut. Возможные значения:
- •
-1
— исключительно для донов; - •
86400
— на 1 день; - •
172800
— на 2 дня; - •
259200
— на 3 дня; - •
345600
— на 4 дня; - •
432000
— на 5 дней; - •
518400
— на 6 дней; - •
604800
— на 7 дней.
string
1
— уведомления к записи отключены;
0
— уведомления к записи включены.
string
Источник материала. Поддерживаются внешние и внутренние ссылки.
string
При публикации отложенной записи все параметры, кроме owner_id
и post_id
, игнорируются.
Результат
После успешного выполнения возвращает идентификатор созданной записи (post_id
).
Коды ошибок
В ходе выполнения могут произойти общие ошибки.