Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add sort parameters in analytics routes #121

Merged
merged 1 commit into from
Sep 5, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,9 @@
# Changelog
All changes to this project will be documented in this file.

## [1.4.1] - 2024-09-05
- Add sort parameters in analytics endpoints

## [1.4.0] - 2024-07-29
- Add new analytics methods
- Add livestream complete() method
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ Add this dependency to your project's POM:
<dependency>
<groupId>video.api</groupId>
<artifactId>java-api-client</artifactId>
<version>1.4.0</version>
<version>1.4.1</version>
<scope>compile</scope>
</dependency>
```
Expand All @@ -78,7 +78,7 @@ Add this dependency to your project's POM:
Add this dependency to your project's build file:

```groovy
implementation "video.api:java-api-client:1.4.0"
implementation "video.api:java-api-client:1.4.1"
```

#### Others
Expand All @@ -91,7 +91,7 @@ mvn clean package

Then manually install the following JARs:

* `target/java-api-client-1.4.0.jar`
* `target/java-api-client-1.4.1.jar`
* `target/lib/*.jar`

### Code sample
Expand Down
906 changes: 646 additions & 260 deletions api/openapi.yaml

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion build.gradle
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ apply plugin: 'com.diffplug.spotless'
apply plugin: 'maven-publish'

group = 'video.api'
version = '1.4.0'
version = '1.4.1'

buildscript {
repositories {
Expand Down
1 change: 1 addition & 0 deletions docs/AccessToken.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,5 +15,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/AdditionalBadRequestErrors.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,5 +15,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/AnalyticsAggregatedMetricsResponse.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,5 +13,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/AnalyticsAggregatedMetricsResponseContext.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,5 +39,6 @@ SUM | &quot;sum&quot;
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/AnalyticsAggregatedMetricsResponseContextTimeframe.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,5 +14,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


68 changes: 40 additions & 28 deletions docs/AnalyticsApi.md

Large diffs are not rendered by default.

1 change: 1 addition & 0 deletions docs/AnalyticsData.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,5 +13,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/AnalyticsMetricsBreakdownResponse.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,5 +14,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/AnalyticsMetricsBreakdownResponseContext.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,5 +40,6 @@ BROWSER | &quot;browser&quot;
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/AnalyticsMetricsBreakdownResponseData.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,5 +13,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/AnalyticsMetricsOverTimeResponse.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,5 +14,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/AnalyticsMetricsOverTimeResponseContext.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,5 +35,6 @@ DAY | &quot;day&quot;
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/AnalyticsMetricsOverTimeResponseData.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,5 +13,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/AnalyticsPlays400Error.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,5 +16,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/AnalyticsPlaysResponse.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,5 +13,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/AuthenticatePayload.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,5 +12,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/BadRequest.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,5 +16,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/BytesRange.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,5 +14,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/Caption.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,5 +16,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/CaptionsListResponse.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,5 +13,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/CaptionsUpdatePayload.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,5 +12,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/Chapter.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,5 +14,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/ChaptersListResponse.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,5 +13,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


15 changes: 8 additions & 7 deletions docs/FilterBy.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,13 @@

Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**mediaId** | **String** | Returns analytics based on the unique identifiers of a video or a live stream. | [optional]
**mediaId** | **List&lt;String&gt;** | Returns analytics based on the unique identifiers of a video or a live stream. | [optional]
**mediaType** | [**MediaTypeEnum**](#MediaTypeEnum) | | [optional]
**continent** | [**ContinentEnum**](#ContinentEnum) | Returns analytics based on the viewers&#39; continent. The list of supported continents names are based on the [GeoNames public database](https://www.geonames.org/countries/). You must use the ISO-3166 alpha2 format, for example &#x60;EU&#x60;. | [optional]
**country** | **String** | Returns analytics based on the viewers&#39; country. The list of supported country names are based on the [GeoNames public database](https://www.geonames.org/countries/). You must use the ISO-3166 alpha2 format, for example &#x60;FR&#x60;. | [optional]
**deviceType** | **String** | Returns analytics based on the type of device used by the viewers. Possible response values are: &#x60;computer&#x60;, &#x60;phone&#x60;, &#x60;tablet&#x60;, &#x60;tv&#x60;, &#x60;console&#x60;, &#x60;wearable&#x60;, &#x60;unknown&#x60;. | [optional]
**operatingSystem** | **String** | Returns analytics based on the operating system used by the viewers. Response values include &#x60;windows&#x60;, &#x60;mac osx&#x60;, &#x60;android&#x60;, &#x60;ios&#x60;, &#x60;linux&#x60;. | [optional]
**browser** | **String** | Returns analytics based on the browser used by the viewers. Response values include &#x60;chrome&#x60;, &#x60;firefox&#x60;, &#x60;edge&#x60;, &#x60;opera&#x60;. | [optional]
**continent** | [**List&lt;ContinentEnum&gt;**](#List&lt;ContinentEnum&gt;) | Returns analytics based on the viewers&#39; continent. The list of supported continents names are based on the [GeoNames public database](https://www.geonames.org/countries/). You must use the ISO-3166 alpha2 format, for example &#x60;EU&#x60;. | [optional]
**country** | **List&lt;String&gt;** | Returns analytics based on the viewers&#39; country. The list of supported country names are based on the [GeoNames public database](https://www.geonames.org/countries/). You must use the ISO-3166 alpha2 format, for example &#x60;FR&#x60;. | [optional]
**deviceType** | **List&lt;String&gt;** | Returns analytics based on the type of device used by the viewers. Response values can include: &#x60;computer&#x60;, &#x60;phone&#x60;, &#x60;tablet&#x60;, &#x60;tv&#x60;, &#x60;console&#x60;, &#x60;wearable&#x60;, &#x60;unknown&#x60;. | [optional]
**operatingSystem** | **List&lt;String&gt;** | Returns analytics based on the operating system used by the viewers. Response values can include &#x60;windows&#x60;, &#x60;mac osx&#x60;, &#x60;android&#x60;, &#x60;ios&#x60;, &#x60;linux&#x60;. | [optional]
**browser** | **List&lt;String&gt;** | Returns analytics based on the browser used by the viewers. Response values can include &#x60;chrome&#x60;, &#x60;firefox&#x60;, &#x60;edge&#x60;, &#x60;opera&#x60;. | [optional]
**tag** | **String** | Returns analytics for videos using this tag. This filter only accepts a single value and is case sensitive. Read more about tagging your videos [here](https://docs.api.video/vod/tags-metadata). | [optional]


Expand All @@ -26,7 +26,7 @@ LIVE_STREAM | &quot;live-stream&quot;



## Enum: ContinentEnum
## Enum: List&lt;ContinentEnum&gt;

Name | Value
---- | -----
Expand All @@ -42,5 +42,6 @@ AZ | &quot;AZ&quot;
## Implemented Interfaces

* Serializable
* DeepObject


15 changes: 8 additions & 7 deletions docs/FilterBy1.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,13 @@

Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**mediaId** | **String** | Returns analytics based on the unique identifiers of a video or a live stream. | [optional]
**mediaId** | **List&lt;String&gt;** | Returns analytics based on the unique identifiers of a video or a live stream. | [optional]
**mediaType** | [**MediaTypeEnum**](#MediaTypeEnum) | | [optional]
**continent** | [**ContinentEnum**](#ContinentEnum) | Returns analytics based on the viewers&#39; continent. The list of supported continents names are based on the [GeoNames public database](https://www.geonames.org/countries/). You must use the ISO-3166 alpha2 format, for example &#x60;EU&#x60;. | [optional]
**country** | **String** | Returns analytics based on the viewers&#39; country. The list of supported country names are based on the [GeoNames public database](https://www.geonames.org/countries/). You must use the ISO-3166 alpha2 format, for example &#x60;FR&#x60;. | [optional]
**deviceType** | **String** | Returns analytics based on the type of device used by the viewers. Possible response values are: &#x60;computer&#x60;, &#x60;phone&#x60;, &#x60;tablet&#x60;, &#x60;tv&#x60;, &#x60;console&#x60;, &#x60;wearable&#x60;, &#x60;unknown&#x60;. | [optional]
**operatingSystem** | **String** | Returns analytics based on the operating system used by the viewers. Response values include &#x60;windows&#x60;, &#x60;mac osx&#x60;, &#x60;android&#x60;, &#x60;ios&#x60;, &#x60;linux&#x60;. | [optional]
**browser** | **String** | Returns analytics based on the browser used by the viewers. Response values include &#x60;chrome&#x60;, &#x60;firefox&#x60;, &#x60;edge&#x60;, &#x60;opera&#x60;. | [optional]
**continent** | [**List&lt;ContinentEnum&gt;**](#List&lt;ContinentEnum&gt;) | Returns analytics based on the viewers&#39; continent. The list of supported continents names are based on the [GeoNames public database](https://www.geonames.org/countries/). You must use the ISO-3166 alpha2 format, for example &#x60;EU&#x60;. | [optional]
**country** | **List&lt;String&gt;** | Returns analytics based on the viewers&#39; country. The list of supported country names are based on the [GeoNames public database](https://www.geonames.org/countries/). You must use the ISO-3166 alpha2 format, for example &#x60;FR&#x60;. | [optional]
**deviceType** | **List&lt;String&gt;** | Returns analytics based on the type of device used by the viewers. Response values can include: &#x60;computer&#x60;, &#x60;phone&#x60;, &#x60;tablet&#x60;, &#x60;tv&#x60;, &#x60;console&#x60;, &#x60;wearable&#x60;, &#x60;unknown&#x60;. | [optional]
**operatingSystem** | **List&lt;String&gt;** | Returns analytics based on the operating system used by the viewers. Response values can include &#x60;windows&#x60;, &#x60;mac osx&#x60;, &#x60;android&#x60;, &#x60;ios&#x60;, &#x60;linux&#x60;. | [optional]
**browser** | **List&lt;String&gt;** | Returns analytics based on the browser used by the viewers. Response values can include &#x60;chrome&#x60;, &#x60;firefox&#x60;, &#x60;edge&#x60;, &#x60;opera&#x60;. | [optional]
**tag** | **String** | Returns analytics for videos using this tag. This filter only accepts a single value and is case sensitive. Read more about tagging your videos [here](https://docs.api.video/vod/tags-metadata). | [optional]


Expand All @@ -26,7 +26,7 @@ LIVE_STREAM | &quot;live-stream&quot;



## Enum: ContinentEnum
## Enum: List&lt;ContinentEnum&gt;

Name | Value
---- | -----
Expand All @@ -42,5 +42,6 @@ AZ | &quot;AZ&quot;
## Implemented Interfaces

* Serializable
* DeepObject


15 changes: 8 additions & 7 deletions docs/FilterBy2.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,13 @@

Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**mediaId** | **String** | Returns analytics based on the unique identifiers of a video or a live stream. | [optional]
**mediaId** | **List&lt;String&gt;** | Returns analytics based on the unique identifiers of a video or a live stream. | [optional]
**mediaType** | [**MediaTypeEnum**](#MediaTypeEnum) | | [optional]
**continent** | [**ContinentEnum**](#ContinentEnum) | Returns analytics based on the viewers&#39; continent. The list of supported continents names are based on the [GeoNames public database](https://www.geonames.org/countries/). You must use the ISO-3166 alpha2 format, for example &#x60;EU&#x60;. | [optional]
**country** | **String** | Returns analytics based on the viewers&#39; country. The list of supported country names are based on the [GeoNames public database](https://www.geonames.org/countries/). You must use the ISO-3166 alpha2 format, for example &#x60;FR&#x60;. | [optional]
**deviceType** | **String** | Returns analytics based on the type of device used by the viewers. Possible response values are: &#x60;computer&#x60;, &#x60;phone&#x60;, &#x60;tablet&#x60;, &#x60;tv&#x60;, &#x60;console&#x60;, &#x60;wearable&#x60;, &#x60;unknown&#x60;. | [optional]
**operatingSystem** | **String** | Returns analytics based on the operating system used by the viewers. Response values include &#x60;windows&#x60;, &#x60;mac osx&#x60;, &#x60;android&#x60;, &#x60;ios&#x60;, &#x60;linux&#x60;. | [optional]
**browser** | **String** | Returns analytics based on the browser used by the viewers. Response values include &#x60;chrome&#x60;, &#x60;firefox&#x60;, &#x60;edge&#x60;, &#x60;opera&#x60;. | [optional]
**continent** | [**List&lt;ContinentEnum&gt;**](#List&lt;ContinentEnum&gt;) | Returns analytics based on the viewers&#39; continent. The list of supported continents names are based on the [GeoNames public database](https://www.geonames.org/countries/). You must use the ISO-3166 alpha2 format, for example &#x60;EU&#x60;. | [optional]
**country** | **List&lt;String&gt;** | Returns analytics based on the viewers&#39; country. The list of supported country names are based on the [GeoNames public database](https://www.geonames.org/countries/). You must use the ISO-3166 alpha2 format, for example &#x60;FR&#x60;. | [optional]
**deviceType** | **List&lt;String&gt;** | Returns analytics based on the type of device used by the viewers. Response values can include: &#x60;computer&#x60;, &#x60;phone&#x60;, &#x60;tablet&#x60;, &#x60;tv&#x60;, &#x60;console&#x60;, &#x60;wearable&#x60;, &#x60;unknown&#x60;. | [optional]
**operatingSystem** | **List&lt;String&gt;** | Returns analytics based on the operating system used by the viewers. Response values can include &#x60;windows&#x60;, &#x60;mac osx&#x60;, &#x60;android&#x60;, &#x60;ios&#x60;, &#x60;linux&#x60;. | [optional]
**browser** | **List&lt;String&gt;** | Returns analytics based on the browser used by the viewers. Response values can include &#x60;chrome&#x60;, &#x60;firefox&#x60;, &#x60;edge&#x60;, &#x60;opera&#x60;. | [optional]
**tag** | **String** | Returns analytics for videos using this tag. This filter only accepts a single value and is case sensitive. Read more about tagging your videos [here](https://docs.api.video/vod/tags-metadata). | [optional]


Expand All @@ -26,7 +26,7 @@ LIVE_STREAM | &quot;live-stream&quot;



## Enum: ContinentEnum
## Enum: List&lt;ContinentEnum&gt;

Name | Value
---- | -----
Expand All @@ -42,5 +42,6 @@ AZ | &quot;AZ&quot;
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/Link.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,5 +13,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/LiveStream.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,5 +21,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/LiveStreamAssets.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,5 +15,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/LiveStreamCreationPayload.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,5 +15,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/LiveStreamListResponse.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,5 +13,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/LiveStreamUpdatePayload.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,5 +15,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/Metadata.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,5 +13,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/Model403ErrorSchema.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,5 +15,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/NotFound.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,5 +15,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/PaginationLink.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,5 +13,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/PlayerSessionEvent.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,5 +16,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/PlayerTheme.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,5 +31,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


1 change: 1 addition & 0 deletions docs/PlayerThemeAssets.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,5 +13,6 @@ Name | Type | Description | Notes
## Implemented Interfaces

* Serializable
* DeepObject


Loading
Loading