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