Skip to content

Commit

Permalink
Add possible values to dimension params
Browse files Browse the repository at this point in the history
  • Loading branch information
ThibaultBee authored Aug 22, 2023
1 parent d92f784 commit d0edeb6
Show file tree
Hide file tree
Showing 3 changed files with 21 additions and 13 deletions.
12 changes: 6 additions & 6 deletions api/openapi.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -7879,9 +7879,9 @@ paths:
- `videoId`: Returns analytics based on the public video identifiers.
- `emittedAt`: Returns analytics based on the times of the play events. The API returns data in specific interval groups. When the date period you set in `from` and `to` is less than or equals to 2 days, the response for this dimension is grouped in hourly intervals. Otherwise, it is grouped in daily intervals.
- `country`: Returns analytics based on the viewers' country. The list of supported country names are based on the [GeoNames public database](https://www.geonames.org/countries/).
- `deviceType`: Returns analytics based on the type of device used by the viewers during the play event.
- `operatingSystem`: Returns analytics based on the operating system used by the viewers during the play event.
- `browser`: Returns analytics based on the browser used by the viewers during the play event.
- `deviceType`: Returns analytics based on the type of device used by the viewers during the play event. Possible response values are: `computer`, `phone`, `tablet`, `tv`, `console`, `wearable`, `unknown`.
- `operatingSystem`: Returns analytics based on the operating system used by the viewers during the play event. Response values include `windows`, `mac osx`, `android`, `ios`, `linux`.
- `browser`: Returns analytics based on the browser used by the viewers during the play event. Response values include `chrome`, `firefox`, `edge`, `opera`.
example: browser
explode: false
in: query
Expand Down Expand Up @@ -8738,9 +8738,9 @@ paths:
- `liveStreamId`: Returns analytics based on the public live stream identifiers.
- `emittedAt`: Returns analytics based on the times of the play events. The API returns data in specific interval groups. When the date period you set in `from` and `to` is less than or equals to 2 days, the response for this dimension is grouped in hourly intervals. Otherwise, it is grouped in daily intervals.
- `country`: Returns analytics based on the viewers' country. The list of supported country names are based on the [GeoNames public database](https://www.geonames.org/countries/).
- `deviceType`: Returns analytics based on the type of device used by the viewers during the play event.
- `operatingSystem`: Returns analytics based on the operating system used by the viewers during the play event.
- `browser`: Returns analytics based on the browser used by the viewers during the play event.
- `deviceType`: Returns analytics based on the type of device used by the viewers during the play event. Possible response values are: `computer`, `phone`, `tablet`, `tv`, `console`, `wearable`, `unknown`.
- `operatingSystem`: Returns analytics based on the operating system used by the viewers during the play event. Response values include `windows`, `mac osx`, `android`, `ios`, `linux`.
- `browser`: Returns analytics based on the browser used by the viewers during the play event. Response values include `chrome`, `firefox`, `edge`, `opera`.
example: browser
explode: false
in: query
Expand Down
4 changes: 2 additions & 2 deletions docs/AnalyticsApi.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ public class Example {
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**from** | **LocalDate**| Use this query parameter to set the start date for the time period that you want analytics for. - The API returns analytics data including the day you set in `from`. - The date you set must be **within the last 30 days**. - The value you provide must follow the `YYYY-MM-DD` format. |
**dimension** | **String**| Use this query parameter to define the dimension that you want analytics for. - `liveStreamId`: Returns analytics based on the public live stream identifiers. - `emittedAt`: Returns analytics based on the times of the play events. The API returns data in specific interval groups. When the date period you set in `from` and `to` is less than or equals to 2 days, the response for this dimension is grouped in hourly intervals. Otherwise, it is grouped in daily intervals. - `country`: Returns analytics based on the viewers' country. The list of supported country names are based on the [GeoNames public database](https://www.geonames.org/countries/). - `deviceType`: Returns analytics based on the type of device used by the viewers during the play event. - `operatingSystem`: Returns analytics based on the operating system used by the viewers during the play event. - `browser`: Returns analytics based on the browser used by the viewers during the play event. | [enum: liveStreamId, emittedAt, country, deviceType, operatingSystem, browser]
**dimension** | **String**| Use this query parameter to define the dimension that you want analytics for. - `liveStreamId`: Returns analytics based on the public live stream identifiers. - `emittedAt`: Returns analytics based on the times of the play events. The API returns data in specific interval groups. When the date period you set in `from` and `to` is less than or equals to 2 days, the response for this dimension is grouped in hourly intervals. Otherwise, it is grouped in daily intervals. - `country`: Returns analytics based on the viewers' country. The list of supported country names are based on the [GeoNames public database](https://www.geonames.org/countries/). - `deviceType`: Returns analytics based on the type of device used by the viewers during the play event. Possible response values are: `computer`, `phone`, `tablet`, `tv`, `console`, `wearable`, `unknown`. - `operatingSystem`: Returns analytics based on the operating system used by the viewers during the play event. Response values include `windows`, `mac osx`, `android`, `ios`, `linux`. - `browser`: Returns analytics based on the browser used by the viewers during the play event. Response values include `chrome`, `firefox`, `edge`, `opera`. | [enum: liveStreamId, emittedAt, country, deviceType, operatingSystem, browser]
**to** | **LocalDate**| Use this optional query parameter to set the end date for the time period that you want analytics for. - If you do not specify a `to` date, the API returns analytics data starting from the `from` date up until today, and excluding today. - The date you set must be **within the last 30 days**. - The value you provide must follow the `YYYY-MM-DD` format. | [optional]
**filter** | **String**| Use this query parameter to filter your results to a specific live stream in a project that you want analytics for. You must use the `liveStreamId:` prefix when specifying a live stream ID. | [optional]
**currentPage** | **Integer**| Choose the number of search results to return per page. Minimum value: 1 | [optional] [default to 1]
Expand Down Expand Up @@ -148,7 +148,7 @@ public class Example {
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**from** | **LocalDate**| Use this query parameter to set the start date for the time period that you want analytics for. - The API returns analytics data including the day you set in `from`. - The date you set must be **within the last 30 days**. - The value you provide must follow the `YYYY-MM-DD` format. |
**dimension** | **String**| Use this query parameter to define the dimension that you want analytics for. - `videoId`: Returns analytics based on the public video identifiers. - `emittedAt`: Returns analytics based on the times of the play events. The API returns data in specific interval groups. When the date period you set in `from` and `to` is less than or equals to 2 days, the response for this dimension is grouped in hourly intervals. Otherwise, it is grouped in daily intervals. - `country`: Returns analytics based on the viewers' country. The list of supported country names are based on the [GeoNames public database](https://www.geonames.org/countries/). - `deviceType`: Returns analytics based on the type of device used by the viewers during the play event. - `operatingSystem`: Returns analytics based on the operating system used by the viewers during the play event. - `browser`: Returns analytics based on the browser used by the viewers during the play event. | [enum: videoId, emittedAt, country, deviceType, operatingSystem, browser]
**dimension** | **String**| Use this query parameter to define the dimension that you want analytics for. - `videoId`: Returns analytics based on the public video identifiers. - `emittedAt`: Returns analytics based on the times of the play events. The API returns data in specific interval groups. When the date period you set in `from` and `to` is less than or equals to 2 days, the response for this dimension is grouped in hourly intervals. Otherwise, it is grouped in daily intervals. - `country`: Returns analytics based on the viewers' country. The list of supported country names are based on the [GeoNames public database](https://www.geonames.org/countries/). - `deviceType`: Returns analytics based on the type of device used by the viewers during the play event. Possible response values are: `computer`, `phone`, `tablet`, `tv`, `console`, `wearable`, `unknown`. - `operatingSystem`: Returns analytics based on the operating system used by the viewers during the play event. Response values include `windows`, `mac osx`, `android`, `ios`, `linux`. - `browser`: Returns analytics based on the browser used by the viewers during the play event. Response values include `chrome`, `firefox`, `edge`, `opera`. | [enum: videoId, emittedAt, country, deviceType, operatingSystem, browser]
**to** | **LocalDate**| Use this optional query parameter to set the end date for the time period that you want analytics for. - If you do not specify a `to` date, the API returns analytics data starting from the `from` date up until today, and excluding today. - The date you set must be **within the last 30 days**. - The value you provide must follow the `YYYY-MM-DD` format. | [optional]
**filter** | **String**| Use this query parameter to filter your results to a specific video in a project that you want analytics for. You must use the `videoId:` prefix when specifying a video ID. | [optional]
**currentPage** | **Integer**| Choose the number of search results to return per page. Minimum value: 1 | [optional] [default to 1]
Expand Down
18 changes: 13 additions & 5 deletions src/main/java/video/api/client/api/clients/AnalyticsApi.java
Original file line number Diff line number Diff line change
Expand Up @@ -496,9 +496,13 @@ public void onDownloadProgress(long bytesRead, long contentLength, boolean done)
* Otherwise, it is grouped in daily intervals. - `country`: Returns analytics based on the
* viewers' country. The list of supported country names are based on the [GeoNames public
* database](https://www.geonames.org/countries/). - `deviceType`: Returns analytics based on
* the type of device used by the viewers during the play event. - `operatingSystem`: Returns
* analytics based on the operating system used by the viewers during the play event. -
* the type of device used by the viewers during the play event. Possible response values are:
* `computer`, `phone`, `tablet`, `tv`, `console`,
* `wearable`, `unknown`. - `operatingSystem`: Returns analytics based on
* the operating system used by the viewers during the play event. Response values include
* `windows`, `mac osx`, `android`, `ios`, `linux`. -
* `browser`: Returns analytics based on the browser used by the viewers during the play event.
* Response values include `chrome`, `firefox`, `edge`, `opera`.
* (required)
*
* @return APIgetLiveStreamsPlaysRequest
Expand Down Expand Up @@ -933,9 +937,13 @@ public void onDownloadProgress(long bytesRead, long contentLength, boolean done)
* `country`: Returns analytics based on the viewers' country. The list of supported
* country names are based on the [GeoNames public database](https://www.geonames.org/countries/). -
* `deviceType`: Returns analytics based on the type of device used by the viewers during the
* play event. - `operatingSystem`: Returns analytics based on the operating system used by the
* viewers during the play event. - `browser`: Returns analytics based on the browser used by
* the viewers during the play event. (required)
* play event. Possible response values are: `computer`, `phone`, `tablet`,
* `tv`, `console`, `wearable`, `unknown`. -
* `operatingSystem`: Returns analytics based on the operating system used by the viewers
* during the play event. Response values include `windows`, `mac osx`,
* `android`, `ios`, `linux`. - `browser`: Returns analytics
* based on the browser used by the viewers during the play event. Response values include
* `chrome`, `firefox`, `edge`, `opera`. (required)
*
* @return APIgetVideosPlaysRequest
*
Expand Down

0 comments on commit d0edeb6

Please sign in to comment.