Steam 実績を同期する

Last updated on November 6, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要​

important

Steam マルチアプリを有効にすると、appId を省略した Steam 実績同期の呼び出しはすべて、ゲームサーバーからの呼び出しか Extend サービスからの呼び出しかにかかわらず失敗するようになります。有効にする前に、これらの呼び出し元を更新してください。

Steam 実績の同期はサーバー側のユースケースです。ゲームサーバー、またはカスタマイズした AGS Extend サービスが管理 API を呼び出して、Steam 実績をロック解除します。ゲームクライアントがこの API を呼び出すことはありません。

Steam 実績は 1 つのアプリに属します。アプリ A に存在する実績はアプリ B には存在しないため、AGS はどのアプリで実績をロック解除するかを把握している必要があります。呼び出し元は、実績が属するアプリの App ID を送信します。このパラメーターは API では任意であるため、既存の連携はそのまま動作し、設定を有効にするまで影響を受けません。このエンドポイントは、リクエストペイロードで appId を受け付けます。

リクエストエンドポイント
Steam 実績をロック解除するPUT /platform/admin/namespaces/{namespace}/users/{userId}/achievement/steam

AGS は、その他の処理を実行する前に appId を確認します。結果は、Enable Steam multi app IDs がオンかオフかによって異なります。

リクエスト内の appId結果
送信されていない受理されます。AGS は設定済みの App ID を使用します。
設定済みの App ID と一致する受理されます。
設定済みの App ID と異なるエラー 39129 で拒否されます。

次の例では、特定のアプリで実績をロック解除します。id は Steamworks 上の実績の API 名です。<YourSteamAppId> は、実績が属するアプリの App ID に置き換えてください。

curl -X PUT "https://<YourBaseUrl>/platform/admin/namespaces/<YourNamespace>/users/<AgsUserId>/achievement/steam" \
  -H "Authorization: Bearer <GameServerAccessToken>" \
  -H "Content-Type: application/json" \
  -d '{
    "steamUserId": "<SteamId>",
    "appId": "<YourSteamAppId>",
    "achievements": [
      { "id": "<AchievementApiName>", "value": 1 }
    ]
  }'

Extend SDK で Steam 実績をロック解除する​

ゲームサーバーまたは Extend サービスから Steam 実績をロック解除するには、次の関数を使用します。

近日公開

に最終更新
On this page