メッセージサービス

*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

エクスペリエンスのサーバー間でブロードキャストメッセージを送信し、受信するための次のリクエストとレポートを送信できます。API の使用に関する詳細は、メッセージの使用ガイド を参照してください。

CrossServerMessaging

https://apis.roblox.com/messaging-service/

次のエンドポイントは、ベースのURLに相対するパスで使用できます。

メッセージを公開する

POST /v1/universes/{universeId}/topics/{topic}

エクスペリエンスのプレディファインドトピックにメッセージを公開するには、メッセージのサイズを 1,024 文字 (1 KB) まで拡大/縮小する必要があります。公開 権限が必要な API キーとユニバースメッセージサービス:publisher

パラメータ

universeId number

メッセージを送信するエクスペリエンスの識別子。クリエイターダッシュボードでエクスペリエンスの ユニバース ID をコピーできます。

Path
必須
topic string

メッセージを公開するトピック、最大 80 文字。

Path
必須

レスポンス

必要な権限

このエンドポイントを呼び出すには以下のAPIキー権限が必要です。適切なキーの生成方法についての情報は、 API キーの管理 をごらんください。

  • 公開

あなたのOAuth 2.0 アプリケーションでこのエンドポイントを使用するには以下のスコープが必要です。OAuth 2.0 アプリケーションの登録方法についての情報は、 アプリ登録とレビュー をごらんください。

  • universe-messaging-service:publish

オブジェクト

以下のオブジェクトは、受け入れられたか返されたペイロードの説明です。これらのオブジェクトがいつ使用されるかについて詳しくは、各エンドポイントを参照してください。

PublishRequest

ライブサーバーに公開したいメッセージストリングのリクエストボディオブジェクト。

属性

message string

ライブサーバーに公開したいメッセージのコンテンツ。