GAMEPOT 3.0の概要

Prev Next

Classic/VPC環境で利用できます。

GAMEPOT 3.0は、ゲームの開発、サービス、運用に必要な機能を統合して提供する NAVERクラウドプラットフォームのサービスです。GAMEPOT 3.0サービスは、ゲームユーザー管理に必要なさまざまな機能を RESTful API形式で提供します。

GAMEPOTバージョン

GAMEPOTは、GAMEPOT 2.0と GAMEPOT 3.0を提供しています。各バージョンの説明は次の通りです。

区分 説明
GAMEPOT 2.0 ゲーム開発および運用のためのさまざまな機能を提供するサービスで、ゲーム開発者が効率的にゲームを開発・管理できるようにサポート
  • 高度なユーザー統計と同時接続ユーザー管理機能
  • 運用・管理が容易なダッシュボード
  • さまざまなログイン連携機能(Google、Apple、Facebook、LINEなど)
  • さまざまなストアとの連携機能
  • さまざまなプラットフォームに対応(Android、iOS、Unity、Unreal、JavaScript)
  • 実装が容易な決済機能
GAMEPOT 3.0 GAMEPOT 2.0の必須機能を拡張・改善したバージョンで、ゲーム開発・運用に必要なすべての機能をモジュール別に提供
  • モジュール別機能が提供され必要な機能の連携が容易
  • repository、cocoapodsの形で提供される簡素化した開発環境連携
  • 改善されたダッシュボードによるゲーム統計と管理機能
  • さまざまなログイン連携機能(Google、Apple、Facebook、LINE、Steamなど)
  • さまざまなストアとの連携機能
  • 実装が容易な決済機能
  • プラグイン機能による拡張性
参考

GAMEPOT 2.0 APIを使用するには、GAMEPOT 2.0の概要をご参照ください。

GAMEPOT 3.0の共通設定

GAMEPOT 3.0 APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

リクエスト

共通リクエスト形式を説明します。

API URL

リクエスト API URLは次の通りです。

https://dashboard-api.gamepot.ntruss.com

リクエストヘッダ

リクエストヘッダの説明は次の通りです。

フィールド 必須の有無 説明
x-api-key Required GAMEPOT 3.0用 APIキー
  • GAMEPOT 3.0ダッシュボードの プロジェクトの設定 > API Key で [追加] ボタンをクリックして発行
    • 設定した有効期限まで有効
x-project-id Required GAMEPOT 3.0プロジェクト ID
  • GAMEPOT 3.0ダッシュボードの プロジェクトの設定 > 一般 から確認
Content-Type Required リクエストデータの形式
  • application/json
Accept Required レスポンスデータの形式
  • application/json

レスポンス

共通レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

Error
Errorは API呼び出し失敗情報を定義します。Errorの説明は次の通りです。

フィールド タイプ 必須の有無 説明
status Integer - レスポンスコード
message String - エラーメッセージ

レスポンスステータスコード

レスポンスステータスコードの説明は次の通りです。

HTTPステータスコード コード メッセージ 説明
- 1 - レスポンス成功
- -1 -
  • 登録されていない APIキー入力
  • アクセス権限なし
- -2 - ダッシュボードの APIキーとヘッダに入力した APIキーが一致しない
- -3 - 削除された APIキー
- -4 - ダッシュボードで未使用処理された APIキー
- -5 - 期限切れの APIキー
- -6 - 存在しないプロジェクト ID
- -9 - 必須ヘッダ欠落
参考

NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。

レスポンス例

呼び出しが成功した場合のレスポンス例は、API仕様書を確認してください。呼び出しに失敗した場合のレスポンスのサンプルコードは次の通りです。

{
  "status": -6,
  "message": "projectId was wrong."
}

GAMEPOT 3.0 API

GAMEPOT 3.0サービスで提供する APIの説明は次の通りです。

API 説明
ユーザーの利用停止 指定したユーザーのゲーム利用停止を実行
プッシュ通知の送信 プッシュ通知メッセージの即時または予約送信
サポートお知らせリストの照会 サポート画面のお知らせリストを照会
サポートお知らせの照会 サポート画面のお知らせを照会
お知らせリストの照会 お知らせリストを照会
お知らせの照会 お知らせを照会
ユーザー連携情報の照会 ユーザーのアカウント連携情報を照会
ユーザー利用停止リストの照会 利用停止状態ユーザーリストを照会
ユーザーの照会 ユーザーの詳細情報を照会
プレイヤーリストの照会 ゲームプレイヤーリストを照会

GAMEPOT 3.0関連リソース

GAMEPOT 3.0 APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。