Interface GetSessionLivestreamPerformanceParams

Zero-based offset of the first detail record to return. Limitations:- Only supported when session_list is omitted or an empty array.- Default value is 0.- Must be greater than or equal to 0.

End date of the requested period in YYYY-MM-DD format.

Limitations:

• Must use the YYYY-MM-DD format.

• Must be a valid calendar date.

• Must not be earlier than start_date.

• Validation is based on the requested timezone.

• For customize, end_date must not be later than the day before the current day in the requested timezone. The inclusive date range from start_date to end_date must not exceed 366 days.

• For day, end_date must equal start_date.

• For week, end_date must be within the selected week range: from start_date (Sunday) to the end of that Sunday-to-Saturday week, or to the latest selectable day if the week extends beyond today. Formally: startDate ≤ endDate ≤ min(startDate + 6 days, today - 1 day).

• For month, end_date must be within the selected month: from the 1st day of the month to the last calendar day of that month, or to the latest selectable day for the current month. Formally: startDate ≤ endDate ≤ min(month end, today - 1 day).

• For quarter, end_date must be within the selected quarter: from the 1st day of the quarter to the last calendar day of that quarter, or to the latest selectable day for the current quarter. Formally: startDate ≤ endDate ≤ min(quarter end, today - 1 day).

• For year, end_date must be within the selected year: from January 1st to December 31st of that year, or to the latest selectable day for the current year. Formally: startDate ≤ endDate ≤ min(Dec 31, today - 1 day).

Aggregation granularity that determines the validation rules for the requested date range and the reporting period. Limitations:- Supported values are customize, day, week, month, quarter, and year.- customize is validated as a free date range and is internally queried with the affiliate-compatible livestream granularity.- day represents a single calendar day.- week requires a Sunday-based calendar week.- month requires a calendar month range.- quarter requires a calendar quarter range.- year requires a calendar year range.- Any other value is rejected as invalid_parameter.

Number of detail records to return in the current response page. Limitations:- Only supported when session_list is omitted or an empty array.- Default value is 100.- Must be between 1 and 200, inclusive.

List of livestream session query targets. Limitations:- Must contain at least one object.- Must contain at most 100 objects.- Every shop_id must belong to the specified principal_id.- Duplicate shop_id values are rejected.- Each object must provide a non-empty session_ids list.- Null session_id values are rejected.- Duplicate session_id values across the whole request are rejected.- The total number of unique session_ids across the whole request must not exceed 100.

Start date of the requested period in YYYY-MM-DD format.

Limitations:- Must use the YYYY-MM-DD format.- Must be a valid calendar date.- Must not be later than end_date.- Validation is based on the requested timezone.- The earliest selectable date is calculated as: current day in timezone - 1 day - 2 years.- The exact boundary rules depend on granularity:-- For customize, start_date must not be earlier than the earliest selectable date.-- For day, start_date must equal end_date.-- For week, start_date must be a Sunday.-- For month, start_date must be the first day of the month.-- For quarter, start_date must be the first day of the quarter.-- For year, start_date must be the first day of the year.

Timezone used for date boundary calculation, selectable date validation, and timestamp conversion.

Limitations:- Enum values: ["GMT+7", "GMT+8", "GMT-3"]- The API internally normalizes the open API timezone value for livestream metric queries.- All date validation rules are evaluated in the requested timezone.