Limitando o tempo de exibição de itens na loja
Você pode definir o período de exibição de um item na loja para:
- manter a relevância do catálogo em um determinado momento, por exemplo, durante as vendas de fim de ano
сriar um item com antecedência sem exibi-lo no catálogo
- conjuntos
- chaves de jogo
- Chamadas de API Criar conjunto ou Atualizar conjunto para conjuntos
Chamada de API Criar jogo, Atualizar jogo por SKU ou Atualizar jogo por ID para chaves de jogo
periods[0].date_from
com a data e hora do início do período de exibição do item no formatoYYYY-MM-DDThh:mm:ss±TMZ
, ondeTMZ
é o indicador de fuso horário no formato GMThh:mm
.periods[0].date_until
com a data e hora do final do período de exibição do item no formatoYYYY-MM-DDThh:mm:ss±TMZ
, ondeTMZ
é o indicador de fuso horário no formato GMThh:mm
. Para não indicar o final do período de exibição de um item, passenull
.
Você pode configurar vários períodos para exibir um item na loja. Para fazer isso, passe uma matriz de objetos com as datas de início e término de todos os períodos nas chamadas de API.
Exemplo:
"periods": [
{
"date_from": "2022-06-10T14:00:00+03:00",
"date_until": "2022-06-30T14:00:00+03:00"
},
{
"date_from": "2022-07-10T14:00:00+03:00",
"date_until": "2022-07-30T14:00:00+03:00"
},
{
"date_from": "2022-08-10T14:00:00+03:00",
"date_until": "2022-08-30T14:00:00+03:00"
}
]
Os métodos de obtenção de catálogo retornam os itens que estão disponíveis na loja no momento da solicitação. Para obter informações sobre itens cujo período de exibição ainda não começaram ou já expiraram, passe o parâmetro show_inactive_time_limited_items com um valor 1
ao solicitar o catálogo.
Os limites de tempo de exibição de item não são contabilizados dentro de um conjunto.
EXEMPLO
- Você cria um item virtual
Booster e define seu período de exibição de 29 de outubro até 15 de novembro. - Você pode criar um conjunto de
Legendary Start Pack que incluiBooster . O conjunto não tem um tempo limite, então é sempre visível na loja. - Dia 20 de outubro, um usuário abre sua loja no jogo. Você usa os seguintes métodos:
- Obter item virtual para exibir o catálogo de itens virtuais.
- Obter lista de pacotes para exibir o catálogo de conjuntos.
show_inactive_time_limited_items
nesses métodos. - Você recupera o catálogo de item:
- O
Booster não é incluído na resposta do Obter lista de itens virtuais, porque seu período de exibição é 29 de outubro até 15 de novembro. Se você passar o parâmetroshow_inactive_time_limited_items:1
no Obter lista de itens virtuais, noBooster é incluído na resposta, e as matrizes de períodos indica o período em que ele estará disponível para compra. - O
Booster é incluído na resposta do Obter lista de pacotes como parte do conjuntoLegendary Start Pack , e o usuário pode obtê-lo independentemente do parâmetroshow_inactive_time_limited_items
.
- O
Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.