Class PaginatedEpisodeResourceClient
- Namespace
- Crews.PlanningCenter.Api.Publishing.V2018_08_01
- Assembly
- Crews.PlanningCenter.Api.dll
Client for interacting with EpisodeResource collection resources.
public class PaginatedEpisodeResourceClient : PaginatedResourceClient<EpisodeResource, EpisodeResourceResource, EpisodeResourceCollectionResponse, EpisodeResourceResponse>
- Inheritance
-
PaginatedResourceClient<EpisodeResource, EpisodeResourceResource, EpisodeResourceCollectionResponse, EpisodeResourceResponse>PaginatedEpisodeResourceClient
- Inherited Members
Constructors
PaginatedEpisodeResourceClient(HttpClient, Uri)
Client for interacting with EpisodeResource collection resources.
public PaginatedEpisodeResourceClient(HttpClient httpClient, Uri uri)
Parameters
httpClientHttpClienturiUri
Methods
AddCustomParameter(string, string)
Adds a custom query parameter to the request URI.
public PaginatedEpisodeResourceClient AddCustomParameter(string parameter, string value)
Parameters
Returns
- PaginatedEpisodeResourceClient
The current PaginatedEpisodeResourceClient instance.
ClearParameters()
Removes the entire query string from the request URI.
public PaginatedEpisodeResourceClient ClearParameters()
Returns
- PaginatedEpisodeResourceClient
The current PaginatedEpisodeResourceClient instance.
Filter(string)
Adds a filter query parameter to the request.
public PaginatedEpisodeResourceClient Filter(string filter)
Parameters
filterstringThe filter criteria.
Returns
- PaginatedEpisodeResourceClient
The current PaginatedEpisodeResourceClient instance.
Remarks
See Planning Center API documentation for details on supported filter values for this resource.
GetAsync(CancellationToken)
Fetches a paginated list of EpisodeResource resources asynchronously.
public Task<EpisodeResourceCollectionResponse> GetAsync(CancellationToken cancellationToken = default)
Parameters
cancellationTokenCancellationTokenA token to monitor for cancellation requests.
Returns
- Task<EpisodeResourceCollectionResponse>
A task representing the asynchronous operation, containing a paginated list of EpisodeResource resources.
Exceptions
- JsonApiException
Thrown when the HTTP response indicates a failure status code.
Offset(int)
Sets the item offset in the paginated response.
public PaginatedEpisodeResourceClient Offset(int count)
Parameters
countintThe number of items to skip.
Returns
- PaginatedEpisodeResourceClient
The current PaginatedEpisodeResourceClient instance.
OrderByPosition()
Sort response items by the Position attribute.
public EpisodeResourceClient OrderByPosition()
Returns
OrderByPositionDescending()
Sort response items by the Position attribute. Use reverse order.
public EpisodeResourceClient OrderByPositionDescending()
Returns
PerPage(int)
Sets the number of items to be returned per page in the paginated response.
public PaginatedEpisodeResourceClient PerPage(int count)
Parameters
countintThe number of items to be returned per page.
Returns
- PaginatedEpisodeResourceClient
The current PaginatedEpisodeResourceClient instance.
PostAsync(EpisodeResource, CancellationToken)
Creates a new EpisodeResource resource asynchronously.
public Task<EpisodeResourceResponse> PostAsync(EpisodeResource resource, CancellationToken cancellationToken = default)
Parameters
resourceEpisodeResourceThe resource data to be sent in the POST request.
cancellationTokenCancellationTokenA token to monitor for cancellation requests.
Returns
- Task<EpisodeResourceResponse>
A task representing the asynchronous operation, containing the created EpisodeResource resource.
Exceptions
- JsonApiException
Thrown when the HTTP response indicates a failure status code.
PostAsync(JsonApiDocument<EpisodeResourceResource>, CancellationToken)
Creates a new EpisodeResource resource asynchronously.
public Task<EpisodeResourceResponse> PostAsync(JsonApiDocument<EpisodeResourceResource> document, CancellationToken cancellationToken = default)
Parameters
documentJsonApiDocument<EpisodeResourceResource>The JSON:API document to be sent in the POST request.
cancellationTokenCancellationTokenA token to monitor for cancellation requests.
Returns
- Task<EpisodeResourceResponse>
A task representing the asynchronous operation, containing the created EpisodeResource resource.
Exceptions
- JsonApiException
Thrown when the HTTP response indicates a failure status code.
WithId(string)
Creates a new instance of a EpisodeResource client for a specific resource ID.
public EpisodeResourceClient WithId(string id)
Parameters
idstringThe ID of the resource to create a client for.
Returns
- EpisodeResourceClient
A new instance of the resource client for the specified resource ID.