Struct twitch_api2::helix::clips::get_clips::GetClipsRequest

#[non_exhaustive]
pub struct GetClipsRequest {
    pub broadcaster_id: Option<UserId>,
    pub game_id: Option<CategoryId>,
    pub id: Vec<String>,
    pub after: Option<Cursor>,
    pub before: Option<Cursor>,
    pub ended_at: Option<Timestamp>,
    pub first: Option<usize>,
    pub started_at: Option<Timestamp>,
}

Available on crate feature helix only.

Query Parameters for Get Clips

get-clips

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

broadcaster_id: Option<UserId>

ID of the broadcaster for whom clips are returned. The number of clips returned is determined by the first query-string parameter (default: 20). Results are ordered by view count.

game_id: Option<CategoryId>

ID of the game for which clips are returned. The number of clips returned is determined by the first query-string parameter (default: 20). Results are ordered by view count.

id: Vec<String>

ID of the clip being queried. Limit: 100.

after: Option<Cursor>

Cursor for forward pagination: tells the server where to start fetching the next set of results, in a multi-page response. This applies only to queries specifying broadcaster_id or game_id. The cursor value specified here is from the pagination response field of a prior query.

before: Option<Cursor>

Cursor for backward pagination: tells the server where to start fetching the next set of results, in a multi-page response. This applies only to queries specifying broadcaster_id or game_id. The cursor value specified here is from the pagination response field of a prior query.

ended_at: Option<Timestamp>

Ending date/time for returned clips, in RFC3339 format. (Note that the seconds value is ignored.) If this is specified, started_at also must be specified; otherwise, the time period is ignored.

first: Option<usize>

Maximum number of objects to return. Maximum: 100. Default: 20.

started_at: Option<Timestamp>

Starting date/time for returned clips, in RFC3339 format. (Note that the seconds value is ignored.) If this is specified, ended_at also should be specified; otherwise, the ended_at date/time will be 1 week after the started_at value.

Implementations

impl GetClipsRequest

pub fn builder() -> GetClipsRequestBuilder<((), (), (), (), (), (), (), ())>

Create a builder for building GetClipsRequest. On the builder, call .broadcaster_id(...)(optional), .game_id(...)(optional), .id(...)(optional), .after(...)(optional), .before(...)(optional), .ended_at(...)(optional), .first(...)(optional), .started_at(...)(optional) to set the values of the fields. Finally, call .build() to create the instance of GetClipsRequest.

Trait Implementations

impl Clone for GetClipsRequest

fn clone(&self) -> GetClipsRequest

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GetClipsRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GetClipsRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Paginated for GetClipsRequest

fn set_pagination(&mut self, cursor: Option<Cursor>)

Should returns the current pagination cursor.

impl PartialEq<GetClipsRequest> for GetClipsRequest

fn eq(&self, other: &GetClipsRequest) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &GetClipsRequest) -> bool

This method tests for !=.

impl Request for GetClipsRequest

type Response = Vec<Clip, Global>

Response type. twitch’s response will deserialize to this.

const PATH: &'static str = "clips"

The path to the endpoint relative to the helix root. eg. channels for Get Channel Information

const SCOPE: &'static [Scope] = &[]

Available on crate feature twitch_oauth2 only.

Scopes needed by this endpoint

const OPT_SCOPE: &'static [Scope] = &[]

Available on crate feature twitch_oauth2 only.

Optional scopes needed by this endpoint

fn query(&self) -> Result<String, SerializeError>

Defines layout of the url parameters.

fn get_uri(&self) -> Result<Uri, InvalidUri>

Returns full URI for the request, including query parameters.

fn get_bare_uri() -> Result<Uri, InvalidUri>

Returns bare URI for the request, NOT including query parameters.

impl RequestGet for GetClipsRequest

fn create_request(
    &self,
    token: &str,
    client_id: &str
) -> Result<Request<Bytes>, CreateRequestError>

Create a http::Request from this Request in your client

fn parse_response<B: Into<Bytes>>(
    request: Option<Self>,
    uri: &Uri,
    response: Response<B>
) -> Result<Response<Self, <Self as Request>::Response>, HelixRequestGetError> where
    Self: Sized, 

Parse response.

fn parse_inner_response(
    request: Option<Self>,
    uri: &Uri,
    response: &str,
    status: StatusCode
) -> Result<Response<Self, <Self as Request>::Response>, HelixRequestGetError> where
    Self: Sized, 

Parse a response string into the response.

impl Serialize for GetClipsRequest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for GetClipsRequest