Cloud Code API の呼び出し

Cloud Code API を呼び出して、スクリプトを実行します。詳細については、Cloud Code API のドキュメント を参照してください。

認証

サービスアカウントまたはステートレストークンを使用してプレイヤーまたは信頼されているクライアントとして認証するには、認証 を参照してください。受信したトークンを Bearer トークンとしてリクエストヘッダーで HTTP 認証に使用します。

Authorization: Bearer <BEARER_TOKEN>

スクリプトリクエストの実行

POST リクエストを以下の宛先に送信することで、Cloud Code API を呼び出します。

https://cloud-code.services.api.unity.com/v1/projects/<PROJECT_ID>/scripts/<SCRIPT_NAME>

パスパラメーターを定義します。

  • projectId - プロジェクトの ID。
  • scriptName - スクリプトの名前。

単純な cURL コマンドは以下のようになります。

curl --request POST 'https://cloud-code.services.api.unity.com/v1/projects/<PROJECT_ID>/scripts/<SCRIPT_NAME>' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <BEARER_TOKEN>'

リクエストペイロード

スクリプト内でパラメーターを定義できます。これらのパラメーターは、リクエスト本文内で渡されます。スクリプトにパラメーターがない場合は、空の params オブジェクトを渡すことができます。

{
  "params": {
    "numericParam": 123,
    "stringParam": "abcdef",
    "booleanParam": true,
    "jsonParam": {
      "key": "value"
    }
  }
}

サンプル出力

これは、playerInfo オブジェクトを返すスクリプトの出力例です。

{
  "output": {
    "playerInfo": {
      "playerID": "TestUser",
      "userName": "TestUserName",
      "displayName": "Name",
      "email": "test@test.com",
      "country": null,
      "deviceType": null,
      "platform": "IOS",
      "dateCreated": "string"
    }
  }
}