getFromTag static method
Will get a PcoCollection
of PcoCalendarEvent objects (expecting many)
using a path like this: /calendar/v2/tags/$tagId/events
Getting a PcoCollection
is useful even when retrieving a single object
because it contains error data and helper functions.
Additional options may be specified by using the query
argument, but some
query options are also available as boolean flags in this function call too.
Implementation
static Future<PcoCollection<PcoCalendarEvent>> getFromTag(
String tagId, {
String? id,
PcoCalendarEventQuery? query,
bool getAll = false,
bool includeAllRelated = false,
bool includeAttachments = false,
bool includeOwner = false,
bool includeTags = false,
}) async {
query ??= PcoCalendarEventQuery();
if (getAll) query.getAll = true;
if (includeAllRelated) query.include.addAll(PcoCalendarEvent.canInclude);
if (includeAttachments) query.include.add('attachments');
if (includeOwner) query.include.add('owner');
if (includeTags) query.include.add('tags');
var url = '/calendar/v2/tags/$tagId/events';
if (id != null) url += '/$id';
return PcoCollection.fromApiCall<PcoCalendarEvent>(url,
query: query, apiVersion: kApiVersion);
}