apps

apps.addSnippet

Метод добавляет новый сниппет в коллекцию сниппетов мини-приложения или игры.

Сниппеты можно создавать для мини-приложений и игр, опубликованных в каталоге. Для каждого мини-приложения или игры можно создать до 10 сниппетов.

Время жизни сниппета не ограничено. Он хранится до тех пор, пока вы его не удалите.

Для вызова метода можно использовать:

Параметры

vk_ref

string

Массив с информацией о применении сниппета:

  • •
    snippet_im — сниппет используется в личном сообщении.
group_id

string

Список идентификаторов сообществ, в которых может быть отображён сниппет.

hash

string

Список хешей для запуска мини-приложений или игр, для которых будет отрисован сниппет.

Хеш — подстрока в ссылке после символа #. Сниппет будет отображён, если ссылка содержит хеш, который указан в массиве.

Важно. Значения чувствительны к регистру. В массиве можно указать значения с маской — символом *. Маска означает любое количество символов или пустую подстроку. Например, значение join* соответствует следующим ссылкам: https://vk.com/app123#join_invite https://vk.com/app123#join_msg https://vk.com/app123#join

Элемент массива без * соответствует ссылкам, в которых хеш точно совпадает со значением элемента. Например, join соответствует ссылке https://vk.com/app123#join, но не https://vk.com/app123#join_invite.

Максимальная длина — 100 символов.

snippet_id

integer

Идентификатор сниппета.

title

string

В настоящее время не используется. Зарезервирован для применения в будущем.

description

string

Описание сниппета. Максимальная длина: 80 символов.

image_url

string

URL изображения сниппета. Размер изображения: 1120×630 px.

small_image_url

string

URL изображения сниппета. Размер изображения: 150×150 px.

button

string

Текст кнопки сниппета. Возможные значения:

  • •
    open — «Открыть».
  • •
    buy — «Купить».
  • •
    buy_ticket — «Купить билет».
  • •
    enroll — «Записаться».
  • •
    contact — «Связаться».
  • •
    fill — «Заполнить».
  • •
    go — «Перейти».
  • •
    play — «Играть».
  • •
    help — «Помочь».
  • •
    create — «Создать».

Результат

Если новый сниппет был добавлен, метод возвращает идентификатора сниппета, указанный в параметре snippet_id. В случае ошибки ответ содержит 0.

Пример ответа:

JSON
{ "response": "my_snippet_id" }

Коды ошибок

11003
Empty filter params
11004
Empty snippet data
11005
Too many snippets
11006
Not found snippet

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