Atualizar cadeia de ofertas

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
offer_chain_id required	integer ID de cadeia de ofertas. Example: 101

Request Body schema: application/json

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

date_start

required

string <date-time>

Data em que a cadeia de ofertas é iniciada.

required

Array of objects

Array

step_number

required

integer >= 1

Número da etapa.

is_free

required

boolean

Indica se a etapa da cadeia de ofertas é gratuita:

Se true, a etapa deve ser resgatada usando a chamada Resgate a etapa da cadeia de oferta gratuita.
Se false, ela deve ser comprada usando a chamada Criar ordem para a etapa da cadeia de ofertas pagas.

required

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 required	integer >= 1 Quantidade da recompensa de itens para esta etapa da cadeia.
order	integer or null >= 0 Ordem de recompensa para a etapa da cadeia de ofertas.

step_id

integer or null >= 1

ID exclusivo da etapa da cadeia. Especifique-o durante a atualização para reter o progresso do usuário para esta etapa.

is_enabled

required

boolean

Array of tipo = string (object) or tipo = number (object) or tipo = data (object) [ 1 .. 100 ] items

Condições para validação de atributos do usuário. Determine a disponibilidade da cadeia com base em se os atributos do usuário correspondem a todas as condições especificadas.

Array ([ 1 .. 100 ] items)

One of:

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	Diferentes

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"

can_be_missing

boolean

Indica que a condição é atendida mesmo se o atributo estiver ausente dos atributos do usuário. Passe true para mostrar o item aos usuários que não têm esse atributo. Os usuários que têm o atributo, mas o valor não corresponder ao especificado na condição, não verão o item. false — os usuários que têm o atributo, mas o valor não corresponder ao especificado na condição, ou o atributo estiver ausente, não verão o item.

date_end

string or null <date-time>

Data em que a cadeia de ofertas termina. Pode ser null. Se date_end for null, a cadeia de ofertas não terá um limite de tempo.

(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

integer

ID exclusivo da cadeia de ofertas.

is_always_visible

boolean

Default: true

Se a cadeia deve ser visível para todos os usuários:

Se true, a cadeia é sempre exibida, independentemente do status de autenticação ou dos atributos do usuário.
Se false, a cadeia é exibida apenas se nenhuma cadeia personalizada for encontrada. Por exemplo, se o usuário não estiver autenticado, ou se seus atributos não corresponderem a nenhuma cadeia personalizada.

Aplica-se somente no contexto de cadeias personalizadas e é usado se a matriz attribute_conditions não for passada.

order

integer

Define a ordem do arranjo.

(interval_type = weekly (object or null)) or (interval_type = monthly (object or null)) or (interval_type = hourly (object or null))

Período de redefinição da cadeia de ofertas.

One of:

Redefinição semanal da cadeia de ofertas.

interval_type required	string Frequência da redefinição da cadeia de ofertas. Value: "weekly"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... A hora em que a cadeia de ofertas é redefinida no fuso horário especificado (arredondamento para horas). Por exemplo, a hora da redefinição é definida como 01:00 para o fuso horário de Kuala Lumpur (GMT+8), o valor do parâmetro `time` é `01:00:00+08:00`.
day_of_week required	integer [ 1 .. 7 ] Dia da semana em que a cadeia de ofertas é redefinida, onde `1` é segunda-feira e `7` é domingo.

Responses

204

A cadeia de ofertas 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

A cadeia de ofertas não foi encontrada.

422

Configuração de cadeia de ofertas inválida.

Request samples

application/json

{"date_end": null,
"date_start": "2023-04-15T18:16:00+05:00",
"description": {"de": "Eine kurze Beschreibung einer regulären Angebotskette",
"en": "A short description of a regular offer chain",
"fr": "Une brève description d'une chaîne d'offres régulière",
"it": "Una breve descrizione di una catena di offerte regolare",
"ru": "Краткое описание обычной цепочки предложений"
},
"is_always_visible": true,
"is_enabled": true,
"name": {"de": "Aktualisierte Angebotskette",
"en": "Updated offer chain",
"fr": "Chaîne d'offres mise à jour",
"it": "Catena di offerte aggiornata",
"ru": "Обновляемая цепочка предложений"
},
"order": 4,
"recurrent_schedule": null,
"steps": [{"is_free": false,
"items": [{"quantity": 2,
"sku": "chain_step_1_paid_bundle_sku"
}
],
"step_id": 10,
"step_number": 1
},
{"is_free": true,
"items": [{"quantity": 1,
"sku": "chain_step_2_free_virtual_good_sku"
}
],
"step_number": 2
},
{"is_free": false,
"items": [{"quantity": 5,
"sku": "chain_step_3_paid_virtual_currency_package_sku"
}
],
"step_number": 3
},
{"is_free": true,
"items": [{"quantity": 1,
"sku": "chain_step_4_free_bundle_sku"
}
],
"step_id": 9,
"step_number": 4
}
]
}

Response samples

application/json

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