87 lines
3.1 KiB
Go
87 lines
3.1 KiB
Go
|
package bits
|
|||
|
|
|
|||
|
|
import (
|
|||
|
|
"encoding/json"
|
|||
|
|
"net/url"
|
|||
|
|
"time"
|
|||
|
|
|
|||
|
|
"github.com/google/go-querystring/query"
|
|||
|
|
"go.fifitido.net/twitch/api/types"
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
type GetBitsLeaderboardParams struct {
|
|||
|
|
// The number of results to return. The minimum count is 1 and the maximum is 100. The default is 10.
|
|||
|
|
Count *int `url:"count,omitempty"`
|
|||
|
|
|
|||
|
|
// The time period over which data is aggregated (uses the PST time zone).
|
|||
|
|
Period *Period `url:"period,omitempty"`
|
|||
|
|
|
|||
|
|
// The start date, in RFC3339 format, used for determining the aggregation period. Specify this parameter only if you specify the period query parameter.
|
|||
|
|
// The start date is ignored if period is all.
|
|||
|
|
//
|
|||
|
|
// Note that the date is converted to PST before being used, so if you set the start time to 2022-01-01T00:00:00.0Z and period to month,
|
|||
|
|
// the actual reporting period is December 2021, not January 2022. If you want the reporting period to be January 2022,
|
|||
|
|
// you must set the start time to 2022-01-01T08:00:00.0Z or 2022-01-01T00:00:00.0-08:00.
|
|||
|
|
//
|
|||
|
|
// If your start date uses the ‘+’ offset operator (for example, 2022-01-01T00:00:00.0+05:00), you must URL encode the start date.
|
|||
|
|
StartedAt *time.Time `url:"started_at,omitempty"`
|
|||
|
|
|
|||
|
|
// An ID that identifies a user that cheered bits in the channel.
|
|||
|
|
// If count is greater than 1, the response may include users ranked above and below the specified user.
|
|||
|
|
// To get the leaderboard’s top leaders, don’t specify a user ID.
|
|||
|
|
UserID *string `url:"user_id,omitempty"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
type GetBitsLeaderboardResponse struct {
|
|||
|
|
// A list of leaderboard leaders. The leaders are returned in rank order by how much they’ve cheered.
|
|||
|
|
// The array is empty if nobody has cheered bits.
|
|||
|
|
Data []LeaderboardEntry `json:"data"`
|
|||
|
|
|
|||
|
|
// The reporting window’s start and end dates, in RFC3339 format. The dates are calculated by using the started_at and period query parameters.
|
|||
|
|
// If you don’t specify the started_at query parameter, the fields contain empty strings.
|
|||
|
|
DateRange types.DateRange `json:"date_range"`
|
|||
|
|
|
|||
|
|
// The number of ranked users in data.
|
|||
|
|
// This is the value in the count query parameter or the total number of entries on the leaderboard, whichever is less.
|
|||
|
|
Total int `json:"total"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
type LeaderboardEntry struct {
|
|||
|
|
// An ID that identifies a user on the leaderboard.
|
|||
|
|
UserID string `json:"user_id"`
|
|||
|
|
|
|||
|
|
// The user’s login name.
|
|||
|
|
UserLogin string `json:"user_login"`
|
|||
|
|
|
|||
|
|
// The user’s display name.
|
|||
|
|
UserName string `json:"user_name"`
|
|||
|
|
|
|||
|
|
// The user’s position on the leaderboard.
|
|||
|
|
Rank int `json:"rank"`
|
|||
|
|
|
|||
|
|
// The number of Bits the user has cheered.
|
|||
|
|
Score int `json:"score"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// Gets the Bits leaderboard for the authenticated broadcaster.
|
|||
|
|
//
|
|||
|
|
// Requires a user access token that includes the bits:read scope.
|
|||
|
|
func (b *Bits) GetBitsLeaderboard(params *GetBitsLeaderboardParams) (*GetBitsLeaderboardResponse, error) {
|
|||
|
|
v, _ := query.Values(params)
|
|||
|
|
endpoint := b.baseUrl.ResolveReference(&url.URL{Path: "bits/leaderboard", RawQuery: v.Encode()})
|
|||
|
|
|
|||
|
|
resp, err := b.client.Get(endpoint.String())
|
|||
|
|
if err != nil {
|
|||
|
|
return nil, err
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
defer resp.Body.Close()
|
|||
|
|
|
|||
|
|
var data GetBitsLeaderboardResponse
|
|||
|
|
if err := json.NewDecoder(resp.Body).Decode(&data); err != nil {
|
|||
|
|
return nil, err
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return &data, nil
|
|||
|
|
}
|