影片資料物件 - 行銷活動管理
定義影片資料物件。
注意事項
並非每個人都有這項功能。 如果沒有,別擔心, 即將推出!
語法
<xs:complexType name="Video" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="AspectRatio" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="CreatedDateTimeInUTC" nillable="true" type="xs:dateTime" />
<xs:element minOccurs="0" name="Description" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="DurationInMilliseconds" nillable="true" type="xs:int" />
<xs:element minOccurs="0" name="FailureCode" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="ModifiedDateTimeInUTC" nillable="true" type="xs:dateTime" />
<xs:element minOccurs="0" name="SourceUrl" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Status" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="ThumbnailUrl" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Url" nillable="true" type="xs:string" />
</xs:sequence>
</xs:complexType>
元素
Video 物件具有下列元素:AspectRatio、CreatedDateTimeInUTC、Description、DurationInMilliseconds、FailureCode、Id、ModifiedDateTimeInUTC、SourceUrl、Status、ThumbnailUrl、Url。
元素 | 描述 | 資料類型 |
---|---|---|
AspectRatio | 影片的外觀比例。 可能的值為 16:9、9:16、4:3、3:4、1:1、5:4 和 4:5。 | string |
CreatedDateTimeInUTC | 影片的建立日期和時間,以國際標準時間表示。 | dateTime |
描述 | 影片資產的描述。 新增:支援 更新:支援 |
string |
DurationInMilliseconds | 視訊資產的持續時間,以毫秒為單位。 新增:不支援 更新:不支援 |
int |
FailureCode | 請閱讀下方每個可能錯誤碼的描述。 AssetDataInvalid:從 URL 下載的檔案不是影片。 VideoDownloadError:無法存取提供的 URL。 AssetDataInvalidWidth:視訊畫面寬度小於 120 圖元。 AssetDataInvalidHeight:視訊畫面高度小於 120 圖元。 InvalidDuration:視訊持續時間小於 6 秒。 VideoOverweight:視訊檔案大小大於 2 GB。 VideoTranscodingError:表示轉碼問題的一般失敗碼。 這是由 Azure 媒體服務控制。 深入了解 編碼影片 和 JobErrorCode。 |
string |
標識碼 | 影片的標識碼。 | 長 |
ModifiedDateTimeInUTC | 影片上次修改的日期和時間,以國際標準時間表示。 | dateTime |
SourceUrl | 影片的原始URL。
注意:SourceUrl 必須是直接下載 URL。 新增:支援和必要 |
string |
地位 | 視訊資產的狀態。 狀態可以是 Draft、 Active、 Deleted 或 Failed。 新增:不支援 更新:支援 |
string |
ThumbnailUrl | 視訊資產的縮圖 URL。 新增:不支援 更新:不支援 |
string |
URL | 裝載影片的 URL。
注意:URL 會保留供內部使用。 新增:支援 更新:支援 |
string |
需求
服務: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13
消費者
AddVideos
AdRecommendationVideoSuggestion
GetVideosByIds
UpdateVideos