Actualizar juego por SKU

Xsolla Developers

A Cuenta del editor

Actualizar juego por SKUServer-sideAdmin

put/v2/project/{project_id}/admin/items/game/sku/{item_sku}

Actualiza un juego en el proyecto por SKU.

SecuritybasicAuth

Request

path Parameters

project_id required	integer ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto. Example: 44056
item_sku required	string Código (SKU) del artículo. Example: booster_mega_1

Request Body schema: application/json

Objeto con datos del juego.

sku

required

string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\-–.]*$

ID único del artículo. El SKU solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, puntos, guiones y guiones bajos.

required

(two-letter (object or null)) or (five-letter (object or null))

Objeto con traducciones para la descripción del artículo. Acepta valores en uno de estos dos formatos: códigos de idioma de dos letras en minúscula (p. ej., en) o códigos de idioma de cinco caracteres (p. ej., en-US). Aunque ambos formatos se aceptan como entradas, las respuestas devuelven códigos de idioma de dos letras en minúscula. Cuando se facilitan ambas opciones para el mismo idioma (p. ej. en y en-US), se almacena el último valor proporcionado. Puede consultar la lista completa de idiomas admitidos en la documentación.

One of:

Códigos lingüísticos de dos letras minúsculas.

ar	string or null Árabe
bg	string or null Búlgaro
cn	string or null Chino (simplificado)
cs	string or null Checo
de	string or null Alemán
en	string or null Inglés
es	string or null Español (España)
fr	string or null Francés
he	string or null Hebreo
id	string or null Indonesio
it	string or null Italiano
ja	string or null Japonés
km	string or null Jemer
ko	string or null Coreano
lo	string or null Lao
my	string or null Birmano
ne	string or null Nepalí
ph	string or null Filipino
pl	string or null Polaco
pt	string or null Portugués
ro	string or null Rumano
ru	string or null Ruso
th	string or null Tailandés
tr	string or null Turco
tw	string or null Chino (tradicional)
vi	string or null Vietnamita

required

Array of objects

Claves del juego para diferentes DRM (gestión de derechos digitales).

Array

sku

required

string [ 1 .. 255 ] characters

ID único del artículo. El SKU solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, puntos, guiones y guiones bajos.

drm_sku

required

string

ID único del DRM.

required

Array of objects

Precios en monedas reales.

Array

amount required	number
currency required	string Divisa del precio del artículo. Código de tres letras según ISO 4217. Consulte la documentación para obtener información detallada sobre monedas soportadas por Xsolla.
is_default required	boolean El precio por defecto se utiliza para generar el catálogo si no se especifica el precio en la moneda del usuario.
is_enabled required	boolean

Array of objects

Lista de atributos.

Array

external_id

required

string [ 1 .. 255 ] characters ^[a-zA-Z0-9-_]+$

ID único del atributo. external_id solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, guiones y guiones bajos.

required

Array of objects

Array

required

object

Default: {"de":"Strategie","en":"Strategy"}

Objeto con traducciones del nombre del valor. Las claves se especifican en la norma ISO 3166-1.

property name*

additional property

string

external_id

required

string [ 1 .. 255 ] characters ^[-_.\d\w]+$

ID del valor único para un atributo. external_id solo puede contener caracteres alfanuméricos latinos en minúsculas, guiones y guiones bajos.

object

Default: {"de":"Genre","en":"Genre"}

Objeto con traducciones para el nombre del atributo. Las claves se especifican en la norma ISO 3166-1.

property name*

additional property

string

Array of objects

Grupos a los que pertenece el artículo.

Array

external_id

required

string

is_enabled

boolean

Si se deshabilita, el artículo no se puede comprar ni se puede acceder a este a través del inventario.

is_free

boolean

Default: false

Si es true, el artículo es gratuito.

is_show_in_store

boolean

El artículo está disponible para la compra.

object

Límites del artículo.

per_item

integer or null

Limitación global de artículos.

per_user

integer or null

Limitación de artículos para un usuario independiente.

object or null

Periodo de actualización del límite.

interval_type = daily (object) or interval_type = weekly (object) or interval_type = monthly (object)

One of:

Tipo diario de actualización del límite del usuario.

interval_type required	string Periodo de actualización recurrente. Value: "daily"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... Hora de actualización del límite en la zona horaria deseada (redondeo a horas).

(two-letter (object or null)) or (five-letter (object or null))

One of:

Códigos lingüísticos de dos letras minúsculas.

ar	string or null Árabe
bg	string or null Búlgaro
cn	string or null Chino (simplificado)
cs	string or null Checo
de	string or null Alemán
en	string or null Inglés
es	string or null Español (España)
fr	string or null Francés
he	string or null Hebreo
id	string or null Indonesio
it	string or null Italiano
ja	string or null Japonés
km	string or null Jemer
ko	string or null Coreano
lo	string or null Lao
my	string or null Birmano
ne	string or null Nepalí
ph	string or null Filipino
pl	string or null Polaco
pt	string or null Portugués
ro	string or null Rumano
ru	string or null Ruso
th	string or null Tailandés
tr	string or null Turco
tw	string or null Chino (tradicional)
vi	string or null Vietnamita

order

integer

Prioridad de orden del juego en la lista.

Array of objects or null

Periodo de venta del artículo.

Array

date_from	string <date-time> Fecha en la que el artículo especificado estará disponible para la venta.
date_until	string or null <date-time> Fecha en la que el artículo especificado dejará de estar disponible para la venta. Puede ser `null`.

object

Configuración del pedido por anticipado.

release_date required	string Fecha de lanzamiento de la clave del juego en formato ISO 8601.
is_enabled required	boolean Si está deshabilitada, el artículo no es un pedido por anticipado.
description	string Información adicional para el pedido por anticipado, que se enviará por correo electrónico.

Array of objects

Array

integer

Array of objects

Array

amount required	number
is_default required	boolean
is_enabled required	boolean
sku	string ID único del artículo. El SKU solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, puntos, guiones y guiones bajos.

Array of objects <= 20 items

Lista de atributos.

Atención. No puede especificar más de 20 atributos para el artículo. Cualquier intento de superar el límite provocará un error.

Array (<= 20 items)

external_id

required

string [ 1 .. 255 ] characters ^[a-zA-Z0-9-_]+$

ID único del atributo. external_id solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, guiones y guiones bajos.

required

Array of objects

Atención. No puede crear más de 6 valores para cada atributo. Cualquier intento de exceder el límite resultará en un error.

Array

required

object

Default: {"de":"Strategie","en":"Strategy"}

Objeto con traducciones del nombre del valor. Las claves se especifican en la norma ISO 3166-1.

property name*

additional property

string

external_id

required

string [ 1 .. 255 ] characters ^[-_.\d\w]+$

ID del valor único para un atributo. external_id solo puede contener caracteres alfanuméricos latinos en minúsculas, guiones y guiones bajos.

object

Default: {"de":"Genre","en":"Genre"}

Objeto con traducciones para el nombre del atributo. Las claves se especifican en la norma ISO 3166-1.

property name*

additional property

string

(two-letter (object or null)) or (five-letter (object or null))

Objeto con traducciones para la descripción del artículo. Acepta valores en uno de dos formatos: códigos de idioma de dos letras en minúscula (p. ej., en) o códigos de configuración regional de cinco caracteres (p. ej., en-US). Aunque ambos formatos se aceptan como entradas, las respuestas devuelven códigos de idioma de dos letras en minúscula. Cuando se facilitan ambas opciones para el mismo idioma (p. ej. en y en-US), se almacena el último valor proporcionado. Puede consultar la lista completa de idiomas admitidos en la documentación.

One of:

Códigos lingüísticos de dos letras minúsculas.

ar	string or null Árabe
bg	string or null Búlgaro
cn	string or null Chino (simplificado)
cs	string or null Checo
de	string or null Alemán
en	string or null Inglés
es	string or null Español (España)
fr	string or null Francés
he	string or null Hebreo
id	string or null Indonesio
it	string or null Italiano
ja	string or null Japonés
km	string or null Jemer
ko	string or null Coreano
lo	string or null Lao
my	string or null Birmano
ne	string or null Nepalí
ph	string or null Filipino
pl	string or null Polaco
pt	string or null Portugués
ro	string or null Rumano
ru	string or null Ruso
th	string or null Tailandés
tr	string or null Turco
tw	string or null Chino (tradicional)
vi	string or null Vietnamita

Array of objects

Grupos a los que pertenece el artículo.

Array

external_id

required

string

image_url

string

URL de la imagen.

is_enabled

boolean

Si se deshabilita, el artículo no se puede comprar ni se puede acceder a este a través del inventario.

is_show_in_store

boolean

El artículo está disponible para la compra.

(two-letter (object or null)) or (five-letter (object or null))

Objeto con traducciones para la descripción larga del artículo. Acepta valores en uno de estos dos formatos: códigos de idioma de dos letras en minúscula (p. ej., en) o códigos de configuración regional de cinco caracteres (p. ej., en-US). Aunque ambos formatos se aceptan como entradas, las respuestas devuelven códigos de idioma de dos letras en minúscula. Cuando se facilitan ambas opciones para el mismo idioma (p. ej. en y en-US), se almacena el último valor proporcionado. Puede consultar la lista completa de idiomas admitidos en la documentación.

Any of:

Códigos lingüísticos de dos letras minúsculas.

ar	string or null Árabe
bg	string or null Búlgaro
cn	string or null Chino (simplificado)
cs	string or null Checo
de	string or null Alemán
en	string or null Inglés
es	string or null Español (España)
fr	string or null Francés
he	string or null Hebreo
id	string or null Indonesio
it	string or null Italiano
ja	string or null Japonés
km	string or null Jemer
ko	string or null Coreano
lo	string or null Lao
my	string or null Birmano
ne	string or null Nepalí
ph	string or null Filipino
pl	string or null Polaco
pt	string or null Portugués
ro	string or null Rumano
ru	string or null Ruso
th	string or null Tailandés
tr	string or null Turco
tw	string or null Chino (tradicional)
vi	string or null Vietnamita

Array of objects

Recursos adicionales del juego, como capturas de pantalla, vídeos de partidas del juego, etc.

Array

type	string Tipo de soporte multimedia: `image`/`video`. Enum: "image" "video"
url	string Archivo de recurso.

order

integer

Prioridad de orden del juego en la lista.

Responses

201

El juego se actualizó correctamente.

401

Autenticación básica no superada o errónea. Asegúrese de haber utilizado la autenticación básica o las credenciales correctas.

404

Juego no encontrado.

422

Solicitud no válida.

Request samples

application/json

{"description": {"en-US": "Game description",
"ru-RU": "Краткое описание игры"
},
"groups": ["new_games"
],
"image_url": "http://image.png",
"is_enabled": true,
"is_show_in_store": true,
"long_description": {"en-US": "Game long description",
"ru-RU": "Полное описание игры"
},
"media_list": [{"type": "image",
"url": "http://image.png"
},
{"type": "video",
"url": "http://video.png"
}
],
"name": {"en-US": "Game name",
"ru-RU": "Название игры"
},
"sku": "com.xsolla.game_1",
"unit_items": [{"drm_sku": "steam_key_1",
"is_enabled": true,
"is_free": false,
"is_show_in_store": true,
"limits": {"per_item": {"available": 5000,
"reserved": 500,
"sold": 4500,
"total": 10000
},
"per_user": {"total": 5
}
},
"name": {"en-US": "Game key name",
"ru-RU": "Название игрового ключа"
},
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"pre_order": {"description": "Some description",
"is_enabled": true,
"release_date": "2020-08-11T10:00:00+03:00"
},
"prices": [{"amount": 35.5,
"currency": "USD",
"is_default": true,
"is_enabled": true
}
],
"regions": [{"id": 12
},
{"id": 64
}
],
"sku": "com.xsolla.game_key_1",
"vc_prices": [{"amount": 35.5,
"is_default": true,
"is_enabled": true,
"sku": "com.xsolla.gold_1"
}
]
}
]
}

Response samples

application/json

{"errorCode": 1020,
"errorMessage": "[0401-1020]: Error in Authentication method occurred",
"statusCode": 401
}