文章 Update Leaderboard REST 端点

URLs

PUT api/v1/leaderboards/{id}.xml (or .json)

请求参数

名称

类型

描述

必需

默认值

选项

Id

Guid

Id of the Leaderboard

Name

string

Name of the Leaderboard

Description

string

Description of the Leaderboard

ApplicationKey

string

Application Key for url

NumberOfLeaders

int

Number of Users to show on the Leaderboard

ContainerId

Guid?

Filter points to those earned within a certain Container. Optional.

StartDate

DateTime

Specify the earliest date scores will count for this leaderboard. Either StartDate + EndDate, or TimeSpanValue + TimeSpanType are required.

EndDate

DateTime

Specify the earliest date scores will count for this leaderboard. Either StartDate + EndDate, or TimeSpanValue + TimeSpanType are required.

StartDisplayDate

DateTime

Only show the leaderboard on the site after this date. Optional, defaults to StartDate.

EndDisplayDate

DateTime

Only show the leaderboard on the site before this date. Optional, defaults to EndDate

TimeSpanValue

int

Specify the number of (days/months/years), based on the TimeSpanType. Either StartDate + EndDate, or TimeSpanValue + TimeSpanType are required.

TimeSpanType

string

Specify the time of time span for calculations (days/months/years). Either StartDate + EndDate, or TimeSpanValue + TimeSpanType are required. Options are: Day, Month, Year.

PeriodType

string

Specify the anchor for the time span rolling window. Past (default) = generalized timespan counting backwards from current time or EndDate. Current = timespan starting from the beginning of the specified month/day/year. Options are: AllTime, Static, Rolling.

IncludeRolesFilter

string

Comma separated list of Site RoleIds. Used to limit the leaders for the leaderboard. Only users assigned the provided site roles will be eligable to be on the leaderboard.

ExcludeRolesFilter

string

Comma separated list of Site RoleIds. Used to limit the leaders for the leaderboard. Only users who are not assigned the provided site roles will be eligable to be on the leaderboard.