Actualizar lote

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

Request Body schema: application/json

Objeto con datos del lote.

sku

required

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

ID único del artículo. El código de un artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.

required

object

Objeto con traducciones para el nombre del artículo. Código de idioma de dos letras minúsculas.

ar	string or null
bg	string or null
cn	string or null
cs	string or null
de	string or null
en	string or null
es	string or null
fr	string or null
he	string or null
it	string or null
ja	string or null
ko	string or null
pl	string or null
pt	string or null
ro	string or null
ru	string or null
th	string or null
tr	string or null
tw	string or null
vi	string or null

required

object

Objeto con traducciones para la descripción del artículo. Código de idioma de dos letras minúsculas.

ar	string or null
bg	string or null
cn	string or null
cs	string or null
de	string or null
en	string or null
es	string or null
fr	string or null
he	string or null
it	string or null
ja	string or null
ko	string or null
pl	string or null
pt	string or null
ro	string or null
ru	string or null
th	string or null
tr	string or null
tw	string or null
vi	string or null

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, 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

Array of objects non-empty

Array (non-empty)

sku required	string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$ ID único del artículo. El código de un artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.
quantity	integer >= 1 Default: 1 Cantidad de los artículos seleccionados en el lote.

custom_attributes

object <json> <= 500 characters

Un objeto JSON que contiene atributos y valores de artículos. Los artículos le permiten añadir más información a los artículos, tal como el nivel requerido del jugador para usar el artículo. Los atributos enriquecen la lógica interna del juego y son accesibles a través de métodos GET y webhooks específicos.

groups

Array of strings

Default: []

Grupos a los que pertenece el artículo.

Nota. El valor de la cadena (string) se refiere al grupo `external_id`.

image_url

string or null

URL de la imagen.

is_enabled

boolean

Default: true

Si está deshabilitado, el artículo no se puede encontrar ni comprar.

is_free

boolean

Default: false

Si es true, el artículo es gratuito.

is_show_in_store

boolean

Default: false

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).

object

Objeto con traducciones para la descripción larga del artículo. Código de idioma de dos letras minúsculas.

ar	string or null
bg	string or null
cn	string or null
cs	string or null
de	string or null
en	string or null
es	string or null
fr	string or null
he	string or null
it	string or null
ja	string or null
ko	string or null
pl	string or null
pt	string or null
ro	string or null
ru	string or null
th	string or null
tr	string or null
tw	string or null
vi	string or null

Array of objects or null

Recursos adicionales del lote.

Array

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

order

integer

Default: 1

Prioridad de orden del lote 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`.

Array of objects

Precios en monedas reales.

Array

amount required	string^\d\.?\d$ Precio del artículo.
currency required	string Divisa del precio del artículo. Código de tres letras según ISO 4217.
is_default required	boolean El precio por defecto se usa para crear un catálogo si no se especifica un precio en la moneda del usuario.
is_enabled required	boolean El precio está habilitado.
country_iso	string or null País en el que está disponible este precio. Código de dos letras según la norma ISO 3166-1 alfa 2.

Array of objects

Array

id	integer >= 1

Array of objects or null

Array

amount required	integer
is_default required	boolean
is_enabled required	boolean
sku	string ID único del artículo. El código de un artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.

Responses

204

El lote 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.

422

Solicitud no válida.

Request samples

application/json

{"attributes": {"attributes": [{"external_id": "class",
"name": {"en-US": "Class"
},
"values": [{"external_id": "soldier",
"value": {"en-US": "Soldier"
}
},
{"external_id": "officer",
"value": {"en-US": "Officer"
}
}
]
}
]
},
"content": [{"quantity": 1,
"sku": "iron_gloves"
},
{"quantity": 1,
"sku": "iron_boots"
},
{"quantity": 1,
"sku": "iron_shield"
},
{"quantity": 1,
"sku": "iron_armour"
},
{"quantity": 1,
"sku": "iron_helmet"
}
],
"custom_attributes": {"purchased": 0,
"type": "lootbox"
},
"description": {"de-DE": "Brustpanzer für Soldaten",
"en-US": "Chest of armour for soldiers"
},
"groups": ["chests"
],
"image_url": "https://picture.bundle-with-many-stuff.png",
"is_enabled": true,
"is_free": true,
"limits": {"per_item": null,
"per_user": null
},
"long_description": {"de-DE": "Brustpanzer für Soldaten",
"en-US": "Chest of armour for soldiers"
},
"media_list": [{"type": "image",
"url": "https://test.com/image0"
},
{"type": "image",
"url": "https://test.com/image1"
}
],
"name": {"de-DE": "Brustpanzer",
"en-US": "Chest of armour"
},
"order": 1,
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"prices": [{"amount": 9.99,
"currency": "USD",
"is_default": true,
"is_enabled": true
},
{"amount": 9.99,
"currency": "EUR",
"is_default": false,
"is_enabled": true
}
],
"sku": "armour_chest",
"vc_prices": null
}

Response samples

application/json

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