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

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.

order

integer

Define a ordem do arranjo.

(interval_type = semanal (object or null)) or (interval_type = mensal (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": {"en": "Updated offer chain description"
},
"is_enabled": true,
"name": {"en": "Updated offer chain",
"ru": "Обновленная цепочка товаров"
},
"order": 4,
"steps": [{"is_free": false,
"items": [{"quantity": 1,
"sku": "vg_enabled_shown_in_store_1"
}
],
"step_number": 1
},
{"is_free": false,
"items": [{"quantity": 1,
"sku": "vg_enabled_shown_in_store_2"
}
],
"step_number": 2
},
{"is_free": true,
"items": [{"quantity": 1,
"sku": "vg_not_shown_in_store"
}
],
"step_id": 10,
"step_number": 3
},
{"is_free": false,
"items": [{"quantity": 1,
"sku": "bundle_enabled_shown_in_store_with_2_enabled_shown_in_store_vg"
}
],
"step_id": 8,
"step_number": 4
},
{"is_free": true,
"items": [{"quantity": 1,
"sku": "vcp_enabled_shown_in_store_1_of_10_vc_enabled_shown_in_store_1"
}
],
"step_number": 5
}
]
}

Response samples

application/json

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