Мобильные виджеты

Общая информация

Существует два различных типа мобильных виджетов: пользовательские (относящиеся к текущему пользователю) и прикладные (не связанные ни с одним пользователем).

Например, пользовательский виджет mobile-header содержит панель с логотипом и количество важных событий для текущего пользователя, а прикладной виджет mobile-header содержит только панель с логотипом без какой-либо информации, связанной с пользователями.

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

Применение мобильных виджетов ДОЛЖНО полностью соответствовать следующим правилам:

  • Пользовательские виджеты верхнего колонтитула ДОЛЖНЫ быть вставлены в любое мобильное приложение (игру) в верхней части любой страницы приложения.
  • Наша политика позволяет кэшировать пользовательские виджеты на период максимум 5 минут.
  • При каждом выполнении мобильного приложения из портала odnoklassniki.ru вся кэшированная информация о пользовательских виджетах должна удаляться и запрашиваться заново.
  • Если API-запрос на пользовательские виджеты не может быть обработан в отведенное время, не может быть обработан успешно или просто возвращает ошибку, приложение ДОЛЖНО использовать прикладные виджеты вместо пользовательских. Это единственный случай, когда приложение может заменить пользовательские виджеты на прикладные аналоги.
  • Наша политика позволяет кэшировать прикладные виджеты на период максимум 24 часа.

Мобильные виджеты

На данной странице приведены виджеты, доступные через Odnoklasniki API. Используйте методы widget.getWidgetContent и widget.getWidgets, чтобы получить содержимое виджета и встроить в свое приложение. Приложение может выбрать один из предложенных вариантов виджета:

ИдентификаторОписаниеПример
переданный в GET параметрах (header_widget)В зависимости от ряда условий, сайт Одноклассники может передать название требуемого виджета в игру. Если он указан, запрашивать надо именно его.
Визуально переданный виджет аналогичен mobile-header-small и поддерживает все те же стили.
 
mobile-header-smallЭтот виджет представляет собой маленькую кнопку возврата в Одноклассники и ДОЛЖЕН быть размещен в верхней части всех страниц мобильного HTML-приложения.
Виджет поддерживает стили указанные в примере.
mobile-headerУстаревший. Не поддерживает стили.
Этот виджет содержит верхний колонтитул, который ДОЛЖЕН быть размещен в верхней части всех страниц мобильного HTML-приложения. Он содержит заголовок Odnoklassniki и интерактивную панель инструментов со списком всех новых событий пользователя.
* Запрос mobile-header, подписанный ключом сессии, возвращает пользовательский верхний колонтитул, а подписанный ключом приложения запрос возвращает прикладной верхний колонтитул. Более подробно ситуация описана в разделе Общая информация выше.