ゲームリストを取得する

get/v2/project/{project_id}/items/game

カタログを作成するためのゲームリストを取得します。

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

SecurityAuthForClient

Request

path Parameters

project_id

required

integer

プロジェクトID。

Example: 44056

query Parameters

limit	integer ページにある要素数の制限。 Example: limit=50
offset	integer リストが生成される要素の番号（0からカウントされる）。 Example: offset=0
locale	string Default: "en" 応答言語。ISO639-1に準拠した2文字の小文字の言語コード。
additional_fields[]	Array of strings 追加フィールドのリスト。これらのフィールドは、リクエストで送信した場合、応答に含まれます。利用可能なフィールド`media_list`、`order`、`long_description`です。
country	string Default: "US" カタログの地域別価格と制限を計算するための国。ISO 3166-1 alpha-2に準拠した2文字の大文字の国コードです。国を明示的に指定しない場合は、ユーザーのIPアドレスに基づいて計算されます。

Responses

200

ゲームリストは正常に受信されました。

Request samples

Response samples

application/json

{"items": [{"attributes": {"$ref": "#/components/examples/client-attribute-game/Catalog_value"
},
"description": "Game description",
"groups": [{"external_id": "all",
"name": "All games"
},
{"external_id": "Xsolla",
"name": "Xsolla games"
}
],
"image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
"name": "Game name",
"sku": "game_1",
"type": "unit",
"unit_items": [{"drm_name": "Steam",
"drm_sku": "steam",
"has_keys": true,
"is_free": false,
"is_pre_order": true,
"price": {"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"release_date": "2020-08-11T10:00:00+03:00",
"sku": "game_key_01",
"type": "game_key",
"virtual_prices": [ ]
},
{"drm_name": "Origin",
"drm_sku": "origin",
"has_keys": false,
"is_free": false,
"is_pre_order": false,
"price": {"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"sku": "game_key_02",
"type": "game_key",
"virtual_prices": [ ]
}
],
"unit_type": "game"
},
{"attributes": [{"external_id": "OS",
"name": "OS",
"values": [{"external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723",
"value": "Windows"
}
]
}
],
"description": "Game description",
"groups": [{"external_id": "all",
"name": "All games"
}
],
"image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
"name": "Game name",
"sku": "game_2",
"type": "unit",
"unit_items": [{"drm_name": "Steam",
"drm_sku": "steam",
"has_keys": false,
"is_free": false,
"is_pre_order": false,
"price": {"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"sku": "game_key_01",
"type": "game_key",
"virtual_prices": [ ]
}
],
"unit_type": "game"
}
]
}