63 lines
2.1 KiB
Go
63 lines
2.1 KiB
Go
package ads
|
||
|
||
import (
|
||
"context"
|
||
"encoding/json"
|
||
"net/http"
|
||
"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(ctx context.Context, broadcasterID string) (*GetAdScheduleResponse, error) {
|
||
endpoint := e.baseUrl.ResolveReference(&url.URL{Path: "channels/ads", RawQuery: "broadcaster_id=" + broadcasterID})
|
||
|
||
req, err := http.NewRequestWithContext(ctx, http.MethodGet, endpoint.String(), nil)
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
|
||
res, err := e.client.Do(req)
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
|
||
defer res.Body.Close()
|
||
|
||
var data GetAdScheduleResponse
|
||
if err := json.NewDecoder(res.Body).Decode(&data); err != nil {
|
||
return nil, err
|
||
}
|
||
|
||
return &data, nil
|
||
}
|