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