Class PaginatedLiveClient
- Namespace
- Crews.PlanningCenter.Api.Services.V2018_08_01
- Assembly
- Crews.PlanningCenter.Api.dll
Client for interacting with Live collection resources.
public class PaginatedLiveClient : PaginatedResourceClient<Live, LiveResource, LiveCollectionResponse, LiveResponse>
- Inheritance
-
PaginatedLiveClient
- Inherited Members
Constructors
PaginatedLiveClient(HttpClient, Uri)
Client for interacting with Live collection resources.
public PaginatedLiveClient(HttpClient httpClient, Uri uri)
Parameters
httpClientHttpClienturiUri
Methods
AddCustomParameter(string, string)
Adds a custom query parameter to the request URI.
public PaginatedLiveClient AddCustomParameter(string parameter, string value)
Parameters
Returns
- PaginatedLiveClient
The current PaginatedLiveClient instance.
ClearParameters()
Removes the entire query string from the request URI.
public PaginatedLiveClient ClearParameters()
Returns
- PaginatedLiveClient
The current PaginatedLiveClient instance.
Filter(string)
Adds a filter query parameter to the request.
public PaginatedLiveClient Filter(string filter)
Parameters
filterstringThe filter criteria.
Returns
- PaginatedLiveClient
The current PaginatedLiveClient instance.
Remarks
See Planning Center API documentation for details on supported filter values for this resource.
GetAsync(CancellationToken)
Fetches a paginated list of Live resources asynchronously.
public Task<LiveCollectionResponse> GetAsync(CancellationToken cancellationToken = default)
Parameters
cancellationTokenCancellationTokenA token to monitor for cancellation requests.
Returns
- Task<LiveCollectionResponse>
A task representing the asynchronous operation, containing a paginated list of Live resources.
Exceptions
- JsonApiException
Thrown when the HTTP response indicates a failure status code.
IncludeController()
Include related Controller resources in the response.
public LiveClient IncludeController()
Returns
IncludeCurrentItemTime()
Include related CurrentItemTime resources in the response.
public LiveClient IncludeCurrentItemTime()
Returns
IncludeItems()
Include related Items resources in the response.
public LiveClient IncludeItems()
Returns
IncludeNextItemTime()
Include related NextItemTime resources in the response.
public LiveClient IncludeNextItemTime()
Returns
IncludeServiceType()
Include related ServiceType resources in the response.
public LiveClient IncludeServiceType()
Returns
Offset(int)
Sets the item offset in the paginated response.
public PaginatedLiveClient Offset(int count)
Parameters
countintThe number of items to skip.
Returns
- PaginatedLiveClient
The current PaginatedLiveClient instance.
PerPage(int)
Sets the number of items to be returned per page in the paginated response.
public PaginatedLiveClient PerPage(int count)
Parameters
countintThe number of items to be returned per page.
Returns
- PaginatedLiveClient
The current PaginatedLiveClient instance.
PostAsync(Live, CancellationToken)
Creates a new Live resource asynchronously.
public Task<LiveResponse> PostAsync(Live resource, CancellationToken cancellationToken = default)
Parameters
resourceLiveThe resource data to be sent in the POST request.
cancellationTokenCancellationTokenA token to monitor for cancellation requests.
Returns
- Task<LiveResponse>
A task representing the asynchronous operation, containing the created Live resource.
Exceptions
- JsonApiException
Thrown when the HTTP response indicates a failure status code.
PostAsync(JsonApiDocument<LiveResource>, CancellationToken)
Creates a new Live resource asynchronously.
public Task<LiveResponse> PostAsync(JsonApiDocument<LiveResource> document, CancellationToken cancellationToken = default)
Parameters
documentJsonApiDocument<LiveResource>The JSON:API document to be sent in the POST request.
cancellationTokenCancellationTokenA token to monitor for cancellation requests.
Returns
- Task<LiveResponse>
A task representing the asynchronous operation, containing the created Live resource.
Exceptions
- JsonApiException
Thrown when the HTTP response indicates a failure status code.
WithId(string)
Creates a new instance of a Live client for a specific resource ID.
public LiveClient WithId(string id)
Parameters
idstringThe ID of the resource to create a client for.
Returns
- LiveClient
A new instance of the resource client for the specified resource ID.