Analytics API reports support the following URL parameters.
||The accounts you want to report on||yes||one or more account ids as a comma-delimited list||none|
||The dimension(s) to report on||yes||one or more dimensions as a comma-delimited list (some combinations are not valid)||none|
||Number of items to return||no||positive integer||10|
||Number of items to skip||no||positive integer||0|
||Field to sort items on||no||a valid field for the request||video_view|
||Fields to return||no||varies according to the dimension you are reporting on||video_view|
||Format to return results in||no||json | csv | xlxs||json|
||If included, will limit results to either historical or realtime data||no||true | false||true|
||The beginning of the date range for the request||no||An ISO 8601 date (YYYY-MM-DD), epoch time in milliseconds, the string alltime, or relative date (-1m); only dates within the past 32 days are allowed for engagement endpoints or if reconciled=false.||30 days prior to now|
||The end of the date range for the request||no||An ISO 8601 date (YYYY-MM-DD), epoch time in milliseconds, the string now, or relative data (+7d); only dates within the past 32 days are allowed for engagement endpoints or if reconciled=false.||now|
The following fields can be returned for the dimension.
ad_mode_begin- the number of times the player entered ad mode
ad_mode_complete- the number of times the player completed ad mode
active_media- the number of active videos in the account
bytes_delivered- total bytes delivered to client machines for the player and associated media
daily_unique_viewers- average daily unique users
date- the date in ISO 8601 date (YYYY-MM-DD) format
drm_bytes_packaged- the number of DRM bytes packaged
engagement_score- the average engagement score for videos
licenses_served- the number of DRM licenses served
live_seconds_streamed- the total number of live streaming seconds delivered
play_request- total number of times video playback was requested
play_rate- the average play rate (video views divided by impressions) for videos
player_load- the total number of player loads
video_engagement_1- the total number of views at the 1 percent point of video duration
video_engagement_100- the total number of views at the 100 percent point of video duration
video_engagement_25- the total number of views at the 25 percent point of video duration
video_engagement_50- the total number of views at the 50 percent point of video duration
video_engagement_75- the total number of views at the 75 percent point of video duration
video_impression- the total number of times videos were loaded into players
video_percent_viewed- total percent viewed for all video views (a sum, not an average)
video_seconds_viewed- the total seconds viewed for all videos
video_view- the total number of times video playback began
Used as a filter, a dimension allows you to narrow the results.
Filter values: The date dimension is not used as a filter.
To see what dimensions this on can be combined with, and what fields are available for the combination, see Dimension and Fields.
Response will appear here when you test a request