# ユーザーが所有しているゲームソフトのリストを取得

ユーザーが所有しているゲームソフトのリストを取得します。応答には特定のユーザーが所有するゲームの配列が含まれます。


  注意
    すべてのプロジェクトには、応答で取得できるアイテム数に制限があります。デフォルトおよび最大値は1応答あたり50アイテムです。ページごとにデータを取得するには、制限とオフセットフィールドを使用してください。





  注意
    認証なしで使用した場合、このAPIコールは一般的なアイテムカタログデータを返します。認証を使用して、アイテムに関連する制限やプロモーションなどのパーソナライズされたユーザーデータを取得します。これを行うには、ユーザーのJWTをAuthorizationヘッダーに渡してください。ユーザーJWTの詳細については、このコールのセキュリティブロックを参照してください。

Endpoint: GET /v2/project/{project_id}/entitlement
Version: 2.0.0
Security: XsollaLoginUserJWT

## Path parameters:

  - `project_id` (integer, required)
    プロジェクトID。このパラメータは、パブリッシャーアカウントのプロジェクト名の横、またはプロジェクトの作業中にブラウザのアドレスバーで確認できます。URLの形式は以下の通りです：https://publisher.xsolla.com//projects/。
    Example: 44056

## Query parameters:

  - `limit` (integer)
    ページでの要素数の制限。
    Example: 50

  - `offset` (integer)
    リストが生成される要素番号（カウントは0から始まります）。

  - `sandbox` (integer)
    どのような種類の資格が返されるべきか。このパラメータが1に設定された場合、サンドボックスモードでユーザーによって受信された資格のみが返されます。パラメータが渡されないまたは0に設定されている場合、ライブモードでのみユーザーによって受信された資格が返されます。

  - `additional_fields[]` (array)
    追加フィールドのリスト。これらのフィールドは、リクエストの中で送信すると、応答に含まれます。利用可能なフィールドはattributes。

## Response 200 fields (application/json):

  - `has_more` (boolean)
    ページ数がもっとあることを示す指標として使用されます。

  - `total_items_count` (integer)
    システムでのアイテムの合計数。

  - `items` (array)

  - `items.name` (string)
    ゲームパッケージ名。

  - `items.description` (string)
    ゲームパッケージ説明。

  - `items.project_id` (integer)
    プロジェクトID。このパラメータは、[パブリッシャーアカウント](https://publisher.xsolla.com/)のプロジェクト名の横にあります。

  - `items.game_sku` (string)
    一意のキーパッケージID。

  - `items.drm` (string)
    一意のDRM ID。
    Enum: "steam", "playstation", "xbox", "uplay", "origin", "drmfree", "gog", "epicgames", "nintendo_eshop", "discord_game_store", "oculus", "rockstar", "viveport", "stadia"

  - `items.image_url` (string)
    画像URL。決済UI上で画像を正しく表示し、高速に読み込ませるために、当社の画像およびURLガイドラインを確認ください：サポートされているフォーマット：WebP（推奨）、PNG、JPGファイルサイズ：50 KB以下（WebPの場合）または150 KB以下（PNGおよびJPGの場合）画像サイズ：280 × 280 pxカラースペース：sRGBプロトコル：バージョン管理されたURLに対する、長期キャッシュを伴うHTTPS

  - `items.is_pre_order` (boolean)
    ゲームが先行予約状態であるかどうか。

  - `items.attributes` (array)
    ゲームに対応する属性と値のリスト。

注意。この部分は、additional_fields[]=attributesクエリパラメータを送信した場合のみ利用可能なレスポンスです。

  - `items.attributes.external_id` (string)
    一意の属性ID。external_idには、英大文字、英小文字、数字、ダッシュ、アンダースコアのみを含めることができます。

  - `items.attributes.name` (string)
    属性名。
    Example: "Genre"

  - `items.attributes.values` (array)

  - `items.attributes.values.external_id` (string)
    属性の一意の値ID。external_idには、英小文字、数字、ダッシュ、アンダースコアのみを含めることができます。

  - `items.attributes.values.value` (string)
    属性値。
    Example: "Strategy"

## Response 401 fields (application/json):

  - `statusCode` (integer)
    Example: 401

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"