Skip to content

Commit 9458edf

Browse files
committed
[release] 3.2.0
1 parent 4041999 commit 9458edf

File tree

72 files changed

+3399
-134
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

72 files changed

+3399
-134
lines changed

.openapi-generator/FILES

+24
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@ docs/CreateAssetRequest.md
1616
docs/CreateLiveStreamRequest.md
1717
docs/CreatePlaybackIDRequest.md
1818
docs/CreatePlaybackIDResponse.md
19+
docs/CreatePlaybackRestrictionRequest.md
1920
docs/CreateSimulcastTargetRequest.md
2021
docs/CreateTrackRequest.md
2122
docs/CreateTrackResponse.md
@@ -91,12 +92,16 @@ docs/OverallValues.md
9192
docs/PlaybackID.md
9293
docs/PlaybackIDApi.md
9394
docs/PlaybackPolicy.md
95+
docs/PlaybackRestriction.md
96+
docs/PlaybackRestrictionResponse.md
97+
docs/PlaybackRestrictionsApi.md
9498
docs/RealTimeApi.md
9599
docs/RealTimeBreakdownValue.md
96100
docs/RealTimeHistogramTimeseriesBucket.md
97101
docs/RealTimeHistogramTimeseriesBucketValues.md
98102
docs/RealTimeHistogramTimeseriesDatapoint.md
99103
docs/RealTimeTimeseriesDatapoint.md
104+
docs/ReferrerDomainRestriction.md
100105
docs/Score.md
101106
docs/SignalLiveStreamCompleteResponse.md
102107
docs/SigningKey.md
@@ -107,7 +112,10 @@ docs/Track.md
107112
docs/URLSigningKeysApi.md
108113
docs/UpdateAssetMP4SupportRequest.md
109114
docs/UpdateAssetMasterAccessRequest.md
115+
docs/UpdateAssetRequest.md
110116
docs/UpdateLiveStreamEmbeddedSubtitlesRequest.md
117+
docs/UpdateLiveStreamRequest.md
118+
docs/UpdateReferrerDomainRestrictionRequest.md
111119
docs/Upload.md
112120
docs/UploadError.md
113121
docs/UploadResponse.md
@@ -128,6 +136,7 @@ mux_python/api/incidents_api.py
128136
mux_python/api/live_streams_api.py
129137
mux_python/api/metrics_api.py
130138
mux_python/api/playback_id_api.py
139+
mux_python/api/playback_restrictions_api.py
131140
mux_python/api/real_time_api.py
132141
mux_python/api/url_signing_keys_api.py
133142
mux_python/api/video_views_api.py
@@ -149,6 +158,7 @@ mux_python/models/create_asset_request.py
149158
mux_python/models/create_live_stream_request.py
150159
mux_python/models/create_playback_id_request.py
151160
mux_python/models/create_playback_id_response.py
161+
mux_python/models/create_playback_restriction_request.py
152162
mux_python/models/create_simulcast_target_request.py
153163
mux_python/models/create_track_request.py
154164
mux_python/models/create_track_response.py
@@ -214,11 +224,14 @@ mux_python/models/notification_rule.py
214224
mux_python/models/overall_values.py
215225
mux_python/models/playback_id.py
216226
mux_python/models/playback_policy.py
227+
mux_python/models/playback_restriction.py
228+
mux_python/models/playback_restriction_response.py
217229
mux_python/models/real_time_breakdown_value.py
218230
mux_python/models/real_time_histogram_timeseries_bucket.py
219231
mux_python/models/real_time_histogram_timeseries_bucket_values.py
220232
mux_python/models/real_time_histogram_timeseries_datapoint.py
221233
mux_python/models/real_time_timeseries_datapoint.py
234+
mux_python/models/referrer_domain_restriction.py
222235
mux_python/models/score.py
223236
mux_python/models/signal_live_stream_complete_response.py
224237
mux_python/models/signing_key.py
@@ -228,7 +241,10 @@ mux_python/models/simulcast_target_response.py
228241
mux_python/models/track.py
229242
mux_python/models/update_asset_master_access_request.py
230243
mux_python/models/update_asset_mp4_support_request.py
244+
mux_python/models/update_asset_request.py
231245
mux_python/models/update_live_stream_embedded_subtitles_request.py
246+
mux_python/models/update_live_stream_request.py
247+
mux_python/models/update_referrer_domain_restriction_request.py
232248
mux_python/models/upload.py
233249
mux_python/models/upload_error.py
234250
mux_python/models/upload_response.py
@@ -241,4 +257,12 @@ setup.cfg
241257
setup.py
242258
test-requirements.txt
243259
test/__init__.py
260+
test/test_create_playback_restriction_request.py
261+
test/test_playback_restriction.py
262+
test/test_playback_restriction_response.py
263+
test/test_playback_restrictions_api.py
264+
test/test_referrer_domain_restriction.py
265+
test/test_update_asset_request.py
266+
test/test_update_live_stream_request.py
267+
test/test_update_referrer_domain_restriction_request.py
244268
tox.ini

docs/Asset.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Name | Type | Description | Notes
1616
**per_title_encode** | **bool** | | [optional]
1717
**upload_id** | **str** | Unique identifier for the Direct Upload. This is an optional parameter added when the asset is created from a direct upload. | [optional]
1818
**is_live** | **bool** | Whether the asset is created from a live stream and the live stream is currently `active` and not in `idle` state. | [optional]
19-
**passthrough** | **str** | Arbitrary metadata set for the asset. Max 255 characters. | [optional]
19+
**passthrough** | **str** | Arbitrary user-supplied metadata set for the asset. Max 255 characters. | [optional]
2020
**live_stream_id** | **str** | Unique identifier for the live stream. This is an optional parameter added when the asset is created from a live stream. | [optional]
2121
**master** | [**AssetMaster**](AssetMaster.md) | | [optional]
2222
**master_access** | **str** | | [optional] [default to 'none']

docs/AssetsApi.md

+76
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ Method | HTTP request | Description
1414
[**get_asset_input_info**](AssetsApi.md#get_asset_input_info) | **GET** /video/v1/assets/{ASSET_ID}/input-info | Retrieve asset input info
1515
[**get_asset_playback_id**](AssetsApi.md#get_asset_playback_id) | **GET** /video/v1/assets/{ASSET_ID}/playback-ids/{PLAYBACK_ID} | Retrieve a playback ID
1616
[**list_assets**](AssetsApi.md#list_assets) | **GET** /video/v1/assets | List assets
17+
[**update_asset**](AssetsApi.md#update_asset) | **PATCH** /video/v1/assets/{ASSET_ID} | Update an Asset
1718
[**update_asset_master_access**](AssetsApi.md#update_asset_master_access) | **PUT** /video/v1/assets/{ASSET_ID}/master-access | Update master access
1819
[**update_asset_mp4_support**](AssetsApi.md#update_asset_mp4_support) | **PUT** /video/v1/assets/{ASSET_ID}/mp4-support | Update MP4 support
1920

@@ -753,6 +754,81 @@ Name | Type | Description | Notes
753754

754755
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
755756

757+
# **update_asset**
758+
> AssetResponse update_asset(asset_id, update_asset_request)
759+
760+
Update an Asset
761+
762+
Updates the details of an already-created Asset with the provided Asset ID. This currently supports only the `passthrough` field.
763+
764+
### Example
765+
766+
* Basic Authentication (accessToken):
767+
```python
768+
from __future__ import print_function
769+
import time
770+
import mux_python
771+
from mux_python.rest import ApiException
772+
from pprint import pprint
773+
# Defining the host is optional and defaults to https://api.mux.com
774+
# See configuration.py for a list of all supported configuration parameters.
775+
configuration = mux_python.Configuration(
776+
host = "https://api.mux.com"
777+
)
778+
779+
# The client must configure the authentication and authorization parameters
780+
# in accordance with the API server security policy.
781+
# Examples for each auth method are provided below, use the example that
782+
# satisfies your auth use case.
783+
784+
# Configure HTTP basic authorization: accessToken
785+
configuration = mux_python.Configuration(
786+
username = 'YOUR_USERNAME',
787+
password = 'YOUR_PASSWORD'
788+
)
789+
790+
# Enter a context with an instance of the API client
791+
with mux_python.ApiClient(configuration) as api_client:
792+
# Create an instance of the API class
793+
api_instance = mux_python.AssetsApi(api_client)
794+
asset_id = 'asset_id_example' # str | The asset ID.
795+
update_asset_request = {"passthrough":"Example"} # UpdateAssetRequest |
796+
797+
try:
798+
# Update an Asset
799+
api_response = api_instance.update_asset(asset_id, update_asset_request)
800+
pprint(api_response)
801+
except ApiException as e:
802+
print("Exception when calling AssetsApi->update_asset: %s\n" % e)
803+
```
804+
805+
### Parameters
806+
807+
Name | Type | Description | Notes
808+
------------- | ------------- | ------------- | -------------
809+
**asset_id** | **str**| The asset ID. |
810+
**update_asset_request** | [**UpdateAssetRequest**](UpdateAssetRequest.md)| |
811+
812+
### Return type
813+
814+
[**AssetResponse**](AssetResponse.md)
815+
816+
### Authorization
817+
818+
[accessToken](../README.md#accessToken)
819+
820+
### HTTP request headers
821+
822+
- **Content-Type**: application/json
823+
- **Accept**: application/json
824+
825+
### HTTP response details
826+
| Status code | Description | Response headers |
827+
|-------------|-------------|------------------|
828+
**200** | OK | - |
829+
830+
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
831+
756832
# **update_asset_master_access**
757833
> AssetResponse update_asset_master_access(asset_id, update_asset_master_access_request)
758834

docs/CreateAssetRequest.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Name | Type | Description | Notes
66
**input** | [**list[InputSettings]**](InputSettings.md) | An array of objects that each describe an input file to be used to create the asset. As a shortcut, input can also be a string URL for a file when only one input file is used. See `input[].url` for requirements. | [optional]
77
**playback_policy** | [**list[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]
88
**per_title_encode** | **bool** | | [optional]
9-
**passthrough** | **str** | 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]
9+
**passthrough** | **str** | Arbitrary user-supplied 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]
1010
**mp4_support** | **str** | 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]
1111
**normalize_audio** | **bool** | Normalize the audio track loudness level. This parameter is only applicable to on-demand (not live) assets. | [optional] [default to False]
1212
**master_access** | **str** | 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]

docs/CreateLiveStreamRequest.md

+3-2
Original file line numberDiff line numberDiff line change
@@ -9,8 +9,9 @@ Name | Type | Description | Notes
99
**passthrough** | **str** | | [optional]
1010
**audio_only** | **bool** | Force the live stream to only process the audio track when the value is set to true. Mux drops the video track if broadcasted. | [optional]
1111
**embedded_subtitles** | [**list[LiveStreamEmbeddedSubtitleSettings]**](LiveStreamEmbeddedSubtitleSettings.md) | Describe the embedded closed caption contents of the incoming live stream. | [optional]
12-
**reduced_latency** | **bool** | Latency is the time from when the streamer does something in real life to when you see it happen in the player. Set this if you want lower latency for your live stream. Note: Reconnect windows are incompatible with Reduced Latency and will always be set to zero (0) seconds. Read more here: https://mux.com/blog/reduced-latency-for-mux-live-streaming-now-available/ | [optional]
13-
**low_latency** | **bool** | Latency is the time from when the streamer does something in real life to when you see it happen in the player. Setting this option will enable compatibility with the LL-HLS specification for low-latency streaming. This typically has lower latency than Reduced Latency streams, and cannot be combined with Reduced Latency. Note: Reconnect windows are incompatible with Low Latency and will always be set to zero (0) seconds. | [optional]
12+
**reduced_latency** | **bool** | This field is deprecated. Please use latency_mode instead. Latency is the time from when the streamer transmits a frame of video to when you see it in the player. Set this if you want lower latency for your live stream. Note: Reconnect windows are incompatible with Reduced Latency and will always be set to zero (0) seconds. Read more here: https://mux.com/blog/reduced-latency-for-mux-live-streaming-now-available/ | [optional]
13+
**low_latency** | **bool** | This field is deprecated. Please use latency_mode instead. Latency is the time from when the streamer transmits a frame of video to when you see it in the player. Setting this option will enable compatibility with the LL-HLS specification for low-latency streaming. This typically has lower latency than Reduced Latency streams, and cannot be combined with Reduced Latency. Note: Reconnect windows are incompatible with Low Latency and will always be set to zero (0) seconds. | [optional]
14+
**latency_mode** | **str** | Latency is the time from when the streamer transmits a frame of video to when you see it in the player. Set this as an alternative to setting low latency or reduced latency flags. The Low Latency value is a beta feature. Note: Reconnect windows are incompatible with Reduced Latency and Low Latency and will always be set to zero (0) seconds. Read more here: https://mux.com/blog/introducing-low-latency-live-streaming/ | [optional]
1415
**test** | **bool** | Marks the live stream as a test live stream when the value is set to true. A test live stream can help evaluate the Mux Video APIs without incurring any cost. There is no limit on number of test live streams created. Test live streams are watermarked with the Mux logo and limited to 5 minutes. The test live stream is disabled after the stream is active for 5 mins and the recorded asset also deleted after 24 hours. | [optional]
1516
**simulcast_targets** | [**list[CreateSimulcastTargetRequest]**](CreateSimulcastTargetRequest.md) | | [optional]
1617

+10
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
# CreatePlaybackRestrictionRequest
2+
3+
## Properties
4+
Name | Type | Description | Notes
5+
------------ | ------------- | ------------- | -------------
6+
**referrer** | [**ReferrerDomainRestriction**](.md) | | [optional]
7+
8+
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
9+
10+

docs/CreateSimulcastTargetRequest.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
## Properties
44
Name | Type | Description | Notes
55
------------ | ------------- | ------------- | -------------
6-
**passthrough** | **str** | Arbitrary metadata set by you when creating a simulcast target. | [optional]
6+
**passthrough** | **str** | Arbitrary user-supplied metadata set by you when creating a simulcast target. | [optional]
77
**stream_key** | **str** | Stream Key represents a stream identifier on the third party live streaming service to send the parent live stream to. | [optional]
88
**url** | **str** | RTMP hostname including application name for the third party live streaming service. Example: 'rtmp://live.example.com/app'. |
99

docs/CreateTrackRequest.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Name | Type | Description | Notes
99
**language_code** | **str** | The language code value must be a valid BCP 47 specification compliant value. For example, en for English or en-US for the US version of English. |
1010
**name** | **str** | The name of the track containing a human-readable description. This value must be unique across all the text type and subtitles text type tracks. HLS manifest will associate subtitle text track with this value. For example, set the value to \"English\" for subtitles text track with language_code as en-US. If this parameter is not included, Mux will auto-populate based on the language_code value. | [optional]
1111
**closed_captions** | **bool** | Indicates the track provides Subtitles for the Deaf or Hard-of-hearing (SDH). | [optional]
12-
**passthrough** | **str** | Arbitrary metadata set for the track either when creating the asset or track. | [optional]
12+
**passthrough** | **str** | Arbitrary user-supplied metadata set for the track either when creating the asset or track. | [optional]
1313

1414
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
1515

docs/DeliveryUsageApi.md

+6-4
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ Method | HTTP request | Description
88

99

1010
# **list_delivery_usage**
11-
> ListDeliveryUsageResponse list_delivery_usage(page=page, limit=limit, asset_id=asset_id, timeframe=timeframe)
11+
> ListDeliveryUsageResponse list_delivery_usage(page=page, limit=limit, asset_id=asset_id, live_stream_id=live_stream_id, timeframe=timeframe)
1212
1313
List Usage
1414

@@ -46,12 +46,13 @@ with mux_python.ApiClient(configuration) as api_client:
4646
api_instance = mux_python.DeliveryUsageApi(api_client)
4747
page = 1 # int | Offset by this many pages, of the size of `limit` (optional) (default to 1)
4848
limit = 100 # int | Number of items to include in the response (optional) (default to 100)
49-
asset_id = 'asset_id_example' # str | Filter response to return delivery usage for this asset only. (optional)
49+
asset_id = 'asset_id_example' # str | Filter response to return delivery usage for this asset only. You cannot specify both the `asset_id` and `live_stream_id` parameters together. (optional)
50+
live_stream_id = 'live_stream_id_example' # str | Filter response to return delivery usage for assets for this live stream. You cannot specify both the `asset_id` and `live_stream_id` parameters together. (optional)
5051
timeframe = ['timeframe_example'] # list[str] | Time window to get delivery usage information. timeframe[0] indicates the start time, timeframe[1] indicates the end time in seconds since the Unix epoch. Default time window is 1 hour representing usage from 13th to 12th hour from when the request is made. (optional)
5152

5253
try:
5354
# List Usage
54-
api_response = api_instance.list_delivery_usage(page=page, limit=limit, asset_id=asset_id, timeframe=timeframe)
55+
api_response = api_instance.list_delivery_usage(page=page, limit=limit, asset_id=asset_id, live_stream_id=live_stream_id, timeframe=timeframe)
5556
pprint(api_response)
5657
except ApiException as e:
5758
print("Exception when calling DeliveryUsageApi->list_delivery_usage: %s\n" % e)
@@ -63,7 +64,8 @@ Name | Type | Description | Notes
6364
------------- | ------------- | ------------- | -------------
6465
**page** | **int**| Offset by this many pages, of the size of `limit` | [optional] [default to 1]
6566
**limit** | **int**| Number of items to include in the response | [optional] [default to 100]
66-
**asset_id** | **str**| Filter response to return delivery usage for this asset only. | [optional]
67+
**asset_id** | **str**| Filter response to return delivery usage for this asset only. You cannot specify both the `asset_id` and `live_stream_id` parameters together. | [optional]
68+
**live_stream_id** | **str**| Filter response to return delivery usage for assets for this live stream. You cannot specify both the `asset_id` and `live_stream_id` parameters together. | [optional]
6769
**timeframe** | [**list[str]**](str.md)| Time window to get delivery usage information. timeframe[0] indicates the start time, timeframe[1] indicates the end time in seconds since the Unix epoch. Default time window is 1 hour representing usage from 13th to 12th hour from when the request is made. | [optional]
6870

6971
### Return type

0 commit comments

Comments
 (0)