56 lines
1.9 KiB
Go
56 lines
1.9 KiB
Go
|
package ads
|
|||
|
|
|
|||
|
|
import (
|
|||
|
|
"encoding/json"
|
|||
|
|
"net/url"
|
|||
|
|
"time"
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
type GetAdScheduleResponse struct {
|
|||
|
|
// A list that contains information related to the channel’s ad schedule.
|
|||
|
|
Data []GetAdScheduleData `json:"data"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
type GetAdScheduleData struct {
|
|||
|
|
// The number of snoozes available for the broadcaster.
|
|||
|
|
SnoozeCount int `json:"snooze_count"`
|
|||
|
|
|
|||
|
|
// The UTC timestamp when the broadcaster will gain an additional snooze, in RFC3339 format.
|
|||
|
|
SnoozeRefreshAt time.Time `json:"snooze_refresh_at"`
|
|||
|
|
|
|||
|
|
// The UTC timestamp of the broadcaster’s next scheduled ad, in RFC3339 format. Empty if the channel has no ad scheduled or is not live.
|
|||
|
|
NextAdAt time.Time `json:"next_ad_at"`
|
|||
|
|
|
|||
|
|
// The length in seconds of the scheduled upcoming ad break.
|
|||
|
|
Duration int `json:"duration"`
|
|||
|
|
|
|||
|
|
// The UTC timestamp of the broadcaster’s last ad-break, in RFC3339 format. Empty if the channel has not run an ad or is not live.
|
|||
|
|
LastAdAt time.Time `json:"last_ad_at"`
|
|||
|
|
|
|||
|
|
// The amount of pre-roll free time remaining for the channel in seconds. Returns 0 if they are currently not pre-roll free.
|
|||
|
|
PrerollFreeTime int `json:"preroll_free_time"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// This endpoint returns ad schedule related information, including snooze, when the last ad was run, when the next ad is scheduled,
|
|||
|
|
// and if the channel is currently in pre-roll free time. Note that a new ad cannot be run until 8 minutes after running a previous ad.
|
|||
|
|
//
|
|||
|
|
// Requires a user access token that includes the channel:read:ads scope.
|
|||
|
|
// The user_id in the user access token must match the broadcaster_id.
|
|||
|
|
func (e *Ads) GetAdSchedule(broadcasterID string) (*GetAdScheduleResponse, error) {
|
|||
|
|
endpoint := e.baseUrl.ResolveReference(&url.URL{Path: "channels/ads", RawQuery: "broadcaster_id=" + broadcasterID})
|
|||
|
|
|
|||
|
|
resp, err := e.client.Get(endpoint.String())
|
|||
|
|
if err != nil {
|
|||
|
|
return nil, err
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
defer resp.Body.Close()
|
|||
|
|
|
|||
|
|
var data GetAdScheduleResponse
|
|||
|
|
if err := json.NewDecoder(resp.Body).Decode(&data); err != nil {
|
|||
|
|
return nil, err
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return &data, nil
|
|||
|
|
}
|