go-twitch/api/ads/snooze_next_ad.go

47 lines
1.5 KiB
Go
Raw Normal View History

2024-02-27 22:13:57 -05:00
package ads
import (
"encoding/json"
"net/url"
"time"
)
type SnoozeNextAdResponse struct {
// A list that contains information about the channels snoozes and next upcoming ad after successfully snoozing.
Data []SnoozeNextAdData `json:"data"`
}
type SnoozeNextAdData 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 broadcasters next scheduled ad, in RFC3339 format.
NextAdAt time.Time `json:"next_ad_at"`
}
// If available, pushes back the timestamp of the upcoming automatic mid-roll ad by 5 minutes.
// This endpoint duplicates the snooze functionality in the creator dashboards Ads Manager.
//
// Requires a user access token that includes the channel:manage:ads scope.
// The user_id in the user access token must match the broadcaster_id.
func (e *Ads) SnoozeNextAd(broadcasterID string) (*SnoozeNextAdResponse, error) {
endpoint := e.baseUrl.ResolveReference(&url.URL{Path: "channels/ads/schedule/snooze", RawQuery: "broadcaster_id=" + broadcasterID})
resp, err := e.client.Post(endpoint.String(), "application/json", nil)
if err != nil {
return nil, err
}
defer resp.Body.Close()
var data SnoozeNextAdResponse
if err := json.NewDecoder(resp.Body).Decode(&data); err != nil {
return nil, err
}
return &data, nil
}