Публикации ВКонтакте
Публикации с сайтов
Share
Для публикации ссылки на страницу вашего сайта используйте виджет Публикация ссылок или его упрощенную версию — ссылку вида https://vk.com/share.php?url=
.
Другие виджеты
Возможность поделиться с друзьями реализована в нескольких виджетах для внешних сайтов. В каждом из этих случаев к записи на стене пользователя будет прикреплена ссылка на страницу вашего сайта, где размещен виджет:
- •Виджет комментариев — пользователь может поделиться комментарием на своей стене. Параметр
autoPublish
позволяет настроить публикацию по умолчанию. - •Виджет «Мне нравится» — действие Рассказать друзьям создает на странице пользователя запись с опциональным комментарием.
- •Виджет опросов — пользователь может поделиться результатом голосования в опросе.
Публикации из приложений
Для публикации записей из клиентских и серверных приложений используйте метод wall.post
. Вы можете обращаться к нему напрямую, используя классическую схему взаимодействия с API, из SDK, из Open API, если речь идет о приложении-сайте. В Open API и приложениях на vk.com действие потребует подтверждения пользователя.
Медиаконтент в записи на стене
Чтобы добавить к записи аудио, видео или фото, передайте в параметре attachments
тип объекта и его строковый идентификатор.
Тип объекта — audio
, video
, photo
или doc
.
Строковый идентификатор — это строка, включающая идентификатор владельца объекта (owner_id
) и идентификатор самого объекта (audio_id
, video_id
и т.д.).
Например, для фотографии photo34_408897832
в attachments
нужно передать значение photo34_408897832
.
https://api.vk.com/method/wall.post
?owner_id=-1
&message="Tanya"
&attachments="photo34_408897832"
&access_token={YOUR_ACCESS_TOKEN}
&v=5.131
Запрос к методу wall.post
для публикации записи с текстом «Tanya» и прикреплённой фотографией photo34_408897832
на стену сообщества club1
.
Если вы хотите прикрепить новый объект к записи на стене, необходимо сначала загрузить его на сервер ВКонтакте. В зависимости от типа контента используйте один из подходов, описанных на этой странице. Затем используйте идентификатор загруженного объекта в параметре attachments
.
Предложенные и отложенные записи
С помощью wall.post
вы можете работать с предложенными и отложенными записями. Чтобы создать предложенную запись, передайте в owner_id
идентификатор публичной страницы, в которой текущий пользователь не является руководителем.
Чтобы создать отложенную запись, передайте время публикации в параметре publish_date
.
Для публикации предложенных и отложенных записей используйте параметр post_id
, значение для которого можно получить методом wall.get
с filter
=suggests
и postponed
соответственно.
Ссылки на внешние сайты
Чтобы добавить к записи сниппет ссылки с внешнего сайта (превью-изображение, заголовок и описание), передайте URL в параметре attachments
. Например, https://yandex.ru/
. Сниппет генерируется автоматически, более подробно об этом вы можете прочитать в следующем разделе.
Оформление внешних ссылок
Данные сниппета
Сниппет — это карточка с обложкой, изображением и заголовком для ссылки. Когда вы публикуете ссылку в записи на стене, в комментарии или личном сообщении, сниппет генерируется автоматически — для этого используются данные с той страницы, на которую ведёт ссылка.
А именно:
- •Заголовок. Если на странице есть теги
og:title
,mrc__share_title
илиtwitter:title
, то заголовок будет взят из одного из них (указанного первым), иначе будет использован тег<title>
. - •Иллюстрация. Если на странице есть тег
vk:image
, то адрес изображения для иллюстрации будет взят из него. Если такого тега нет, проверяется содержимое теговog:image
,twitter:image
,image
— адрес изображения для иллюстрации будет взят из указанного первым, иначе будут взяты первые 8 тегов<img src="...">
, и из них предложены в качестве иллюстрации те картинки, размер которых по ширине и высоте превышает 160 пикселей.
Мы рекомендуем использовать картинки размером не менее 510x228 пикселей. В этом случае ссылка будет сопровождаться увеличенной картинкой (510x228 пикселей) в сниппете на стене. Если картинка имеет меньший размер (но не менее 160 пикселей по каждой из сторон), или к записи помимо ссылки прикреплены другие вложения, картинка в сниппете будет уменьшенная — 150x83 пикселя.
Например, указать заголовок и картинку для сниппета можно так:
<head>
<meta property="og:title" content="Заголовок страницы" />
<meta property="vk:image" content="https://pp.vk.me/c629531/v629531034/3172e/xEBYyER1WE4.jpg" />
</head>
Обратите внимание, данные для публикации могут кэшироваться. Если вы изменили данные на своем сайте, а ВКонтакте при публикации отображаются старые значения, сбросьте кэш для ссылки на странице pages.clearCache
.
Предпросмотр содержимого страниц сайтов
В записях сообщества можно размещать ссылки на статьи, содержимое которых пользователь сможет посмотреть в интерфейсе ВКонтакте без перехода на внешний сайт. В таких записях появляется кнопка Просмотреть. Нажав на неё, пользователь увидит содержимое статьи на странице с адресом, начинающимся с https://vk.com/@
, который будет сформирован автоматически.
Чтобы подключить предпросмотр для ссылок с вашего сайта, пожалуйста, напишите в Поддержку. В заявке необходимо указать ссылки на несколько примеров статей, ссылку на сообщество вашего сайта ВКонтакте, а также данные о посещаемости сайта и сообщества.