Xsolla-logo

Atualizar promoção de item

put/v2/project/{project_id}/admin/promotion/{promotion_id}/item

Atualiza a promoção.

Observação

Novos dados substituirão dados antigos. Se você quiser atualizar apenas uma parte de uma promoção, você deve transferir todos os dados necessários na solicitação também.

As promoções oferecem um desconto (%) nos itens. O desconto será aplicado a todos os preços dos itens especificados.

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
promotion_id
required
integer

ID de promoção. Identificador exclusivo da promoção dentro do projeto.

Example: 111425
Request Body schema: application/json

Objeto com dados de promoção.

required
Array of objects
Array
sku
required
string
Default: "elven_sword"

SKU do item.

required
object
percent
required
string

Percentual de desconto. O preço do item será diminuído usando um valor calculado usando essa porcentagem e, em seguida, arredondado para 2 casas decimais.

required
object

Nome da promoção. Deve conter pares chave/valor, onde chave é a localidade com o formato "^[a-z]{2}-[A-Z]{2}$", e o valor é uma cadeia de caracteres.

property name*
additional property
string
Array of tipo = string (objects) or Array of tipo = data (objects) or Array of tipo = number (objects)
One of:

Condições que são comparadas aos valores de atributo do usuário. Devem estar reunidas todas as condições para que a ação entre em efeito.

[ 1 .. 100 ] items
Array ([ 1 .. 100 ] items)
attribute
required
string [ 1 .. 255 ] characters ^[-_.\\d\\w]+$

Código de atributo do usuário.

operator
required
string

Tipo de operação realizada por condição. Para o tipo de atributo string.

Enum: Description
eq

Iguais

ne

Não são iguais

value
required
string <= 255 characters

Valor da condição com o qual o valor do atributo do usuário será comparado. O tipo depende do tipo de atributo.

type
required
string

Tipo de atributo de usuário.

Value: "string"
date_end
string or null <date-time>
Default: "2020-04-15T18:16:00+05:00"

Data em que sua promoção será concluída. Pode ser null.

date_start
string or null <date-time>
Default: "2020-04-15T18:16:00+05:00"

Data em que sua promoção será iniciada.

object

Limites da promoção.

per_user
integer or null

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

object or null

Limite o período de atualização.

interval_type = daily (object) or interval_type = weekly (object) or interval_type = monthly (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).

Responses
204

A promoção foi atualizada 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

Promoção não encontrada. Certifique-se de que promotion_id está correto.

422

Solicitação inválida.

Request samples
application/json
{
  • "attribute_conditions": [
    ],
  • "date_end": "2020-04-25T18:16:00+05:00",
  • "date_start": "2020-04-15T18:16:00+05:00",
  • "discount": {
    },
  • "items": [
    ],
  • "name": {
    }
}
Response samples
application/json
{
  • "errorCode": 1020,
  • "errorMessage": "[0401-1020]: Error in Authentication method occurred",
  • "statusCode": 401
}