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

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

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

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

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

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

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

Если Roblox скрыл сведения о приватной игре и карточка показывает ID 0, сначала нажмите «Восстановить карточку» и укажите полную ссылку roblox.com/games/…; история и доступы MARPLA сохраняются. Скрытое название заменяется на Universe с проверенным ID. Затем вверху настроек вставьте ключ и нажмите «Применить ключ».

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

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

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

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

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

Права Roblox и роли MARPLA независимы: ключ сам по себе не даёт участнику сервиса разрешение менять цену или рекламу. Добавивший ссылку получает роль «Участник без API»: он может пригласить только такую же ограниченную роль, но не видит приватную аналитику и не управляет Roblox по одной ссылке. Любой участник с правом game.view добавляет свой ключ; проверенный доступ к точной Universe делает его владельцем.

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

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

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

Клик повторно ставит запрос в очередь, не обходя паузы 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 этого не дают.

Один аккаунт и игры Roblox

Откройте «Моя карточка MARPLA» в /account. Здесь вместе сохраняются описание, площадки продвижения, деловые контакты, студии, доступные игры и результаты. Страница использует общее боковое меню MARPLA.

Основные сведения, каналы с контактами, студии с играми собраны в ровные блоки; на телефоне — одна колонка. Ссылки разделов прокручивают одну страницу. Кнопка «Сохранить карточку» доступна при прокрутке.

Выбор раздела не сохраняет изменения автоматически. Автор и разработчик — роли одного человека, не отдельные регистрации; роль не выдаёт права управления играми. Карточка по /people/ID появляется только после явного включения публикации и доступна зарегистрированным пользователям после входа; контакты публикуются каждый отдельно.

Roblox, разрешения, настройки сообщений, почта, пароль и активные сессии находятся ниже на этой же странице. Переключаться на отдельную вкладку настроек не нужно. В «Мои игры» можно добавить ссылку или открыть «Из моего Roblox-аккаунта», связать текущий аккаунт с Roblox и выбрать игру.

Добавленные игры отмечены, повторная карточка не создаётся. Отдельная таблица «Предоставленный доступ» в «Моих играх» не показывается; ранее выданные ссылки на отчёты продолжают открываться. В блоке импорта переключитесь на «Игры моих групп», выберите группу Roblox и добавьте её игру.

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

«Обновить группы» обновляет группы, «Обновить игры» — выбранный список; «Показать ещё» загружает следующую страницу. Публичный список не раскрывает приватные игры. Если нужной игры нет в списке, попробуйте добавить её по ссылке.

В аккаунте любимые игры, созданные игры и сообщества показаны компактными строками с иконками; полное длинное название видно при наведении. Сохранение игры не подтверждает владение Roblox и не открывает приватную аналитику без необходимых доступов.