getSingleFromTag static method

Future<PcoCalendarEventInstance?> getSingleFromTag(
  1. String tagId,
  2. String id, {
  3. PcoCalendarEventInstanceQuery? query,
  4. bool includeAllRelated = false,
  5. bool includeEvent = false,
  6. bool includeEventTimes = false,
  7. bool includeResourceBookings = false,
  8. bool includeTags = false,
})

Will get a single PcoCalendarEventInstance object using a path like this: /calendar/v2/tags/$tagId/event_instances/[id]

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<PcoCalendarEventInstance?> getSingleFromTag(
  String tagId,
  String id, {
  PcoCalendarEventInstanceQuery? query,
  bool includeAllRelated = false,
  bool includeEvent = false,
  bool includeEventTimes = false,
  bool includeResourceBookings = false,
  bool includeTags = false,
}) async {
  query ??= PcoCalendarEventInstanceQuery();
  if (includeAllRelated)
    query.include.addAll(PcoCalendarEventInstance.canInclude);
  if (includeEvent) query.include.add('event');
  if (includeEventTimes) query.include.add('event_times');
  if (includeResourceBookings) query.include.add('resource_bookings');
  if (includeTags) query.include.add('tags');
  var url = '/calendar/v2/tags/$tagId/event_instances/$id';
  var retval = await PcoCollection.fromApiCall<PcoCalendarEventInstance>(url,
      query: query, apiVersion: kApiVersion);
  return retval.items.isEmpty ? null : retval.items.first;
}