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 (cinco letras (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

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

Condiciones para validar los atributos de usuario. Determina la disponibilidad de la cadena en función de si los atributos de usuario cumplen todas las condiciones especificadas.

Array ([ 1 .. 100 ] items)

One of:

attribute

required

string [ 1 .. 255 ] characters ^[-_.\d\w]+$

Código de atributo de usuario.

operator

required

string

Tipo de operación realizada por condición. Para el tipo de atributo string.

Enum:	Description
eq	Igual que
ne	No es igual que

value

required

string <= 255 characters

Valor de la condición con el que se comparará el valor de atributo del usuario. El tipo depende del tipo de atributo.

type

required

string

Tipo de atributo de usuario.

Value: "string"

can_be_missing

boolean

Indica que se cumple la condición aunque falte el atributo en los atributos del usuario. Transmita true para mostrar el elemento a los usuarios que no tengan este atributo. Los usuarios que tengan el atributo, pero el valor no coincida con el especificado en la condición, no verán el artículo. false - Los usuarios que tengan el atributo, pero el valor no coincida con el especificado en la condición, o falte el atributo, no verán el artículo.

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 (cinco letras (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.

is_always_visible

boolean

Default: true

Si todos los usuarios pueden ver la cadena:

Si es true, la cadena aparece siempre, independientemente del estado de autenticación o los atributos del usuario.
Si es false, la cadena aparece solo si no se encuentra ninguna cadena personalizada. Por ejemplo, si el usuario no está autenticado o sus atributos no coinciden con ninguna cadena personalizada.

Solo se aplica en el contexto de cadenas personalizadas y se utiliza si no se transmite la matriz attribute_conditions.

order

integer

Define el orden de disposición.

(interval_type = weekly (object or null)) or (interval_type = monthly (object or null)) or (interval_type = hourly (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": {"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
}