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

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

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

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

## Path parameters:

  - `project_id` (integer, required)
    プロジェクトID。このパラメータは、パブリッシャーアカウントのプロジェクト名の横にあります。
    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)
    ページ数がもっとあることを示す指標として使用されます。
    Example: true

  - `items` (array)

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

注意。この部分は、additional_fields[]=attributesクエリパラメータを送信した場合のみ利用可能なレスポンスです。
    Example: {"value":{"external_id":"genre","name":"Жанр","values":[{"external_id":"genre_e3364991f92e751689a68b96598a5a5a84010b85","value":"Casual"},{"external_id":"genre_eba07bfd0f982940773cba3744d97264dd58acd7","value":"Strategy"},{"external_id":"genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8","value":"Mobile"}]}}

  - `items.attributes.external_id` (string)
    一意の属性ID。external_idには、小文字と大文字のラテン英数字、ダッシュ、およびアンダースコアのみが含まれます。
    Example: "attribute_1"

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

  - `items.attributes.values` (array)

  - `items.attributes.values.external_id` (string)
    属性の一意の値ID。external_idには、英小文字、ダッシュ、およびアンダースコアのみが含まれます。
    Example: "attribute_value"

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

  - `items.description` (string)
    ゲームパッケージ説明。
    Example: "Description of the greatest game in the world."

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

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

  - `items.image_url` (string)
    画像URL。
    Example: "https://none"

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

  - `items.name` (string)
    ゲームパッケージ名。
    Example: "The Greatest Game in the World"

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

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

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

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

  - `statusCode` (integer)
    Example: 401