Actualizar cadena de ofertas

project_id required	integer ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto. Example: 44056
offer_chain_id required	integer ID de cadena de ofertas. Example: 101

Request Body schema: application/json

required

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

Objeto con traducciones para la descripción del artículo. Acepta valores en uno de estos dos formatos: códigos de idioma de dos letras en minúscula (p. ej., en) o códigos de idioma de cinco caracteres (p. ej., en-US). Aunque ambos formatos se aceptan como entradas, las respuestas devuelven códigos de idioma de dos letras en minúscula. Cuando se facilitan ambas opciones para el mismo idioma (p. ej. en y en-US), se almacena el último valor proporcionado. Puede consultar la lista completa de idiomas admitidos en la documentación.

One of:

Códigos lingüísticos de dos letras minúsculas.

ar	string or null Árabe
bg	string or null Búlgaro
cn	string or null Chino (simplificado)
cs	string or null Checo
de	string or null Alemán
en	string or null Inglés
es	string or null Español (España)
fr	string or null Francés
he	string or null Hebreo
id	string or null Indonesio
it	string or null Italiano
ja	string or null Japonés
km	string or null Jemer
ko	string or null Coreano
lo	string or null Lao
my	string or null Birmano
ne	string or null Nepalí
ph	string or null Filipino
pl	string or null Polaco
pt	string or null Portugués
ro	string or null Rumano
ru	string or null Ruso
th	string or null Tailandés
tr	string or null Turco
tw	string or null Chino (tradicional)
vi	string or null Vietnamita

date_start

required

string <date-time>

Fecha de inicio de la cadena de ofertas.

required

Array of objects

Array

step_number

required

integer >= 1

Número del paso.

is_free

required

boolean

Indica si el paso de la cadena de ofertas es gratuito:

Si es true, el paso debe reclamarse mediante la llamada Reclamar paso de cadena de ofertas gratuito.
Si es false, debe comprarse mediante la llamada Crear pedido para el paso de cadena de ofertas de pago.

required

Array of objects non-empty

Array (non-empty)

sku required	string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\-–.]*$ ID único del artículo. El SKU solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, puntos, guiones y guiones bajos.
quantity required	integer >= 1 Cantidad del artículo de recompensa para este paso de cadena.
order	integer or null >= 0 Orden de recompensa para el paso de la cadena de ofertas.

step_id

integer or null >= 1

ID único de paso de cadena. Especifíquelo durante la actualización para mantener el progreso del usuario para este paso.

is_enabled

required

boolean

date_end

string or null <date-time>

Fecha en la que finaliza la cadena de ofertas. Puede ser null. Si date_end es null, la cadena de ofertas no tendrá límite de tiempo.

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

Objeto con traducciones para la descripción del artículo. Acepta valores en uno de dos formatos: códigos de idioma de dos letras en minúscula (p. ej., en) o códigos de configuración regional de cinco caracteres (p. ej., en-US). Aunque ambos formatos se aceptan como entradas, las respuestas devuelven códigos de idioma de dos letras en minúscula. Cuando se facilitan ambas opciones para el mismo idioma (p. ej. en y en-US), se almacena el último valor proporcionado. Puede consultar la lista completa de idiomas admitidos en la documentación.

One of:

Códigos lingüísticos de dos letras minúsculas.

ar	string or null Árabe
bg	string or null Búlgaro
cn	string or null Chino (simplificado)
cs	string or null Checo
de	string or null Alemán
en	string or null Inglés
es	string or null Español (España)
fr	string or null Francés
he	string or null Hebreo
id	string or null Indonesio
it	string or null Italiano
ja	string or null Japonés
km	string or null Jemer
ko	string or null Coreano
lo	string or null Lao
my	string or null Birmano
ne	string or null Nepalí
ph	string or null Filipino
pl	string or null Polaco
pt	string or null Portugués
ro	string or null Rumano
ru	string or null Ruso
th	string or null Tailandés
tr	string or null Turco
tw	string or null Chino (tradicional)
vi	string or null Vietnamita

integer

ID único de cadena de ofertas.

order

integer

Define el orden de disposición.

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

Periodo de reinicio de la cadena de ofertas.

One of:

Reinicio semanal de la cadena de ofertas.

interval_type required	string Frecuencia con la que se restablece la cadena de ofertas. Value: "weekly"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... La hora a la que se restablece la cadena de ofertas en la zona horaria especificada (se redondea a la hora). Por ejemplo, la hora de reinicio se establece en 01:00 para la zona horaria de Kuala Lumpur (GMT+8), por lo que el valor del parámetro `time` es `01:00:00+08:00`.
day_of_week required	integer [ 1 .. 7 ] Día de la semana en que se restablece la cadena de ofertas, en cuyo sistema el `1` es lunes y el `7` es domingo.

Responses

204

La cadena de ofertas se ha actualizado correctamente.

401

Autenticación básica no superada o errónea. Asegúrese de haber utilizado la autenticación básica o las credenciales correctas.

404

No se ha encontrado la cadena de ofertas.

422

Configuración de cadena de ofertas no vá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
}