Package video.api.client.api.clients

Class AnalyticsApi

  • public class AnalyticsApi
extends Object

    • Constructor Detail

      • AnalyticsApi

        public AnalyticsApi​(ApiClient apiClient)

      • AnalyticsApi

        public AnalyticsApi()
        Constructor for AnalyticsApi production environment where API key is not required.

      • AnalyticsApi

        public AnalyticsApi​(String basePath)
        Constructor for AnalyticsApi with custom API base path where API key is not required.
        Parameters:
        basePath - the api base path. Expected Environment.PRODUCTION.basePath (default) or Environment.SANDBOX.basePath.

      • AnalyticsApi

        public AnalyticsApi​(Environment environment)
        Constructor for AnalyticsApi with custom API base path where API key is not required.
        Parameters:
        environment - the target environment. Expected Environment.PRODUCTION (default) or Environment.SANDBOX.

      • AnalyticsApi

        public AnalyticsApi​(String apiKey,
                    String basePath)
        Constructor for AnalyticsApi with custom API base path
        Parameters:
        apiKey - the api key to use to authenticate to the API
        basePath - the api base path. Expected Environment.PRODUCTION.basePath (default) or Environment.SANDBOX.basePath.

      • AnalyticsApi

        public AnalyticsApi​(String apiKey,
                    Environment environment)
        Constructor for AnalyticsApi with custom API base path
        Parameters:
        apiKey - the api key to use to authenticate to the API
        environment - the target environment. Expected Environment.PRODUCTION (default) or Environment.SANDBOX.

    • Method Detail

      • getApiClient

        public ApiClient getApiClient()

      • setApiClient

        public void setApiClient​(ApiClient apiClient)

      • getAggregatedMetrics

        public AnalyticsApi.APIgetAggregatedMetricsRequest getAggregatedMetrics​(String metric,
                                                                        String aggregation)
        Retrieve aggregated metrics Retrieve time-based and countable metrics like average watch time or the number of impressions over a certain period of time.
        Parameters:
        metric - Use this path parameter to select a metric that you want analytics for. - `play` is the number of times your content has been played. You can use the aggregations `count`, `rate`, and `total` with the `play` metric. - `start` is the number of times playback was started. You can use the aggregation `count` with this metric. - `end` is the number of times playback has ended with the content watch until the end. You can use the aggregation `count` with this metric. - `impression` is the number of times your content has been loaded and was ready for playback. You can use the aggregation `count` with this metric. - `impression-time` is the time in milliseconds that your content was loading for until the first video frame is displayed. You can use the aggregations `average` and `sum` with this metric. - `watch-time` is the cumulative time in seconds that the user has spent watching your content. You can use the aggregations `average` and `sum` with this metric. (required)
        aggregation - Use this path parameter to define a way of collecting data for the metric that you want analytics for. - `count` returns the overall number of events for the `play` metric. - `rate` returns the ratio that calculates the number of plays your content receives divided by its impressions. This aggregation can be used only with the `play` metric. - `total` calculates the total number of events for the `play` metric. - `average` calculates an average value for the selected metric. - `sum` adds up the total value of the select metric. (required)
        Returns:
        APIgetAggregatedMetricsRequest
        Http Response Details:
        Status Code Description Response Headers
        200 Success * X-RateLimit-Limit - The request limit per minute.
        * X-RateLimit-Remaining - The number of available requests left for the current time window.
        * X-RateLimit-Retry-After - The number of seconds left until the current rate limit window resets.
        400 Bad request error * X-RateLimit-Limit - The request limit per minute.
        * X-RateLimit-Remaining - The number of available requests left for the current time window.
        * X-RateLimit-Retry-After - The number of seconds left until the current rate limit window resets.
        404 Unrecognized request URL * X-RateLimit-Limit - The request limit per minute.
        * X-RateLimit-Remaining - The number of available requests left for the current time window.
        * X-RateLimit-Retry-After - The number of seconds left until the current rate limit window resets.
        429 Too Many Requests * X-RateLimit-Limit - The request limit per minute.
        * X-RateLimit-Remaining - The number of available requests left for the current time window.
        * X-RateLimit-Retry-After - The number of seconds left until the current rate limit window resets.

      • getMetricsBreakdown

        public AnalyticsApi.APIgetMetricsBreakdownRequest getMetricsBreakdown​(String metric,
                                                                      String breakdown)
        Retrieve metrics in a breakdown of dimensions Retrieve detailed analytics play-rate and number of impressions segmented by dimensions like country or device type.
        Parameters:
        metric - Use this path parameter to select a metric that you want analytics for. - `play` is the number of times your content has been played. - `play-rate` is the ratio that calculates the number of plays your content receives divided by its impressions. - `play-total` is the total number of times a specific content has been played. You can only use the `media-id` breakdown with this metric. - `start` is the number of times playback was started. - `end` is the number of times playback has ended with the content watch until the end. - `impression` is the number of times your content has been loaded and was ready for playback. (required)
        breakdown - Use this path parameter to define a dimension for segmenting analytics data. You must use `kebab-case` for path parameters. These are the available dimensions: - `media-id`: Returns analytics based on the unique identifiers of a video or a live stream. - `media-type`: Returns analytics based on the type of content. Possible values: `video` and `live-stream`. - `continent`: Returns analytics based on the viewers' continent. The list of supported continents names are based on the [GeoNames public database](https://www.geonames.org/countries/). Possible values are: `AS`, `AF`, `NA`, `SA`, `AN`, `EU`, `AZ`. - `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/). - `device-type`: Returns analytics based on the type of device used by the viewers. Response values can include: `computer`, `phone`, `tablet`, `tv`, `console`, `wearable`, `unknown`. - `operating-system`: Returns analytics based on the operating system used by the viewers. Response values can include `windows`, `mac osx`, `android`, `ios`, `linux`. - `browser`: Returns analytics based on the browser used by the viewers. Response values can include `chrome`, `firefox`, `edge`, `opera`. (required)
        Returns:
        APIgetMetricsBreakdownRequest
        Http Response Details:
        Status Code Description Response Headers
        200 Success * X-RateLimit-Limit - The request limit per minute.
        * X-RateLimit-Remaining - The number of available requests left for the current time window.
        * X-RateLimit-Retry-After - The number of seconds left until the current rate limit window resets.
        400 Bad request error * X-RateLimit-Limit - The request limit per minute.
        * X-RateLimit-Remaining - The number of available requests left for the current time window.
        * X-RateLimit-Retry-After - The number of seconds left until the current rate limit window resets.
        404 Unrecognized request URL * X-RateLimit-Limit - The request limit per minute.
        * X-RateLimit-Remaining - The number of available requests left for the current time window.
        * X-RateLimit-Retry-After - The number of seconds left until the current rate limit window resets.
        429 Too Many Requests * X-RateLimit-Limit - The request limit per minute.
        * X-RateLimit-Remaining - The number of available requests left for the current time window.
        * X-RateLimit-Retry-After - The number of seconds left until the current rate limit window resets.

      • getMetricsOverTime

        public AnalyticsApi.APIgetMetricsOverTimeRequest getMetricsOverTime​(String metric)
        Retrieve metrics over time Retrieve countable metrics like the number of plays or impressions, grouped by the time at which they occurred
        Parameters:
        metric - Use this path parameter to select a metric that you want analytics for. - `play` is the number of times your content has been played. - `play-rate` is the ratio that calculates the number of plays your content receives divided by its impressions. - `start` is the number of times playback was started. - `end` is the number of times playback has ended with the content watch until the end. - `impression` is the number of times your content has been loaded and was ready for playback. (required)
        Returns:
        APIgetMetricsOverTimeRequest
        Http Response Details:
        Status Code Description Response Headers
        200 Success * X-RateLimit-Limit - The request limit per minute.
        * X-RateLimit-Remaining - The number of available requests left for the current time window.
        * X-RateLimit-Retry-After - The number of seconds left until the current rate limit window resets.
        400 Bad request error * X-RateLimit-Limit - The request limit per minute.
        * X-RateLimit-Remaining - The number of available requests left for the current time window.
        * X-RateLimit-Retry-After - The number of seconds left until the current rate limit window resets.
        404 Unrecognized request URL * X-RateLimit-Limit - The request limit per minute.
        * X-RateLimit-Remaining - The number of available requests left for the current time window.
        * X-RateLimit-Retry-After - The number of seconds left until the current rate limit window resets.
        429 Too Many Requests * X-RateLimit-Limit - The request limit per minute.
        * X-RateLimit-Remaining - The number of available requests left for the current time window.
        * X-RateLimit-Retry-After - The number of seconds left until the current rate limit window resets.