Atualizar jogo por ID

project_id required	integer ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto. Example: 44056
item_id required	string ID do item. Example: 656

Request Body schema: application/json

Objeto com dados de jogo.

sku

required

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

ID de item exclusivo. O SKU só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, pontos, traços e sublinhados.

required

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

Objeto com traduções para o nome do item. Aceita valores em um dos dois formatos: códigos de idioma minúsculos de duas letras (por exemplo, en) ou códigos de idioma de cinco caracteres (por exemplo, en-US). Embora ambos os formatos sejam aceitos, as respostas retornam códigos de idioma minúsculos de duas letras. Quando ambas as opções para o mesmo idioma são fornecidas (por exemplo, en e en-US), o último valor fornecido é armazenado. Você pode encontrar a lista completa de idiomas suportados na documentação.

One of:

Códigos de idioma minúsculos de duas letras.

ar	string or null Árabe
bg	string or null Búlgaro
cn	string or null Chinês (Simplificado)
cs	string or null Tcheco
de	string or null Alemão
en	string or null Inglês
es	string or null Espanhol (Espanha)
fr	string or null Francês
he	string or null Hebraico
id	string or null Indonésio
it	string or null Italiano
ja	string or null Japonês
km	string or null Khmer
ko	string or null Coreano
lo	string or null Lao
my	string or null Birmanês
ne	string or null Nepalês
ph	string or null Filipino
pl	string or null Polonês
pt	string or null Português
ro	string or null Romeno
ru	string or null Russo
th	string or null Tailandês
tr	string or null Turco
tw	string or null Chinês (Tradicional)
vi	string or null Vietnamita

required

Array of objects

Chaves de jogo para diferentes DRMs.

Array

sku

required

string [ 1 .. 255 ] characters

ID de item exclusivo. O SKU só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, pontos, traços e sublinhados.

drm_sku

required

string

ID de DRM exclusivo.

required

Array of objects

Preços em moedas reais.

Array

amount required	number
currency required	string Moeda do preço do item. Código de três letras de acordo com a ISO 4217. Consulte a documentação para obter informações detalhadas sobre as moedas suportadas pelo Xsolla.
is_default required	boolean O preço padrão é usado para criar o catálogo se nenhum preço for especificado na moeda do usuário.
is_enabled required	boolean

Array of objects

Lista de atributos.

Array

external_id

required

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

ID de atributo exclusivo. O external_id só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, traços e sublinhados.

required

Array of objects

Array

required

object

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

Objeto com traduções do nome do valor. As chaves são especificadas no formato ISO 3166-1.

property name*

additional property

string

external_id

required

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

ID de valor exclusivo para um atributo. O external_id pode conter apenas caracteres alfanuméricos latinos minúsculos, traços e sublinhados.

object

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

Objeto com localizações para o nome do atributo. As chaves são especificadas no formato ISO 3166-1.

property name*

additional property

string

Array of objects

Grupo aos quais o item pertence.

Array

external_id

required

string

is_enabled

boolean

Se desabilitado, o item não poderá ser comprado nem acessado pelo inventário.

is_free

boolean

Default: false

Se true, o item é gratuito.

is_show_in_store

boolean

O item está disponível para compra.

object

Limites de itens.

per_item

integer or null

Limitação global de itens.

per_user

integer or null

Limitação de item para um usuário separado.

object or null

Limite o período de atualização.

interval_type = daily (object) or interval_type = semanal (object) or interval_type = mensal (object)

One of:

Tipo diário de atualização de limites de usuário.

interval_type required	string Período de atualização recorrente. Value: "daily"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... Tempo de atualização do limite no fuso horário desejado (arredondamento para horas).

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

One of:

Códigos de idioma minúsculos de duas letras.

ar	string or null Árabe
bg	string or null Búlgaro
cn	string or null Chinês (Simplificado)
cs	string or null Tcheco
de	string or null Alemão
en	string or null Inglês
es	string or null Espanhol (Espanha)
fr	string or null Francês
he	string or null Hebraico
id	string or null Indonésio
it	string or null Italiano
ja	string or null Japonês
km	string or null Khmer
ko	string or null Coreano
lo	string or null Lao
my	string or null Birmanês
ne	string or null Nepalês
ph	string or null Filipino
pl	string or null Polonês
pt	string or null Português
ro	string or null Romeno
ru	string or null Russo
th	string or null Tailandês
tr	string or null Turco
tw	string or null Chinês (Tradicional)
vi	string or null Vietnamita

order

integer

Prioridade da ordem de jogos na lista.

Array of objects or null

Período de venda de itens.

Array

date_from	string <date-time> Data em que o item especificado estará disponível para venda.
date_until	string or null <date-time> Data em que o item especificado ficará indisponível para venda. Pode ser `null`.

object

Configurações de pré-venda.

release_date required	string Data de lançamento da chave de jogo no formato ISO 8601.
is_enabled required	boolean Se desabilitado, o item não é uma pré-venda.
description	string Informações adicionais para a pré-venda, que serão enviadas por e-mail.

Array of objects

Array

integer

Array of objects

Array

amount required	number
is_default required	boolean
is_enabled required	boolean
sku	string ID de item exclusivo. O SKU só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, pontos, traços e sublinhados.

Array of objects <= 20 items

Lista de atributos.

Atenção. Não é possível especificar mais de 20 atributos para o item. Qualquer tentativa de exceder o limite resulta em um erro.

Array (<= 20 items)

external_id

required

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

ID de atributo exclusivo. O external_id só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, traços e sublinhados.

required

Array of objects

Atenção. Não é possível criar mais de 6 valores para cada atributo. Qualquer tentativa de exceder o limite resulta em um erro.

Array

required

object

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

Objeto com traduções do nome do valor. As chaves são especificadas no formato ISO 3166-1.

property name*

additional property

string

external_id

required

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

ID de valor exclusivo para um atributo. O external_id pode conter apenas caracteres alfanuméricos latinos minúsculos, traços e sublinhados.

object

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

Objeto com localizações para o nome do atributo. As chaves são especificadas no formato ISO 3166-1.

property name*

additional property

string

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

Objeto com traduções para a descrição do item. Aceita valores em um dos dois formatos: códigos de idioma minúsculos de duas letras (por exemplo, en) ou códigos de localidade de cinco caracteres (por exemplo, en-US). Embora ambos os formatos sejam aceitos, as respostas retornam códigos de idioma minúsculos de duas letras. Quando ambas as opções para o mesmo idioma são fornecidas (por exemplo, en e en-US), o último valor fornecido é armazenado. Você pode encontrar a lista completa de idiomas suportados na documentação.

One of:

Códigos de idioma minúsculos de duas letras.

ar	string or null Árabe
bg	string or null Búlgaro
cn	string or null Chinês (Simplificado)
cs	string or null Tcheco
de	string or null Alemão
en	string or null Inglês
es	string or null Espanhol (Espanha)
fr	string or null Francês
he	string or null Hebraico
id	string or null Indonésio
it	string or null Italiano
ja	string or null Japonês
km	string or null Khmer
ko	string or null Coreano
lo	string or null Lao
my	string or null Birmanês
ne	string or null Nepalês
ph	string or null Filipino
pl	string or null Polonês
pt	string or null Português
ro	string or null Romeno
ru	string or null Russo
th	string or null Tailandês
tr	string or null Turco
tw	string or null Chinês (Tradicional)
vi	string or null Vietnamita

Array of objects

Grupo aos quais o item pertence.

Array

external_id

required

string

image_url

string

URL da imagem.

is_enabled

boolean

Se desabilitado, o item não poderá ser comprado nem acessado pelo inventário.

is_show_in_store

boolean

O item está disponível para compra.

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

Objeto com traduções para a descrição longa do item. Aceita valores em um dos dois formatos: códigos de idioma minúsculos de duas letras (por exemplo, en) ou códigos de localidade de cinco caracteres (por exemplo, en-US). Embora ambos os formatos sejam aceitos, as respostas retornam códigos de idioma minúsculos de duas letras. Quando ambas as variantes para o mesmo idioma são fornecidas (por exemplo, en e en-US), o último valor fornecido é armazenado. Você pode encontrar a lista completa de idiomas suportados na documentação.

Any of:

Códigos de idioma minúsculos de duas letras.

ar	string or null Árabe
bg	string or null Búlgaro
cn	string or null Chinês (Simplificado)
cs	string or null Tcheco
de	string or null Alemão
en	string or null Inglês
es	string or null Espanhol (Espanha)
fr	string or null Francês
he	string or null Hebraico
id	string or null Indonésio
it	string or null Italiano
ja	string or null Japonês
km	string or null Khmer
ko	string or null Coreano
lo	string or null Lao
my	string or null Birmanês
ne	string or null Nepalês
ph	string or null Filipino
pl	string or null Polonês
pt	string or null Português
ro	string or null Romeno
ru	string or null Russo
th	string or null Tailandês
tr	string or null Turco
tw	string or null Chinês (Tradicional)
vi	string or null Vietnamita

Array of objects

Recursos adicionais do jogo, como capturas de tela, vídeo de jogabilidade, etc.

Array

type	string Tipo de mídia: `image`/`video`. Enum: "image" "video"
url	string Arquivo de recurso.

order

integer

Prioridade da ordem de jogos na lista.

Responses

201

O jogo foi atualizado com sucesso.

401

Autenticação básica não aprovada ou errada. Verifique se você usou a autenticação básica ou as credenciais corretas.

404

Jogo não encontrado.

422

Solicitação invá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
}