Xsolla-logoXsolla Developers
ou
Conta de Distribuidor

Conjunto de atualizaçãoServer-sideAdmin

put/v2/project/{project_id}/admin/items/bundle/sku/{sku}

Atualiza um conjunto.

SecuritybasicAuth
Request
path Parameters
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
sku
required
string

SKU de conjunto.

Example: kg_1
Request Body schema: application/json

Objeto com dados de conjunto.

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
(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 <= 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
Array of objects non-empty
Array (non-empty)
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.

quantity
integer >= 1
Default: 1

Quantidade dos itens selecionados no conjunto.

custom_attributes
object <json> <= 500 characters

Um objeto JSON que contém atributos e valores de item. Os atributos permitem que você adicione mais informações a itens como o nível necessário do jogador para usar o item. Os atributos enriquecem a lógica interna do seu jogo e são acessíveis através de métodos GET e webhooks dedicados.

groups
Array of strings
Default: []

Grupos aos quais o item pertence.

Observação: o valor da cadeia de caracteres refere-se ao grupo `external_id`.
image_url
string or null

URL da imagem.

is_enabled
boolean
Default: true

Se estiver desativado, o item não poderá ser encontrado nem comprado.

is_free
boolean
Default: false

Se true, o item é gratuito.

is_show_in_store
boolean
Default: false

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

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 or null

Ativos adicionais do conjunto.

Array
type
string

Tipo de mídia: image/video.

Enum: "image" "video"
url
string

Arquivo de recurso.

order
integer
Default: 1

Prioridade de pedido do conjunto 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.

Array of objects

Preços em moedas reais.

Array
amount
required
string^\d*\.?\d*$

Preço do item.

currency
required
string

Moeda do preço do item. Código de três letras de acordo com a ISO 4217.

is_default
required
boolean

O preço padrão é usado para criar um catálogo se nenhum preço na moeda do usuário for especificado.

is_enabled
required
boolean

O preço está habilitado.

country_iso
string or null

País onde este preço está disponível. Código de duas letras de acordo com o padrão ISO 3166-1 alpha 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 de item exclusivo. O SKU só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, pontos, traços e sublinhados.

Responses
204

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

422

Solicitação inválida.

Request samples
application/json
{
  • "attributes": [
    ],
  • "content": [
    ],
  • "custom_attributes": {
    },
  • "description": {
    },
  • "groups": [
    ],
  • "is_enabled": true,
  • "is_free": true,
  • "limits": {
    },
  • "long_description": {
    },
  • "media_list": [],
  • "name": {
    },
  • "order": 1,
  • "periods": [
    ],
  • "prices": [
    ],
  • "sku": "com.xsolla.armour_chest_1",
  • "vc_prices": [ ]
}
Response samples
application/json
{
  • "errorCode": 1020,
  • "errorMessage": "[0401-1020]: Error in Authentication method occurred",
  • "statusCode": 401
}