Подключить свою игру

Подключение и доступность

Ключ вводится только в защищённой форме подключения, не в контактах и не в Discord. Для аналитики нужно разрешение universe.analytics:read на выбранную игру. Ошибки 401/403 требуют проверки ключа и прав; 429 означает ограничение частоты.

Повторный частый клик не ускоряет появление данных. Сохранённые значения остаются доступны при сбоях источника. Исторические дни, разбивки и отдельные показатели могут появляться с задержкой; D30 требует созревшей когорты.

Доступы: цвет и действие

В карточке игры цветной индикатор открывает настройки ключа, если ваша роль позволяет ими управлять. Зелёный — все текущие модули имеют нужные права, ключ проверен и нет известных ошибок доступа. Жёлтый — часть прав отсутствует, проверка устарела или Roblox временно недоступен.

Красный — подключённый доступ отклонён Roblox. Наведение показывает значение цвета; индикатор также подписан для программы чтения с экрана. Доступ по роли не выдаётся за состояние ключа владельца.

Вверху настроек вставьте ключ и нажмите «Применить ключ». Ниже каждый модуль показан отдельным блоком: «Есть», «Добавить», «Проверить» или «Недоступно». Названия API и подробные шаги раскрываются ниже.

Проверка сохранённого ключа не требует вводить его снова; повторные проверки в течение минуты используют сохранённый результат. Статусы хранятся на сервере, а не только в этом браузере; после суток без проверки зелёный сменяется жёлтым. Проверка не создаёт тестовую рекламу, не загружает изображения и не меняет товары: права записи и доступ к конкретному ресурсу окончательно проверяются при вашем действии.

Ограничения и безопасное подключение

Ключ создаёт владелец игры или участник группы с нужными полномочиями. Один ключ не объединяет права разных аккаунтов: для рекламы нужен доступ того же владельца ключа к рекламному аккаунту и игре; для Assets — к выбранному создателю. Ограничивайте область каждой игры и группы.

IP-ограничения должны соответствовать исходящим адресам сервера MARPLA, а не адресу вашего компьютера; у облачного хостинга нет обещанного постоянного исходящего IP. Проверяйте срок действия и Enabled. Секрет шифруется на сервере, не появляется в URL, инструкции и результатах проверки.

Права Roblox и роли MARPLA независимы: ключ сам по себе не даёт участнику сервиса разрешение менять цену или рекламу.

Если прав не хватает

Единая кнопка синхронизации в отчёте, разделах и графиках имеет одинаковый значок. В шапке инвестора она стоит под датой. При обычной ошибке стрелки краснеют, подсказка предлагает повторить запрос; большие технические плашки не выводятся.

Клик повторно ставит запрос в очередь, не обходя паузы Roblox. При отсутствии ключа или подтверждённом запрете доступа сохраняется действие настройки ключа. После сохранения показываются разрешения, заявленные в ключе, а не гарантия успешности всех операций.

Права записи проверяются при вашем действии — тестовая реклама, покупки и загрузки ради проверки не создаются. 401: проверьте сам ключ, включение и срок. 403: проверьте названное разрешение и доступ к ресурсу. 429 и временная недоступность — не повод добавлять права. В аналитике, рекламе, креативах и каталоге товаров ссылка настройки открывает общий ключ с нужным модулем. Добавьте конкретное разрешение в Roblox и повторно сохраните тот же ключ в MARPLA; если Roblox выдал новый секрет, используйте новый.

История не удаляется.

Что нельзя открыть дополнительным Roblox-ключом

Публичные данные и контакты · есть

Текущий онлайн, публичный каталог и наблюдение не требуют личного Roblox API Key. Контакты Discord, приглашения и инвесторские ссылки управляются правами MARPLA, а не правами Roblox.

P50/P90 и история

Точные дневные зоны Creator Dashboard запрашиваются отдельно и сохраняются отдельно от метрик игры. Roblox может не разрешить benchmark endpoint обычному API-ключу; тогда MARPLA показывает свежую завершённую метрику игры без устаревшей шкалы, а не смешивает её со старым снимком P50/P90. Новый ключ не создаёт данные до подключения, несозревшие когорты или полный журнал покупок.

SDK · есть

Дополнительные события требуют установки SDK и отдельного секрета MARPLA в серверном коде игры. Это не ещё одно право Roblox Open Cloud.

Roblox OAuth · общий аккаунт

Вход и профиль используют единое подтверждение Roblox. По умолчанию запрашиваются права текущих модулей: аналитика, реклама, Assets, пассы и товары. Реклама переиспользует разрешение аналитики из аккаунта владельца подключения.

Ключ игры остаётся основой фонового сбора и остальных Open Cloud операций; OAuth не отменяет права на конкретный Universe или рекламный аккаунт. Client secret настраивает администратор MARPLA.

Discord / Telegram / ИИ · скоро

Есть интерфейсы-заглушки. Для реальной доставки и чатов понадобятся отдельные подключения бота или webhook с минимальными правами; для ИИ — серверный провайдер. Эти секреты нельзя вставлять в поле Roblox API Key.

Поддержка разработчика · ссылки есть

Доступны внешние платёжные ссылки и ссылка покупки пасса в Roblox. Приём денег, автоматическая проверка пожертвований и прямые переводы Robux в MARPLA не реализованы; разрешения Analytics и Products этого не дают.