Release notes of server operation SDKs

2020-09-24

V2.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

V2.15.11

• Server operation SDKs are available in the China (Beijing) region. 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

V2.15.10

Server operation SDKs are available in the China (Shenzhen) region. We recommend that you use the latest versions of server upload SDKs.

2020-06-04

V2.15.9

• The SubmitMediaDNADeleteJob and ListMediaDNADeleteJob operations are added.

• The ad detection, logo detection, and liveness detection results can be returned by the GetMediaAuditResult operation.

• The ad detection, logo detection, and liveness detection results can be returned by the GetMediaAuditResultTimeline operation.

2019-10-23

V2.15.8

• The SubmitDynamicImageJob operation is added so that you can capture a video clip as a GIF or WebP image.

• The SubmitWorkflowJob operation is added so that you can initiate a video-on-demand (VOD) workflow to process audio and video files.

• The AuditStatus parameter is added as a nested parameter under the response parameter ImageInfo of the GetImageInfo operation.

• The data type of the response parameter StorageLocation of the GetAttachedMediaInfo operation is changed to String.

• The request parameter MediaType is added to the SubmitAIMediaAuditJob operation.

2019-06-24

V2.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, GetWatermark, ListWatermark, and UploadMediaByURL, are applicable to multiple applications.

• The UserData parameter is added to the SubmitTranscodeJobs operation. It is an extended parameter, which is transparently transmitted during an event notification. You can customize this parameter.

2019-05-16

V2.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 response parameter RegionId is added to the GetAttachedMediaInfo and GetImageInfo operations.

• The Icon and OnlineStatus parameters are added to the SearchMedia, GetAttachedMediaInfo, and CreateUploadAttachedMedia operations, so that you can manage short video materials.

• The UserData parameter is added to the SubmitSnapshotJob operation. It is an extended parameter, which is transparently transmitted during a callback. You can customize this parameter.

2019-04-11

V2.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 applicable to multiple applications. The AppId parameter is added to the operations related to upload, search, and lists, 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 applicable to multiple regions and multiple types of materials. The response parameters StorageLocation and RegionId are added to the GetEditingProject operation. The response parameters StorageLocation, RegionId, and Duration are added to the SearchEditingProject operation. The request parameter MaterialType is added to the GetEditingProjectMaterials operation.

• The file path can be customized for transcoding. The response parameters TranscodeFileRegular, Clip, and Rotate are added to the GetTranscodeTemplateGroup operation.

• The response parameter AttachedMedia is added to the SearchMedia operation so that you can query auxiliary media assets.

• The response parameter SubTotal is added to the GetCategories operation.

2019-02-28

V2.15.1

• The following three operations are added to query video transcoding information:

  • GetTranscodeSummary

  • ListTranscodeTask

  • GetTranscodeTask

• The request parameters TranscodeTemplateIds and ForceDelGroup, and the response parameter NonExistTranscodeTemplateIds are added to the DeleteTranscodeTemplateGroup operation.

• The Rotate parameter is added as a nested parameter under the VideoStream parameter of the GetMezzanineInfo operation.

• The response parameter Status is added to the GetImageInfo operation.

• The request parameter CustomMediaInfo is added to the UpdateVideoInfo operation. The response parameter CustomMediaInfo 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

V2.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

    the operations of the latest version for CDN.

  • The operations of earlier versions for the AI service, such as SubmitAIASRJob, are replaced with

    the operations of the latest version for the AI service.

  • 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 console, such as OpenVodService, are deleted to avoid misuse.

2019-01-15

V2.12.0

• The following seven operations related to transcoding templates are added:

  • AddTranscodeTemplateGroup

  • UpdateTranscodeTemplateGroup

  • DeleteTranscodeTemplateGroup

  • GetTranscodeTemplateGroup

  • ListTranscodeTemplateGroup

  • SetDefaultTranscodeTemplateGroup

  • DeleteTranscodeTemplates

• The following seven operation 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

• {"documentId":63640646,"position":366,"refInfo":"<li ","segmentId":"0","srcPlainText":"","srcText":"","transUnitId":"tu362"}

• {"documentId":63640646,"position":368,"refInfo":"<li ","segmentId":"0","srcPlainText":"","srcText":"","transUnitId":"tu364"}

2018-12-16

V2.11.9

The AddMediaSequences operation is added so that you can add audio and video assets with the start time and end time specified during media production. The assets include not only offline audio and video files, but also real-time live streams.

2018-11-30

V2.11.8

• The following four operations related to snapshot templates are added:

  • AddVodTemplate

  • UpdateVodTemplate

  • DeleteVodTemplate

  • GetVodTemplate

• The CreateUploadAttachedMedia operation is added so that you can query the upload URL and credential of an attached media asset, such as a watermark or subtitle file.

2018-11-21

V2.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 asset information for audio and video 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 so that you can replace the default template configurations, such as images and text watermarks, when you submit a transcoding job.

2018-10-11

V2.11.6

• The following two operations are added to manage media assets:

  • DeleteMezzanines: deletes multiple uploaded audio and video files at a time.

  • UpdateImageInfos: modifies the titles, introduction, tags, and categories of multiple images at a time.

• The PlayConfig parameter is added to the GetVideoPlayAuth operation so that you can customize playback settings. For example, you can specify the domain name for CDN to be used to play videos.

2018-08-17

V2.11.5

• The DeleteImage operation is added so that you can delete multiple uploaded images, video thumbnails, and video snapshots at a time.

• 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 response parameters CreationTime and ModificationTime are added to the GetPlayInfo operation. The CreationTime parameter indicates the UTC time when an audio or video file is created. The ModificationTime parameter indicates the latest UTC time when an audio or video file is updated.

2018-08-04

V2.11.4

• The following two operations related to media review are added:

  • SetAuditSecurityIp: specifies the IP addresses from which you can request to play videos that are being reviewed or blocked.

  • ListAuditSecurityIp: queries the IP addresses that are added to review security groups.

• The UploadMediaByURL operation is added so that you can specify the URLs of multiple media files to be uploaded to ApsaraVideo VOD at a time.

• The response parameters StorageLocation and TemplateGroupId are added to the GetVideoInfo and GetVideoInfos operations. The StorageLocation parameter indicates the video storage location. The TemplateGroupId parameter indicates the ID of the specified transcoding template group during upload.

• The response parameters OutputType and Status to the GetPlayInfo operation. The OutputType parameter indicates the playback URL type, such as an OSS URL or a CDN URL. The Status parameter indicates the video status.

2018-07-10

V2.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 response parameters VideoStreamList and AudioStreamList are added to the GetMezzanineInfo operation.

2018-07-03

V2.11.2

The UserData parameter is added to the ProduceEditingProjectVideo operation so that you can customize a callback URL.

2018-06-22

V2.11.1

GetPlayInfo operation: The ResultType parameter is added so that you can specify the type of returned data. For example, the operation returns all transcoded streams. The response parameter WatermarkId is added to indicate the ID of the video watermark. This parameter can be used to check whether a transcoded stream has a watermark.

2018-05-10

V2.11.0

• The SubmitPreprocessJobs operation is added.

• The response parameter PreprocessStatus is added to the GetMezzanineInfo, GetVideoInfo, and GetPlayInfo operations.

• The response parameters CreationTime and StorageLocation are added to the ListLiveRecordVideo operation.

• The OutputType parameter is added to the GetVideoInfo operation so that you can specify the type of returned playback URL, such as an OSS URL or a CDN URL.

2018-04-01

V2.10.0

• The following four operations related to data statistics are added:

  • DescribePlayUserTotal: queries the total number of playback times each day in a specified period.

  • DescribePlayUserAvg: queries the average number of playback times each day in a specified period.

  • 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 period.

• The following four operations related to CDN are added:

  • PushObjectCache: prefetches media files from origin servers to CDN cache nodes. This reduces workloads on origin servers because you can directly access the cached file upon your first visit.

  • RefreshObjectCaches: refreshes multiple files at a time on CDN cache nodes.

  • DescribeRefreshTasks

  • DescribeRefreshQuota

• The following two operations are added to process media:

  • SubmitTranscodeJobs: transcodes or re-transcodes audio and video files.

  • SubmitSnapshotJob: captures a normal snapshot or sprite snapshot from a video.

• The following two parameters are added to the ProduceEditingProjectVideo operation:

  • MediaMetadata: specifies the metadata for the produced video, such as the title, introduction, tag, and category.

  • ProduceConfig: specifies the production configuration, such as TemplateGroupId. The TemplateGroupId parameter specifies the ID of the transcoding template group that is used to transcode produced videos.

2017-12-21

V2.9.0

The ListLiveRecordVideo operation is added so that you can query the list of live to VOD videos.

2017-12-07

V2.8.0

The ListAIJob operation is added so that you can query information about multiple video AI jobs at a time.

2017-11-29

V2.7.0

• GetPlayInfo operation: The feature of filtering media stream URLs by resolution is added.

• RefreshUploadVideo operation: The response parameter UploadAddress is added.

• CreateUploadVideo operation: The TemplateGroupId parameter is added so that you can customize a template group.

• GetVideoInfo operation: The ResultTypes parameter is added to specify the type of 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.

• CreateUploadImage operation: The request parameters Title, Tags, and OriginalFileName are added. The response parameter ImageId is added.

• The GetImageInfo operation is added.

2017-11-03

V2.6.0

• GetPlayInfo operation: A reauthentication parameter is added. The JobId parameter is added as a nested parameter under the response parameter PlayInfo.

• GetVideoPlayAuth operation: A reauthentication parameter is added so that you can customize the expiration time for the AuthInfo parameter.

• The DeleteStream operation is added so that you can delete the files and information of a media stream based on the JobId parameter.

• 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 video AI operations related to terrorism detection are added, including SubmitAIVideoTerrorismRecogJob and ListAIVideoTerrorismRecogJob.

• The video AI operations related to content moderation are added, including SubmitAIVideoCensorJob and ListAIVideoCensorJob.

2017-10-15

V2.5.0

• Speech-to-text operations are added, including SubmitAIASRJob and ListAIASRJob.

• Video synopsis operations are added, including SubmitAIVideoSummaryJob and ListAIVideoSummaryJob.

• The video AI operations related to intelligent thumbnail and pornography detection jobs are added, including SubmitAIVideoCoverJob, ListAIVideoCoverJob, SubmitAIVideoPornRecogJob, and ListAIVideoPornRecogJob. The nested parameter Id under the response parameter Job is renamed as JobId.

• For the GetPlayInfo operation, the StreamType parameter is added as a nested parameter under the response parameter PlayInfo to indicate the stream type. A value of video indicates that video streams are generated. A value of audio indicates that audio streams are generated.

2017-09-20

V2.4.0

• The GetMezzanineInfo operation is added.

• SubmitAIVideoCoverJob operation: The MediaId parameter is added as a request parameter. The request parameter Input, which has not been used, is nested under the request parameter AIVideoCoverConfig. The MediaId parameter is added as a nested parameter under the response parameter Job.

• ListAIVideoCoverJob operation: The hierarchy of the response parameters is adjusted. The AIVideoCoverJobList parameter is returned as an array. The MediaId parameter is added as a nested parameter under the response parameter Job.

• SubmitAIVideoPornRecogJob operation: The request parameter VideoId is renamed as MediaId. The MediaId parameter is added as a nested parameter under the response parameter Job.

• ListAIVideoPornRecogJob operation: The MediaId parameter is added as a nested parameter under the response parameter Job.

2017-09-01

V2.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.