[release] 0.14.0

Author: eropple

api_assets.go

@@ -666,8 +666,10 @@ func (a *AssetsApiService) GetAssetPlaybackId(aSSETID string, pLAYBACKID string,
 }
 
 type ListAssetsParams struct {
-	Limit int32
-	Page  int32
+	Limit        int32
+	Page         int32
+	LiveStreamId string
+	UploadId     string
 }
 
 // ListAssets optionally accepts the APIOption of WithParams(*ListAssetsParams).
@@ -704,6 +706,12 @@ func (a *AssetsApiService) ListAssets(opts ...APIOption) (ListAssetsResponse, er
 	if localVarOptionals != nil && isSet(localVarOptionals.Page) {
 		localVarQueryParams.Add("page", parameterToString(localVarOptionals.Page, ""))
 	}
+	if localVarOptionals != nil && isSet(localVarOptionals.LiveStreamId) {
+		localVarQueryParams.Add("live_stream_id", parameterToString(localVarOptionals.LiveStreamId, ""))
+	}
+	if localVarOptionals != nil && isSet(localVarOptionals.UploadId) {
+		localVarQueryParams.Add("upload_id", parameterToString(localVarOptionals.UploadId, ""))
+	}
 	// to determine the Content-Type header
 	localVarHttpContentTypes := []string{}
 

api_exports.go

@@ -84,3 +84,77 @@ func (a *ExportsApiService) ListExports(opts ...APIOption) (ListExportsResponse,
 
 	return localVarReturnValue, nil
 }
+
+func (a *ExportsApiService) ListExportsViews(opts ...APIOption) (ListVideoViewExportsResponse, error) {
+	var (
+		localVarAPIOptions   = new(APIOptions)
+		localVarHttpMethod   = strings.ToUpper("Get")
+		localVarPostBody     interface{}
+		localVarFormFileName string
+		localVarFileName     string
+		localVarFileBytes    []byte
+		localVarReturnValue  ListVideoViewExportsResponse
+	)
+
+	for _, opt := range opts {
+		opt(localVarAPIOptions)
+	}
+
+	// create path and map variables
+	localVarPath := a.client.cfg.basePath + "/data/v1/exports/views"
+
+	localVarHeaderParams := make(map[string]string)
+	localVarQueryParams := url.Values{}
+	localVarFormParams := url.Values{}
+
+	// to determine the Content-Type header
+	localVarHttpContentTypes := []string{}
+
+	// set Content-Type header
+	localVarHttpContentType := selectHeaderContentType(localVarHttpContentTypes)
+	if localVarHttpContentType != "" {
+		localVarHeaderParams["Content-Type"] = localVarHttpContentType
+	}
+
+	// to determine the Accept header
+	localVarHttpHeaderAccepts := []string{"application/json"}
+
+	// set Accept header
+	localVarHttpHeaderAccept := selectHeaderAccept(localVarHttpHeaderAccepts)
+	if localVarHttpHeaderAccept != "" {
+		localVarHeaderParams["Accept"] = localVarHttpHeaderAccept
+	}
+
+	r, err := a.client.prepareRequest(localVarAPIOptions, localVarPath, localVarHttpMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, localVarFormFileName, localVarFileName, localVarFileBytes)
+	if err != nil {
+		return localVarReturnValue, err
+	}
+
+	localVarHttpResponse, err := a.client.callAPI(r)
+	if err != nil || localVarHttpResponse == nil {
+		return localVarReturnValue, err
+	}
+
+	localVarBody, err := ioutil.ReadAll(localVarHttpResponse.Body)
+	localVarHttpResponse.Body.Close()
+	if err != nil {
+		return localVarReturnValue, err
+	}
+
+	// Check for common HTTP error status codes
+	err = CheckForHttpError(localVarHttpResponse.StatusCode, localVarBody)
+	if err != nil {
+		return localVarReturnValue, err
+	}
+
+	err = a.client.decode(&localVarReturnValue, localVarBody, localVarHttpResponse.Header.Get("Content-Type"))
+	if err != nil {
+		newErr := GenericOpenAPIError{
+			body:  localVarBody,
+			error: err.Error(),
+		}
+		return localVarReturnValue, newErr
+	}
+
+	return localVarReturnValue, nil
+}

api_live_streams.go

@@ -741,8 +741,9 @@ func (a *LiveStreamsApiService) GetLiveStreamSimulcastTarget(lIVESTREAMID string
 }
 
 type ListLiveStreamsParams struct {
-	Limit int32
-	Page  int32
+	Limit     int32
+	Page      int32
+	StreamKey string
 }
 
 // ListLiveStreams optionally accepts the APIOption of WithParams(*ListLiveStreamsParams).
@@ -779,6 +780,9 @@ func (a *LiveStreamsApiService) ListLiveStreams(opts ...APIOption) (ListLiveStre
 	if localVarOptionals != nil && isSet(localVarOptionals.Page) {
 		localVarQueryParams.Add("page", parameterToString(localVarOptionals.Page, ""))
 	}
+	if localVarOptionals != nil && isSet(localVarOptionals.StreamKey) {
+		localVarQueryParams.Add("stream_key", parameterToString(localVarOptionals.StreamKey, ""))
+	}
 	// to determine the Content-Type header
 	localVarHttpContentTypes := []string{}
 

api_real_time.go

@@ -125,7 +125,7 @@ type GetRealtimeHistogramTimeseriesParams struct {
 }
 
 // GetRealtimeHistogramTimeseries optionally accepts the APIOption of WithParams(*GetRealtimeHistogramTimeseriesParams).
-func (a *RealTimeApiService) GetRealtimeHistogramTimeseries(rEALTIMEMETRICID string, opts ...APIOption) (GetRealTimeHistogramTimeseriesResponse, error) {
+func (a *RealTimeApiService) GetRealtimeHistogramTimeseries(rEALTIMEHISTOGRAMMETRICID string, opts ...APIOption) (GetRealTimeHistogramTimeseriesResponse, error) {
 	var (
 		localVarAPIOptions   = new(APIOptions)
 		localVarHttpMethod   = strings.ToUpper("Get")
@@ -146,8 +146,8 @@ func (a *RealTimeApiService) GetRealtimeHistogramTimeseries(rEALTIMEMETRICID str
 	}
 
 	// create path and map variables
-	localVarPath := a.client.cfg.basePath + "/data/v1/realtime/metrics/{REALTIME_METRIC_ID}/histogram-timeseries"
-	localVarPath = strings.Replace(localVarPath, "{"+"REALTIME_METRIC_ID"+"}", fmt.Sprintf("%v", rEALTIMEMETRICID), -1)
+	localVarPath := a.client.cfg.basePath + "/data/v1/realtime/metrics/{REALTIME_HISTOGRAM_METRIC_ID}/histogram-timeseries"
+	localVarPath = strings.Replace(localVarPath, "{"+"REALTIME_HISTOGRAM_METRIC_ID"+"}", fmt.Sprintf("%v", rEALTIMEHISTOGRAMMETRICID), -1)
 
 	localVarHeaderParams := make(map[string]string)
 	localVarQueryParams := url.Values{}

docs/Asset.md

@@ -3,18 +3,18 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**Id** | **string** | Unique identifier for the Asset. | [optional] 
-**CreatedAt** | **string** | Time at which the object was created. Measured in seconds since the Unix epoch. | [optional] 
-**DeletedAt** | **string** |  | [optional] 
+**Id** | **string** | Unique identifier for the Asset. Max 255 characters. | [optional] 
+**CreatedAt** | **string** | Time the Asset was created, defined as a Unix timestamp (seconds since epoch). | [optional] 
 **Status** | **string** | The status of the asset. | [optional] 
-**Duration** | **float64** | The duration of the asset in seconds (max duration for a single asset is 24 hours). | [optional] 
+**Duration** | **float64** | The duration of the asset in seconds (max duration for a single asset is 12 hours). | [optional] 
 **MaxStoredResolution** | **string** | The maximum resolution that has been stored for the asset. The asset may be delivered at lower resolutions depending on the device and bandwidth, however it cannot be delivered at a higher value than is stored. | [optional] 
-**MaxStoredFrameRate** | **float64** | The maximum frame rate that has been stored for the asset. The asset may be delivered at lower frame rates depending on the device and bandwidth, however it cannot be delivered at a higher value than is stored. This field may return -1 if the frame rate of the input cannot be reliably determined.  | [optional] 
+**MaxStoredFrameRate** | **float64** | The maximum frame rate that has been stored for the asset. The asset may be delivered at lower frame rates depending on the device and bandwidth, however it cannot be delivered at a higher value than is stored. This field may return -1 if the frame rate of the input cannot be reliably determined. | [optional] 
 **AspectRatio** | **string** | The aspect ratio of the asset in the form of `width:height`, for example `16:9`. | [optional] 
-**PlaybackIds** | [**[]PlaybackId**](PlaybackID.md) |  | [optional] 
-**Tracks** | [**[]Track**](Track.md) |  | [optional] 
+**PlaybackIds** | [**[]PlaybackId**](PlaybackID.md) | An array of Playback ID objects. Use these to create HLS playback URLs. See [Play your videos](https://docs.mux.com/guides/video/play-your-videos) for more details. | [optional] 
+**Tracks** | [**[]Track**](Track.md) | The individual media tracks that make up an asset. | [optional] 
 **Errors** | [**AssetErrors**](Asset_errors.md) |  | [optional] 
 **PerTitleEncode** | **bool** |  | [optional] 
+**UploadId** | **string** | Unique identifier for the Direct Upload. This is an optional parameter added when the asset is created from a direct upload. | [optional] 
 **IsLive** | **bool** | Whether the asset is created from a live stream and the live stream is currently `active` and not in `idle` state. | [optional] 
 **Passthrough** | **string** | Arbitrary metadata set for the asset. Max 255 characters. | [optional] 
 **LiveStreamId** | **string** | Unique identifier for the live stream. This is an optional parameter added when the asset is created from a live stream. | [optional] 
@@ -26,7 +26,7 @@ Name | Type | Description | Notes
 **StaticRenditions** | [**AssetStaticRenditions**](Asset_static_renditions.md) |  | [optional] 
 **RecordingTimes** | [**[]AssetRecordingTimes**](Asset_recording_times.md) | An array of individual live stream recording sessions. A recording session is created on each encoder connection during the live stream | [optional] 
 **NonStandardInputReasons** | [**AssetNonStandardInputReasons**](Asset_non_standard_input_reasons.md) |  | [optional] 
-**Test** | **bool** | Indicates this asset is a test asset if the value is `true`. A Test asset can help evaluate the Mux Video APIs without incurring any cost. There is no limit on number of test assets created. Test assets are watermarked with the Mux logo, limited to 10 seconds, and deleted after 24 hrs. | [optional] 
+**Test** | **bool** | True means this live stream is a test asset. A test asset can help evaluate the Mux Video APIs without incurring any cost. There is no limit on number of test assets created. Test assets are watermarked with the Mux logo, limited to 10 seconds, and deleted after 24 hrs. | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

docs/AssetMaster.md

@@ -4,7 +4,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **Status** | **string** |  | [optional] 
-**Url** | **string** |  | [optional] 
+**Url** | **string** | The temporary URL to the master version of the video, as an MP4 file. This URL will expire after 24 hours. | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

docs/AssetNonStandardInputReasons.md

@@ -3,11 +3,11 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**VideoCodec** | **string** | The video codec used on the input file. | [optional] 
-**AudioCodec** | **string** | The audio codec used on the input file. | [optional] 
-**VideoGopSize** | **string** | The video key frame Interval (also called as Group of Picture or GOP) of the input file. | [optional] 
-**VideoFrameRate** | **string** | The video frame rate of the input file. | [optional] 
-**VideoResolution** | **string** | The video resolution of the input file. | [optional] 
+**VideoCodec** | **string** | The video codec used on the input file. For example, the input file encoded with `hevc` video codec is non-standard and the value of this parameter is `hevc`. | [optional] 
+**AudioCodec** | **string** | The audio codec used on the input file. Non-AAC audio codecs are non-standard. | [optional] 
+**VideoGopSize** | **string** | The video key frame Interval (also called as Group of Picture or GOP) of the input file is `high`. This parameter is present when the gop is greater than 10 seconds. | [optional] 
+**VideoFrameRate** | **string** | The video frame rate of the input file. Video with average frames per second (fps) less than 10 or greater than 120 is non-standard. A `-1` frame rate value indicates Mux could not determine the frame rate of the video track. | [optional] 
+**VideoResolution** | **string** | The video resolution of the input file. Video resolution higher than 2048 pixels on any one dimension (height or width) is considered non-standard, The resolution value is presented as `width` x `height` in pixels. | [optional] 
 **PixelAspectRatio** | **string** | The video pixel aspect ratio of the input file. | [optional] 
 **VideoEditList** | **string** | Video Edit List reason indicates that the input file's video track contains a complex Edit Decision List. | [optional] 
 **AudioEditList** | **string** | Audio Edit List reason indicates that the input file's audio track contains a complex Edit Decision List. | [optional] 

docs/AssetStaticRenditions.md

@@ -4,7 +4,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **Status** | **string** | Indicates the status of downloadable MP4 versions of this asset. | [optional] [default to STATUS_DISABLED]
-**Files** | [**[]AssetStaticRenditionsFiles**](Asset_static_renditions_files.md) |  | [optional] 
+**Files** | [**[]AssetStaticRenditionsFiles**](Asset_static_renditions_files.md) | Array of file objects. | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

docs/AssetStaticRenditionsFiles.md

@@ -8,7 +8,7 @@ Name | Type | Description | Notes
 **Height** | **int32** | The height of the static rendition's file in pixels | [optional] 
 **Width** | **int32** | The width of the static rendition's file in pixels | [optional] 
 **Bitrate** | **int64** | The bitrate in bits per second | [optional] 
-**Filesize** | **string** |  | [optional] 
+**Filesize** | **string** | The file size in bytes | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

docs/AssetsApi.md

@@ -22,7 +22,7 @@ Method | HTTP request | Description
 > AssetResponse CreateAsset(ctx, createAssetRequest)
 Create an asset
 
-Create a new Mux Video asset. 
+Create a new Mux Video asset.
 
 ### Required Parameters
 
@@ -104,7 +104,7 @@ Name | Type | Description  | Notes
 > DeleteAsset(ctx, aSSETID)
 Delete an asset
 
-Deletes a video asset and all its data 
+Deletes a video asset and all its data.
 
 ### Required Parameters
 
@@ -269,7 +269,7 @@ Name | Type | Description  | Notes
 > ListAssetsResponse ListAssets(ctx, optional)
 List assets
 
-List all Mux assets. 
+List all Mux assets.
 
 ### Required Parameters
 
@@ -285,6 +285,8 @@ Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **limit** | **optional.Int32**| Number of items to include in the response | [default to 25]
  **page** | **optional.Int32**| Offset by this many pages, of the size of `limit` | [default to 1]
+ **liveStreamId** | **optional.String**| Filter response to return all the assets for this live stream only | 
+ **uploadId** | **optional.String**| Filter response to return an asset created from this direct upload only | 
 
 ### Return type
 
@@ -305,7 +307,7 @@ Name | Type | Description  | Notes
 > AssetResponse UpdateAssetMasterAccess(ctx, aSSETID, updateAssetMasterAccessRequest)
 Update master access
 
-Allows you add temporary access to the master (highest-quality) version of the asset in MP4 format. A URL will be created that can be used to download the master version for 24 hours. After 24 hours Master Access will revert to \"none\". This master version is not optimized for web and not meant to be streamed, only downloaded for purposes like archiving or editing the video offline.
+Allows you to add temporary access to the master (highest-quality) version of the asset in MP4 format. A URL will be created that can be used to download the master version for 24 hours. After 24 hours Master Access will revert to \"none\". This master version is not optimized for web and not meant to be streamed, only downloaded for purposes like archiving or editing the video offline.
 
 ### Required Parameters
 
@@ -334,7 +336,7 @@ Name | Type | Description  | Notes
 > AssetResponse UpdateAssetMp4Support(ctx, aSSETID, updateAssetMp4SupportRequest)
 Update MP4 support
 
-Allows you add or remove mp4 support for assets that were created without it. Currently there are two values supported in this request, `standard` and `none`. `none` means that an asset *does not* have mp4 support, so submitting a request with `mp4_support` set to `none` will delete the mp4 assets from the asset in question.
+Allows you to add or remove mp4 support for assets that were created without it. Currently there are two values supported in this request, `standard` and `none`. `none` means that an asset *does not* have mp4 support, so submitting a request with `mp4_support` set to `none` will delete the mp4 assets from the asset in question.
 
 ### Required Parameters
 

docs/CreateAssetRequest.md

@@ -7,9 +7,9 @@ Name | Type | Description | Notes
 **PlaybackPolicy** | [**[]PlaybackPolicy**](PlaybackPolicy.md) | An array of playback policy names that you want applied to this asset and available through `playback_ids`. Options include: `\"public\"` (anyone with the playback URL can stream the asset). And `\"signed\"` (an additional access token is required to play the asset). If no playback_policy is set, the asset will have no playback IDs and will therefore not be playable. For simplicity, a single string name can be used in place of the array in the case of only one playback policy. | [optional] 
 **PerTitleEncode** | **bool** |  | [optional] 
 **Passthrough** | **string** | Arbitrary metadata that will be included in the asset details and related webhooks. Can be used to store your own ID for a video along with the asset. **Max: 255 characters**. | [optional] 
-**Mp4Support** | **string** | Specify what level (if any) of support for mp4 playback. In most cases you should use our default HLS-based streaming playback ({playback_id}.m3u8) which can automatically adjust to viewers' connection speeds, but an mp4 can be useful for some legacy devices or downloading for offline playback. See the [Download your vidoes guide](/guides/video/download-your-videos) for more information. | [optional] 
+**Mp4Support** | **string** | Specify what level (if any) of support for mp4 playback. In most cases you should use our default HLS-based streaming playback ({playback_id}.m3u8) which can automatically adjust to viewers' connection speeds, but an mp4 can be useful for some legacy devices or downloading for offline playback. See the [Download your videos guide](/guides/video/download-your-videos) for more information. | [optional] 
 **NormalizeAudio** | **bool** | Normalize the audio track loudness level. This parameter is only applicable to on-demand (not live) assets. | [optional] [default to false]
-**MasterAccess** | **string** | Specify what level (if any) of support for master access. Master access can be enabled temporarily for your asset to be downloaded. See the [Download your vidoes guide](/guides/video/download-your-videos) for more information. | [optional] 
+**MasterAccess** | **string** | Specify what level (if any) of support for master access. Master access can be enabled temporarily for your asset to be downloaded. See the [Download your videos guide](/guides/video/download-your-videos) for more information. | [optional] 
 **Test** | **bool** | Marks the asset as a test asset when the value is set to true. A Test asset can help evaluate the Mux Video APIs without incurring any cost. There is no limit on number of test assets created. Test asset are watermarked with the Mux logo, limited to 10 seconds, deleted after 24 hrs. | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)