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