Added output language as configuration property

Author: NikkelM

README.md

@@ -58,6 +58,16 @@ The two letter market codes for which to fetch games. The script will run once f
 | `array` | `["US"]` | `"US"`, `"DZ"`, `"AR"`, `"AU"`, `"AT"`, `"BH"`, `"BD"`, `"BE"`, `"BR"`, `"BG"`, `"CA"`, `"CL"`, `"CN"`, `"CO"`, `"CR"`, `"HR"`, `"CY"`, `"CZ"`, `"DK"`, `"EG"`, `"EE"`, `"FI"`, `"FR"`, `"DE"`, `"GR"`, `"GT"`, `"HK"`, `"HU"`, `"IS"`, `"IN"`, `"ID"`, `"IQ"`, `"IE"`, `"IL"`, `"IT"`, `"JP"`, `"JO"`, `"KZ"`, `"KE"`, `"KW"`, `"LV"`, `"LB"`, `"LI"`, `"LT"`, `"LU"`, `"MY"`, `"MT"`, `"MR"`, `"MX"`, `"MA"`, `"NL"`, `"NZ"`, `"NG"`, `"NO"`, `"OM"`, `"PK"`, `"PE"`, `"PH"`, `"PL"`, `"PT"`, `"QA"`, `"RO"`, `"RU"`, `"SA"`, `"RS"`, `"SG"`, `"SK"`, `"SI"`, `"ZA"`, `"KR"`, `"ES"`, `"SE"`, `"CH"`, `"TW"`, `"TH"`, `"TT"`, `"TN"`, `"TR"`, `"UA"`, `"AE"`, `"GB"`, `"VN"`, `"YE"`, `"LY"`, `"LK"`, `"UY"`, `"VE"`, `"AF"`, `"AX"`, `"AL"`, `"AS"`, `"AO"`, `"AI"`, `"AQ"`, `"AG"`, `"AM"`, `"AW"`, `"BO"`, `"BQ"`, `"BA"`, `"BW"`, `"BV"`, `"IO"`, `"BN"`, `"BF"`, `"BI"`, `"KH"`, `"CM"`, `"CV"`, `"KY"`, `"CF"`, `"TD"`, `"TL"`, `"DJ"`, `"DM"`, `"DO"`, `"EC"`, `"SV"`, `"GQ"`, `"ER"`, `"ET"`, `"FK"`, `"FO"`, `"FJ"`, `"GF"`, `"PF"`, `"TF"`, `"GA"`, `"GM"`, `"GE"`, `"GH"`, `"GI"`, `"GL"`, `"GD"`, `"GP"`, `"GU"`, `"GG"`, `"GN"`, `"GW"`, `"GY"`, `"HT"`, `"HM"`, `"HN"`, `"AZ"`, `"BS"`, `"BB"`, `"BY"`, `"BZ"`, `"BJ"`, `"BM"`, `"BT"`, `"KM"`, `"CG"`, `"CD"`, `"CK"`, `"CX"`, `"CC"`, `"CI"`, `"CW"`, `"JM"`, `"SJ"`, `"JE"`, `"KI"`, `"KG"`, `"LA"`, `"LS"`, `"LR"`, `"MO"`, `"MK"`, `"MG"`, `"MW"`, `"IM"`, `"MH"`, `"MQ"`, `"MU"`, `"YT"`, `"FM"`, `"MD"`, `"MN"`, `"MS"`, `"MZ"`, `"MM"`, `"NA"`, `"NR"`, `"NP"`, `"MV"`, `"ML"`, `"NC"`, `"NI"`, `"NE"`, `"NU"`, `"NF"`, `"PW"`, `"PS"`, `"PA"`, `"PG"`, `"PY"`, `"RE"`, `"RW"`, `"BL"`, `"MF"`, `"WS"`, `"ST"`, `"SN"`, `"MP"`, `"PN"`, `"SX"`, `"SB"`, `"SO"`, `"SC"`, `"SL"`, `"GS"`, `"SH"`, `"KN"`, `"LC"`, `"PM"`, `"VC"`, `"TJ"`, `"TZ"`, `"TG"`, `"TK"`, `"TO"`, `"TM"`, `"TC"`, `"TV"`, `"UM"`, `"UG"`, `"VI"`, `"VG"`, `"WF"`, `"EH"`, `"ZM"`, `"ZW"`, `"UZ"`, `"VU"`, `"SR"`, `"SZ"`, `"AD"`, `"MC"`, `"SM"`, `"ME"`, `"VA"`, `"NEUTRAL"` | Yes, at least one market code. |
 </details>
 
+<details>
+<summary><code>language</code></summary>
+
+The language to use when fetching game properties. Properties such as the game description will be in this language.
+
+| Type | Default value | Possible values | Required |
+| --- | --- | --- | --- |
+| `string` | `en-us` | `"es-ar"`, `"pt-br"`, `"en-ca"`, `"fr-ca"`, `"es-cl"`, `"es-co"`, `"es-mx"`, `"en-us"`, `"nl-be"`, `"fr-be"`, `"cs-cz"`, `"da-dk"`, `"de-de"`, `"es-es"`, `"fr-fr"`, `"en-ie"`, `"it-it"`, `"hu-hu"`, `"nl-nl"`, `"nb-no"`, `"de-at"`, `"pl-pl"`, `"pt-pt"`, `"de-ch"`, `"sk-sk"`, `"fr-ch"`, `"fi-fi"`, `"sv-se"`, `"en-gb"`, `"el-gr"`, `"ru-ru"`, `"en-au"`, `"en-hk"`, `"en-in"`, `"id-id"`, `"en-my"`, `"en-nz"`, `"en-ph"`, `"en-sg"`, `"vi-vn"`, `"th-th"`, `"ko-kr"`, `"zh-cn"`, `"zh-tw"`, `"ja-jp"`, `"zh-hk"`, `"en-za"`, `"tr-tr"`, `"he-il"`, `"ar-ae"`, `"ar-sa"`  | Yes |
+</details>
+
 <details>
 <summary><code>fetchConsole</code></summary>
 

config.default.json

@@ -3,6 +3,7 @@
 	"markets": [
 		"US"
 	],
+	"language": "en-us",
 	"fetchConsole": true,
 	"fetchPC": true,
 	"fetchEAPlay": true,

config.schema.json

@@ -267,6 +267,64 @@
 			"additionalItems": false,
 			"uniqueItems": true
 		},
+		"language": {
+			"description": "The language to use when fetching game properties. Properties such as the game description will be in this language.",
+			"type": "string",
+			"default": "en-us",
+			"enum": [
+				"es-ar",
+				"pt-br",
+				"en-ca",
+				"fr-ca",
+				"es-cl",
+				"es-co",
+				"es-mx",
+				"en-us",
+				"nl-be",
+				"fr-be",
+				"cs-cz",
+				"da-dk",
+				"de-de",
+				"es-es",
+				"fr-fr",
+				"en-ie",
+				"it-it",
+				"hu-hu",
+				"nl-nl",
+				"nb-no",
+				"de-at",
+				"pl-pl",
+				"pt-pt",
+				"de-ch",
+				"sk-sk",
+				"fr-ch",
+				"fi-fi",
+				"sv-se",
+				"en-gb",
+				"el-gr",
+				"ru-ru",
+				"en-au",
+				"en-hk",
+				"en-in",
+				"id-id",
+				"en-my",
+				"en-nz",
+				"en-ph",
+				"en-sg",
+				"vi-vn",
+				"th-th",
+				"ko-kr",
+				"zh-cn",
+				"zh-tw",
+				"ja-jp",
+				"zh-hk",
+				"en-za",
+				"tr-tr",
+				"he-il",
+				"ar-ae",
+				"ar-sa"
+			]
+		},
 		"fetchConsole": {
 			"description": "Whether or not to fetch games available for console Game Pass.",
 			"type": "boolean",
@@ -622,6 +680,7 @@
 	],
 	"required": [
 		"markets",
+		"language",
 		"outputFormat",
 		"includedProperties"
 	],

index.js

@@ -101,7 +101,7 @@ async function fetchGameIDs(passType, market) {
 	}
 
 	console.log(`Fetching ${passType} Game Pass game ID's for market "${market}"...`);
-	let gameIds = await fetch(`https://catalog.gamepass.com/sigls/v2?id=${APIIds[passType]}&language=en-us&market=${market}`)
+	let gameIds = await fetch(`https://catalog.gamepass.com/sigls/v2?id=${APIIds[passType]}&language=${CONFIG.language}&market=${market}`)
 		.then((response) => response.json())
 		.then((data) => data.filter((entry) => entry.id).map((entry) => entry.id));
 
@@ -110,7 +110,7 @@ async function fetchGameIDs(passType, market) {
 
 async function fetchGameProperties(gameIds, passType, market) {
 	console.log(`Fetching game properties for ${gameIds.length} ${passType} games for market "${market}"...`);
-	return await fetch(`https://displaycatalog.mp.microsoft.com/v7.0/products?bigIds=${gameIds}&market=${market}&languages=en-us`)
+	return await fetch(`https://displaycatalog.mp.microsoft.com/v7.0/products?bigIds=${gameIds}&market=${market}&languages=${CONFIG.language}`)
 		.then((response) => response.json())
 		.then((data) => {
 			if (CONFIG.keepCompleteProperties) {

package-lock.json

@@ -1,7 +1,7 @@
 {
 	"name": "game-pass-api",
 	"type": "module",
-	"version": "1.0.0",
+	"version": "1.0.1",
 	"description": "",
 	"main": "index.js",
 	"dependencies": {