Release notes for server operation SDKs - ApsaraVideo VOD

This topic describes the release notes for server operation SDKs.

Note

For more information about how to download the latest versions of ApsaraVideo VOD server operation SDKs, see SDK overview and download.

2023-03-02

Release date	Version	Description
2023-03-02	2.16.14	The Interval request parameter is added to the DescribeVodDomainUsageData operation.

2022-12-05

Release date

Version

Description

2022-12-05

2.16.13

The following operations related to data monitoring are added:

DescribeVodDomainSrcTrafficData
DescribeVodDomainSrcBpsData

2022-10-27

Release date	Version	Description
2022-10-27	2.16.11	The OriginalFileName field is added to the CreateUploadImage operation.

2022-08-25

Release date	Version	Description
2022-08-25	2.16.10	The GetImageInfos operation is added. The following operations related to HTTP-Live-Streaming (HLS) encryption are added: DecryptKMSDataKey GenerateKMSDataKey

2022-07-21

Release date	Version	Description
2022-07-21	2.16.8	The following operations related to media upload are added: UploadStreamByURL CancelUrlUploadJobs The following operations related to media refresh and prefetch are added: RefreshMediaPlayUrls GetMediaRefreshJobs

2020-09-24

Release date	Version	Description
2020-09-24	2.15.12	The SubmitAIImageAuditJob operation is added. The DNADBId parameter is added as a nested parameter under the Config parameter of the SubmitAIJob operation.

2020-09-10

Release date	Version	Description
2020-09-10	2.15.11	The support for the China (Beijing) region is added. We recommend that you use the latest versions of server upload SDKs. The SubmitAIImageJob, GetAIImageJobs, and ListAIImageInfo operations are added. The ListDynamicImage operation is added. The MediaAuditConfiguration parameter is added to the SubmitAIMediaAuditJob operation. The ResourceType parameter is nested under the MediaAuditConfiguration parameter so that you can apply different review specifications and standards to different types of videos.

2020-06-22

Release date	Version	Description
2020-06-22	2.15.10	The support for the China (Shenzhen) region is added. We recommend that you use the latest versions of server upload SDKs.

2020-06-04

Release date	Version	Description
2020-06-04	2.15.9	The SubmitMediaDNADeleteJob and ListMediaDNADeleteJob operations are added. The ad violation detection, logo detection, and undesirable scene detection results can be returned by the GetMediaAuditResult operation. The ad violation detection, logo detection, and undesirable scene detection results can be returned by the GetMediaAuditResultTimeline operation.

2019-10-23

Release date	Version	Description
2019-10-23	2.15.8	The SubmitDynamicImageJob operation is added. You can capture a video clip as a GIF or WebP image. The SubmitWorkflowJob operation is added. You can initiate a workflow to process audio and video files. The AuditStatus field is added to the ImageInfo parameter returned in the response to the GetImageInfo operation. The data type of the StorageLocation parameter returned in the response to the GetAttachedMediaInfo operation is changed to String. The MediaType parameter is added as a request parameter of the SubmitAIMediaAuditJob operation.

2019-06-24

Release date	Version	Description
2019-06-24	2.15.5	The following seven operations are added to manage domain names: AddVodDomain UpdateVodDomain DeleteVodDomain BatchStartVodDomain BatchStopVodDomain DescribeVodUserDomains DescribeVodDomainDetail The following six operations are added to configure domain names: BatchSetVodDomainConfigs DescribeVodDomainConfigs DeleteVodSpecificConfig SetVodDomainCertificate DescribeVodCertificateList DescribeVodDomainCertificateInfo The operations related to templates and watermarks, such as AddTranscodeTemplateGroup, GetTranscodeTemplateGroup, ListTranscodeTemplateGroup, AddWatermark, GetWatermark, ListWatermark, and UploadMediaByURL, can be used in multiple applications. The `UserData` parameter is added to the SubmitTranscodeJobs operation. UserData is a user-defined extended field, which is transparently transmitted during an event callback.

2019-05-16

Release date	Version	Description
2019-05-16	2.15.3	The following four operations are added to query resource usage: DescribeVodDomainUsageData DescribeVodStorageData DescribeVodTranscodeData DescribeVodAIData The GetUploadDetails operation is added. The GetAIVideoTagResult operation is added. The `RegionId` parameter is added to the responses to the GetAttachedMediaInfo and GetImageInfo operations. The `Icon` and `OnlineStatus` parameters are added to the SearchMedia, GetAttachedMediaInfo, and CreateUploadAttachedMedia operations for you to manage short video materials. The `UserData` parameter is added to the SubmitSnapshotJob operation. UserData is a user-defined extended field, which is transparently transmitted during an event callback.

2019-04-11

Release date	Version	Description
2019-04-11	2.15.2	The following nine operations are added to manage applications and their permissions: CreateAppInfo GetAppInfos ListAppInfo UpdateAppInfo DeleteAppInfo AttachAppPolicyToIdentity DetachAppPolicyFromIdentity ListAppPoliciesForIdentity MoveAppResource The following three operations are added to configure callbacks: SetMessageCallback GetMessageCallback DeleteMessageCallback The following three operations related to auxiliary media assets are added: GetAttachedMedia UpdateAttachedMediaInfos DeleteAttachedMedia The DeleteMultipartUpload operation is added. The operations related to media upload and media asset management are supported for multiple applications. The `AppId` parameter is added to the operations related to media upload and query, such as CreateUploadVideo and SearchMedia. The `NonExistVideoIds` and `ForbiddenVideoIds` parameters are added to the DeleteVideo operation. The `ForbiddenVideoIds` parameter is added to the UpdateVideoInfos operation. Online editing is supported in multiple regions and can be applied to multiple types of materials. The `StorageLocation` and `RegionId` parameters are added to the response to the GetEditingProject operation. The `StorageLocation`, `RegionId`, and `Duration` parameters are added to the response to the SearchEditingProject operation. The `MaterialType` parameter is added as a request parameter of the GetEditingProjectMaterials operation. Custom file paths are supported for transcoding. The `TranscodeFileRegular`, `Clip`, and `Rotate` parameters are added to the response to the GetTranscodeTemplateGroup operation. The `AttachedMedia` parameter is added to the response to the SearchMedia operation. The `SubTotal` parameter is added to the response to the GetCategories operation.

2019-02-28

Release date	Version	Description
2019-02-28	2.15.1	The following three operations are added to query video transcoding information: GetTranscodeSummary ListTranscodeTask GetTranscodeTask The TranscodeTemplateIds and ForceDelGroup parameters are added as request parameters of the DeleteTranscodeTemplateGroup operation and the NonExistTranscodeTemplateIds parameter is added to the response. The Rotate parameter is added as a nested parameter under VideoStream in the response to the GetMezzanineInfo operation. The Status parameter is added to the response to the GetImageInfo operation. The CustomMediaInfo parameter is added as a request parameter of the UpdateVideoInfo operation. The CustomMediaInfo parameter is added to the GetVideoInfo and SearchMedia operations to indicate custom media asset information. In addition, specific parameters related to media review are added to the SearchMedia operation. The DeleteTranscodeTemplates operation is replaced with the DeleteTranscodeTemplateGroup operation.

2019-01-30

Release date	Version	Description
2019-01-30	2.15.0	The GetURLUploadInfos operation is added. Specific operations that are no longer used are deleted. The operations of earlier versions for Alibaba Cloud CDN, such as DescribeDomainBpsData, are replaced with operations of new versions. For more information, see List of operations by function. The GetVideoPlayInfo operation is deleted because it is no longer used in the player of the latest version. Specific operations that are used only by the system, such as OpenVodService, are deleted to prevent misuse. Note For more information about the operations supported by ApsaraVideo VOD, see List of operations by function.

2019-01-15

Release date	Version	Description
2019-01-15	2.12.0	The following seven operations related to transcoding templates are added: AddTranscodeTemplateGroup UpdateTranscodeTemplateGroup DeleteTranscodeTemplateGroup GetTranscodeTemplateGroup ListTranscodeTemplateGroup SetDefaultTranscodeTemplateGroup DeleteTranscodeTemplates The following seven operations related to AI templates are added: AddAITemplate UpdateAITemplate DeleteAITemplate GetAITemplate ListAITemplate SetDefaultAITemplate GetDefaultAITemplate The following seven operations related to CDN are added: DescribeVodDomainTrafficData DescribeVodDomainBpsData PreloadVodObjectCaches RefreshVodObjectCaches DescribeVodRefreshTasks DescribeVodRefreshQuota DescribeVodDomainLog The Priority parameter is added to the SubmitTranscodeJobs operation for you to set the priority for jobs to be submitted. The UserData parameter is added to the operations related to media upload, including UploadMediaByURL, CreateUploadImage, and CreateUploadAttachedMedia. This way, you can set callback URLs and customize extended fields.

2018-12-16

Release date	Version	Description
2018-12-16	2.11.9	The AddMediaSequences operation is added. This operation allows you to add audio and video assets with the start and end time specified during media production. You can add offline audio and video files and real-time live streams.

2018-11-30

Release date	Version	Description
2018-11-30	2.11.8	The following four operations related to snapshot templates are added: AddVodTemplate UpdateVodTemplate DeleteVodTemplate GetVodTemplate The CreateUploadAttachedMedia operation is added. This operation allows you to query the upload URL and credential of an auxiliary media asset, such as a watermark or subtitle file.

2018-11-21

Release date	Version	Description
2018-11-21	2.11.7	The following six operations related to video watermarks are added: AddWatermark UpdateWatermark DeleteWatermark GetWatermark ListWatermarks SetDefaultWatermark The RegisterMedia operation is added. To register media files that are stored in an Object Storage Service (OSS) bucket, make sure that the OSS bucket is connected to ApsaraVideo VOD. The `OverrideParams` parameter is added to the SubmitTranscodeJobs operation for you to replace the default template configurations, such as images and text watermarks, when you submit transcoding jobs.

2018-10-11

Release date	Version	Description
2018-10-11	2.11.6	The following two operations are added to manage media assets: DeleteMezzanines: deletes one or more uploaded audio and video source files at a time. UpdateImageInfos: modifies the information about one or more images at a time, such as the title, description, tag, and category. The `PlayConfig` parameter is added to the GetVideoPlayAuth operation for you to customize playback settings. For example, you can specify the domain name for CDN to be used to play videos.

2018-08-17

Release date	Version	Description
2018-08-17	2.11.5	The DeleteImage operation is added for you to delete uploaded images, video thumbnails, and video snapshots. The `AdditionType` and `OutputType` parameters are added to the GetMezzanineInfo operation. The AdditionType parameter specifies the attached information to be returned. The OutputType parameter specifies the URL type, such as an OSS URL or a CDN URL. The `CreationTime` and `ModificationTime` parameters are added to the response to the GetPlayInfo operation. CreationTime indicates the time when an audio or video file is created and ModificationTime indicates the time when an audio or video file is last updated. The time must be in UTC.

2018-08-04

Release date	Version	Description
2018-08-04	2.11.4	The following two operations related to media review are added: SetAuditSecurityIp: specifies the IP addresses from which you can play videos that are blocked or being reviewed. ListAuditSecurityIp: queries the IP addresses that are added to review security groups. The UploadMediaByURL operation is added for you to specify the URLs of multiple media files to be uploaded to ApsaraVideo VOD at a time. The `StorageLocation` and `TemplateGroupId` parameters are added to the response to the GetVideoInfo and GetVideoInfos operations. StorageLocation indicates the video storage location and TemplateGroupId indicates the ID of the transcoding template group that you specify during upload. The `OutputType` and `Status` parameters are added to the response to the GetPlayInfo operation. OutputType indicates the streaming URL type, such as an OSS URL or a CDN URL. Status indicates the video status.

2018-07-10

Release date	Version	Description
2018-07-10	2.11.3	The following two operations related to media review are added: CreateAudit: enables manual review for audio and video files. GetAuditHistory: queries the manual review history. The following four operations are added to manage media assets: GetVideoInfos UpdateVideoInfos SearchMedia: searches, filters, or sorts media assets, such as videos, audio files, and images. ListSnapshots The `VideoStreamList` and `AudioStreamList` parameters are added to the response to the GetMezzanineInfo operation.

2018-07-03

Release date	Version	Description
2018-07-03	2.11.2	The UserData parameter is added to the ProduceEditingProjectVideo operation for you to customize a callback URL.

2018-06-22

Release date	Version	Description
2018-06-22	2.11.1	The ResultType parameter is added to the call of the GetPlayInfo operation for you to specify the type of returned data and the WatermarkId parameter is added to the response to indicate the watermark ID. For example, you can specify ResultType to return all transcoded streams and use WatermarkId to check whether a transcoded stream has a watermark.

2018-05-10

Release date	Version	Description
2018-05-10	2.11.0	The SubmitPreprocessJobs operation is added to process the media files in the production studio in advance. The `PreprocessStatus` parameter is added to the response to the GetMezzanineInfo, GetVideoInfo, and GetPlayInfo operations. The `CreationTime` and `StorageLocation` parameters are added to the response to the ListLiveRecordVideo operation. The `OutputType` parameter is added to the GetVideoInfo operation for you to specify the type of the playback URL to be returned, such as an OSS URL or a CDN URL.

2018-04-01

Release date	Version	Description
2018-04-01	2.10.0	The following four operations related to data statistics are added: DescribePlayUserTotal: queries the total number of playback each day in a specified time range. DescribePlayUserAvg: queries the average number of playback each day in a specified time range. DescribePlayTopVideos: queries the playback data of daily top videos. The playback data includes the video views, unique visitors, and total playback duration. DescribePlayVideoStatis: queries the daily playback statistics of a video in a specified time range. The following four operations related to CDN are added: PushObjectCache: prefetches media files from origin servers to points of presence (POPs). This reduces workloads on origin servers because you can directly access the cached files upon your first visit. RefreshObjectCaches: refreshes multiple files at a time on POPs. DescribeRefreshTasks DescribeRefreshQuota The following two operations are added to process media files: SubmitTranscodeJobs: transcodes or re-transcodes audio and video files. SubmitSnapshotJob: captures a regular snapshot or sprite snapshot from a video. The following two parameters are added to the ProduceEditingProjectVideo operation: The metadata for the produced video, such as the title, description, tag, and category can be specified by MediaMetadata. The production configuration, such as TemplateGroupId, can be specified. The TemplateGroupId parameter specifies the ID of the transcoding template group that is used to transcode produced videos.

2017-12-21

Release date	Version	Description
2017-12-21	2.9.0	The ListLiveRecordVideo operation is added for you to query live streams that can be played on demand.

2017-12-07

Release date	Version	Description
2017-12-07	2.8.0	The ListAIJob operation is added for you to query information about multiple video AI jobs at a time.

2017-11-29

Release date	Version	Description
2017-11-29	2.7.0	The feature of filtering media stream URLs based on definition is added to the GetPlayInfo operation. The UploadAddress parameter is added to the response to the RefreshUploadVideo operation. The TemplateGroupId parameter is added to the CreateUploadVideo operation for you to customize template groups. The ResultTypes parameter is added to the GetVideoInfo operation for you to specify the type of the returned data. The returned data contains the AI processing result. The operations related to video classification are added, including SubmitAIASRJob and ListAIASRJob. The general operation SubmitAIJob is added. Five AI features are added, including video tagging, video text identification, celebrity identification, politician identification, and sensitive person identification. Multiple AI features can be enabled for a single video. The Title, Tags, and OriginalFileName parameters are added to the call of the CreateUploadImage operation and the ImageId parameter is added to the response. The GetImageInfo operation is added.

2017-11-03

Release date	Version	Description
2017-11-03	2.6.0	A reauthentication parameter is added to the GetPlayInfo operation and the JobId parameter is added as a nested parameter under PlayInfo in the response. A reauthentication parameter is added to the GetVideoPlayAuth operation for you to customize the expiration time for the AuthInfo parameter. The DeleteStream operation is added for you to delete the files and information of a media stream based on JobId. The SubmitSnapshotJob operation is added. The operations related to online editing are added, including AddEditingProject, UpdateEditingProject, ProduceEditingProjectVideo, SetEditingProjectMaterials, GetEditingProjectMaterials, GetEditingProject, SearchEditingProject, and DeleteEditingProject. The operations related to CDN resource monitoring and log download are added, including DescribeCdnDomainLogs, DescribeDomainBpsData, and DescribeDomainFlowData. The operations related to terrorism detection for video AI are added, including SubmitAIVideoTerrorismRecogJob and ListAIVideoTerrorismRecogJob. The operations related to content moderation for video AI are added, including SubmitAIVideoCensorJob and ListAIVideoCensorJob.

2017-10-15

Release date	Version	Description
2017-10-15	2.5.0	Speech-to-text operations are added, including SubmitAIASRJob and ListAIASRJob. Video synopsis operations are added, including SubmitAIVideoSummaryJob and ListAIVideoSummaryJob. Operations related to intelligent thumbnail and pornography detection are added for video AI, including SubmitAIVideoCoverJob, ListAIVideoCoverJob, SubmitAIVideoPornRecogJob, and ListAIVideoPornRecogJob. The ID field nested under Job in the response is renamed to JobId. The StreamType parameter is added as a nested parameter under PlayInfo in the response to the GetPlayInfo operation to indicate the stream type. Valid values: `video` and `audio`. video indicates a video stream and audio indicates an audio stream.

2017-09-20

Release date	Version	Description
2017-09-20	2.4.0	The GetMezzanineInfo operation is added. The MediaId parameter is added to the call of the SubmitAIVideoCoverJob operation and the MediaId field is added to the Job parameter in the response. The Input field that was unavailable is nested under AIVideoCoverConfig in the call. The layer of the response parameters is adjusted for the ListAIVideoCoverJob operation. The AIVideoCoverJobList parameter is returned as an array and the MediaId field is added as a nested parameter under Job. The VideoId parameter in the call of the SubmitAIVideoPornRecogJob operation is renamed to MediaId and the MediaId field is added as a nested parameter under Job in the response. The MediaId field is added as a nested parameter under Job in the response to the ListAIVideoPornRecogJob operation.

2017-09-01

Release date	Version	Description
2017-09-01	2.3.1	The SubmitAIVideoCoverJob operation is added. The ListAIVideoCoverJob operation is added. The SubmitAIVideoPornRecogJob operation is added. The ListAIVideoPornRecogJob operation is added. The TranscodeMode and UserData parameters are added to the CreateUploadVideo operation.