Class PaginatedSeriesClient
- Namespace
- Crews.PlanningCenter.Api.Publishing.V2018_08_01
- Assembly
- Crews.PlanningCenter.Api.dll
Client for interacting with Series collection resources.
public class PaginatedSeriesClient : PaginatedResourceClient<Series, SeriesResource, SeriesCollectionResponse, SeriesResponse>
- Inheritance
-
PaginatedSeriesClient
- Inherited Members
Constructors
PaginatedSeriesClient(HttpClient, Uri)
Client for interacting with Series collection resources.
public PaginatedSeriesClient(HttpClient httpClient, Uri uri)
Parameters
httpClientHttpClienturiUri
Methods
AddCustomParameter(string, string)
Adds a custom query parameter to the request URI.
public PaginatedSeriesClient AddCustomParameter(string parameter, string value)
Parameters
Returns
- PaginatedSeriesClient
The current PaginatedSeriesClient instance.
ClearParameters()
Removes the entire query string from the request URI.
public PaginatedSeriesClient ClearParameters()
Returns
- PaginatedSeriesClient
The current PaginatedSeriesClient instance.
Filter(string)
Adds a filter query parameter to the request.
public PaginatedSeriesClient Filter(string filter)
Parameters
filterstringThe filter criteria.
Returns
- PaginatedSeriesClient
The current PaginatedSeriesClient instance.
Remarks
See Planning Center API documentation for details on supported filter values for this resource.
GetAsync(CancellationToken)
Fetches a paginated list of Series resources asynchronously.
public Task<SeriesCollectionResponse> GetAsync(CancellationToken cancellationToken = default)
Parameters
cancellationTokenCancellationTokenA token to monitor for cancellation requests.
Returns
- Task<SeriesCollectionResponse>
A task representing the asynchronous operation, containing a paginated list of Series resources.
Exceptions
- JsonApiException
Thrown when the HTTP response indicates a failure status code.
IncludeChannel()
Include related Channel resources in the response.
public SeriesClient IncludeChannel()
Returns
Offset(int)
Sets the item offset in the paginated response.
public PaginatedSeriesClient Offset(int count)
Parameters
countintThe number of items to skip.
Returns
- PaginatedSeriesClient
The current PaginatedSeriesClient instance.
OrderByEndedAt()
Sort response items by the EndedAt attribute.
public SeriesClient OrderByEndedAt()
Returns
OrderByEndedAtDescending()
Sort response items by the EndedAt attribute. Use reverse order.
public SeriesClient OrderByEndedAtDescending()
Returns
OrderByEpisodesCount()
Sort response items by the EpisodesCount attribute.
public SeriesClient OrderByEpisodesCount()
Returns
OrderByEpisodesCountDescending()
Sort response items by the EpisodesCount attribute. Use reverse order.
public SeriesClient OrderByEpisodesCountDescending()
Returns
OrderByStartedAt()
Sort response items by the StartedAt attribute.
public SeriesClient OrderByStartedAt()
Returns
OrderByStartedAtDescending()
Sort response items by the StartedAt attribute. Use reverse order.
public SeriesClient OrderByStartedAtDescending()
Returns
OrderByTitle()
Sort response items by the Title attribute.
public SeriesClient OrderByTitle()
Returns
OrderByTitleDescending()
Sort response items by the Title attribute. Use reverse order.
public SeriesClient OrderByTitleDescending()
Returns
PerPage(int)
Sets the number of items to be returned per page in the paginated response.
public PaginatedSeriesClient PerPage(int count)
Parameters
countintThe number of items to be returned per page.
Returns
- PaginatedSeriesClient
The current PaginatedSeriesClient instance.
PostAsync(Series, CancellationToken)
Creates a new Series resource asynchronously.
public Task<SeriesResponse> PostAsync(Series resource, CancellationToken cancellationToken = default)
Parameters
resourceSeriesThe resource data to be sent in the POST request.
cancellationTokenCancellationTokenA token to monitor for cancellation requests.
Returns
- Task<SeriesResponse>
A task representing the asynchronous operation, containing the created Series resource.
Exceptions
- JsonApiException
Thrown when the HTTP response indicates a failure status code.
PostAsync(JsonApiDocument<SeriesResource>, CancellationToken)
Creates a new Series resource asynchronously.
public Task<SeriesResponse> PostAsync(JsonApiDocument<SeriesResource> document, CancellationToken cancellationToken = default)
Parameters
documentJsonApiDocument<SeriesResource>The JSON:API document to be sent in the POST request.
cancellationTokenCancellationTokenA token to monitor for cancellation requests.
Returns
- Task<SeriesResponse>
A task representing the asynchronous operation, containing the created Series resource.
Exceptions
- JsonApiException
Thrown when the HTTP response indicates a failure status code.
WhereId(string)
Query response items by the Id attribute.
public SeriesClient WhereId(string value)
Parameters
valuestring
Returns
WithId(string)
Creates a new instance of a Series client for a specific resource ID.
public SeriesClient WithId(string id)
Parameters
idstringThe ID of the resource to create a client for.
Returns
- SeriesClient
A new instance of the resource client for the specified resource ID.