Skip to main content

​
CollaboratorTimersGroupBy Objects

class CollaboratorTimersGroupBy(CamelStrEnum)
Grouping mode for collaborator time tracking analytics. Values:
  • DATA_UNIT: Group time spent per individual data unit.
  • PROJECT: Group time spent at the project level.

​
CollaboratorTimerParams Objects

class CollaboratorTimerParams(BaseDTO)
Parameters for fetching collaborator timer analytics. Arguments:
  • project_hash - Identifier of the project to query.
  • after - Start of the time window (inclusive).
  • before - Optional end of the time window (exclusive). If omitted, the server will typically use the current time.
  • group_by - How to group results, for example by data unit or by project.
  • page_size - Maximum number of records to return in a single page.
  • page_token - Pagination token returned from a previous response, used to fetch the next page of results.

​
CollaboratorTimer Objects

class CollaboratorTimer(BaseDTO)
Time spent by a single collaborator within the requested window. Arguments:
  • user_email - Email address of the collaborator.
  • user_role - Role of the user in the project (for example, annotator or reviewer).
  • data_title - Optional title of the data item this timer row refers to. May be None when grouped at the project level.
  • time_seconds - Total time spent (in seconds) matching the query filters.

​
TimeSpentParams Objects

class TimeSpentParams(BaseDTO)
Filter parameters for fetching aggregated time spent analytics. Arguments:
  • project_uuid - Unique identifier of the project to query.
  • after - Start of the time window (inclusive).
  • before - Optional end of the time window (exclusive). If omitted, uses current time.
  • workflow_stage_uuids - Optional subset of workflow stages to include.
  • user_emails - Optional list of user emails to filter by.
  • dataset_uuids - Optional subset of datasets to include.
  • data_uuids - Optional subset of data items to include.
  • data_title - Optional fuzzy match string on data title.
  • page_token - Pagination token from a previous response.

​
TimeSpent Objects

class TimeSpent(BaseDTO)
Aggregated time spent for a user or stage within a time bucket. Arguments:
  • period_start_time - Beginning of the aggregation period.
  • period_end_time - End of the aggregation period.
  • time_spent_seconds - Total time spent (in seconds) in this period.
  • user_email - Email of the user this row refers to.
  • project_user_role - Role of the user in the project (annotator, reviewer, etc.).
  • data_uuid - Unique identifier of the data item.
  • data_title - Human-readable title of the data item.
  • dataset_uuid - Unique identifier of the dataset.
  • dataset_title - Human-readable dataset title.
  • workflow_task_uuid - Optional workflow task identifier.
  • workflow_stage - Optional workflow stage object associated with this row.