- 資源:YouTubeAd
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- 縮圖
- VideoPerformanceAd
- AdUrl
- AdUrlType
- 方法
資源:YouTube 廣告群組廣告
與 YouTube 廣告群組相關聯的單一廣告。
JSON 表示法 |
---|
{ "name": string, "advertiserId": string, "adGroupAdId": string, "adGroupId": string, "displayName": string, "entityStatus": enum ( |
欄位 | |
---|---|
name |
廣告的資源名稱。 |
advertiserId |
廣告所屬的廣告客戶專屬 ID。 |
adGroupAdId |
廣告的專屬 ID。由系統指派。 |
adGroupId |
廣告所屬廣告群組的專屬 ID。 |
displayName |
廣告的顯示名稱。 必須使用 UTF-8 編碼,且大小上限為 255 個位元組。 |
entityStatus |
廣告的實體狀態。 |
adUrls[] |
廣告使用的網址清單。 |
聯集欄位 ad_details 。廣告詳情。ad_details 只能是下列其中一項: |
|
displayVideoSourceAd |
來自 Display & Video 360 廣告素材的廣告來源詳細資料。 |
mastheadAd |
|
inStreamAd |
在 5 秒後略過的串流內廣告詳細資料,可用於品牌知名度或達成行銷目標。 |
nonSkippableAd |
不可略過的簡短串流內影片廣告的詳細資料 (6 到 15 秒),可用於達成行銷目標。 |
bumperAd |
不可略過的短片廣告詳細資料 (等於或少於 6 秒),用於觸及數。 |
audioAd |
用於達成行銷目標的音訊廣告詳細資料。 |
videoDiscoverAd |
在探索位置顯示的宣傳影片廣告詳細資料。 |
videoPerformanceAd |
在影片行動廣告活動中使用的廣告,以便吸引使用者對商家、服務或產品採取行動。 |
DisplayVideoSourceAd
來自 DV360 廣告素材的廣告來源。
JSON 表示法 |
---|
{ "creativeId": string } |
欄位 | |
---|---|
creativeId |
來源廣告素材的 ID。 |
MastheadAd
刊頭廣告的詳細資料。
JSON 表示法 |
---|
{ "video": { object ( |
欄位 | |
---|---|
video |
廣告使用的 YouTube 影片。 |
headline |
廣告標題。 |
description |
廣告的說明。 |
videoAspectRatio |
刊頭廣告中自動播放的 YouTube 影片長寬比。 |
autoplayVideoStartMillisecond |
影片在這段時間後開始播放的時間長度 (以毫秒為單位)。 |
autoplayVideoDuration |
影片自動播放的時間長度。 時間長度以秒為單位,最多可有 9 個小數位數,並結尾為「 |
callToActionButtonLabel |
行動號召按鈕上的文字。 |
callToActionFinalUrl |
行動號召按鈕的到達網頁網址。 |
callToActionTrackingUrl |
行動號召按鈕的追蹤網址。 |
showChannelArt |
要顯示 YouTube 頁面頂端的背景或橫幅。 |
companionYoutubeVideos[] |
在電腦上顯示在刊頭廣告旁的影片。不得超過兩個。 |
YoutubeVideoDetails
YouTube 影片的詳細資料。
JSON 表示法 |
---|
{
"id": string,
"unavailableReason": enum ( |
欄位 | |
---|---|
id |
可在 YouTube 網頁上搜尋的 YouTube 影片 ID。 |
unavailableReason |
沒有影片資料的原因。 |
VideoAspectRatio
YouTube 影片可能採用的長寬比。
列舉 | |
---|---|
VIDEO_ASPECT_RATIO_UNSPECIFIED |
未指定或不明。 |
VIDEO_ASPECT_RATIO_WIDESCREEN |
影片經過延展,而頂部和底部會遭到裁切。 |
VIDEO_ASPECT_RATIO_FIXED_16_9 |
影片採用固定的 16:9 長寬比。 |
InStreamAd
串流內廣告的詳細資料。
JSON 表示法 |
---|
{
"commonInStreamAttribute": {
object ( |
欄位 | |
---|---|
commonInStreamAttribute |
常見的廣告屬性。 |
customParameters |
將自訂值傳送至追蹤網址範本的自訂參數。 這個物件中包含 |
CommonInStreamAttribute
串流內廣告、不可略過的廣告和串場廣告的常見屬性。
JSON 表示法 |
---|
{ "displayUrl": string, "finalUrl": string, "trackingUrl": string, "actionButtonLabel": string, "actionHeadline": string, "video": { object ( |
欄位 | |
---|---|
displayUrl |
與廣告一起顯示的網頁網址。 |
finalUrl |
使用者按下廣告後到達的網頁網址。 |
trackingUrl |
系統為了追蹤目的而在背景載入的網址網址。 |
actionButtonLabel |
行動號召按鈕上的文字。 |
actionHeadline |
行動號召橫幅的標題。 |
video |
廣告的 YouTube 影片。 |
companionBanner |
顯示在影片廣告旁的圖片。 |
ImageAsset
圖片素材資源的中繼資料。
JSON 表示法 |
---|
{
"mimeType": string,
"fullSize": {
object ( |
欄位 | |
---|---|
mimeType |
圖片素材資源的 MIME 類型。 |
fullSize |
這張圖片原始大小的中繼資料。 |
fileSize |
圖片素材資源的檔案大小,以位元組為單位。 |
NonSkippableAd
不可略過廣告的詳細資料。
JSON 表示法 |
---|
{
"commonInStreamAttribute": {
object ( |
欄位 | |
---|---|
commonInStreamAttribute |
常見的廣告屬性。 |
customParameters |
將自訂值傳送至追蹤網址範本的自訂參數。 這個物件中包含 |
BumperAd
串場廣告的詳細資料。
JSON 表示法 |
---|
{
"commonInStreamAttribute": {
object ( |
欄位 | |
---|---|
commonInStreamAttribute |
常見的廣告屬性。 |
AudioAd
音訊廣告的詳細資料。
JSON 表示法 |
---|
{
"displayUrl": string,
"finalUrl": string,
"trackingUrl": string,
"video": {
object ( |
欄位 | |
---|---|
displayUrl |
與廣告一起顯示的網頁網址。 |
finalUrl |
使用者按下廣告後到達的網頁網址。 |
trackingUrl |
系統為了追蹤目的而在背景載入的網址網址。 |
video |
廣告的 YouTube 影片。 |
VideoDiscoveryAd
影片探索廣告的詳細資料。
JSON 表示法 |
---|
{ "headline": string, "description1": string, "description2": string, "video": { object ( |
欄位 | |
---|---|
headline |
廣告標題。 |
description1 |
廣告的第一行文字。 |
description2 |
廣告的第二行文字。 |
video |
廣告宣傳的 YouTube 影片。 |
thumbnail |
廣告中使用的縮圖。 |
Thumbnail
影片探索廣告中可用的縮圖選項。
列舉 | |
---|---|
THUMBNAIL_UNSPECIFIED |
不明或未指定。 |
THUMBNAIL_DEFAULT |
預設縮圖可由系統自動產生或使用者上傳。 |
THUMBNAIL_1 |
影片生成的縮圖 1。 |
THUMBNAIL_2 |
影片生成的縮圖 2。 |
THUMBNAIL_3 |
影片生成的縮圖 3。 |
VideoPerformanceAd
影片成效廣告的詳細資料。
JSON 表示法 |
---|
{ "finalUrl": string, "trackingUrl": string, "actionButtonLabels": [ string ], "headlines": [ string ], "longHeadlines": [ string ], "descriptions": [ string ], "displayUrlBreadcrumb1": string, "displayUrlBreadcrumb2": string, "domain": string, "videos": [ { object ( |
欄位 | |
---|---|
finalUrl |
使用者按下廣告後到達的網頁網址。 |
trackingUrl |
系統為了追蹤目的而在背景載入的網址網址。 |
actionButtonLabels[] |
在行動號召按鈕上顯示的文字素材資源清單。 |
headlines[] |
顯示在行動號召橫幅中的廣告標題清單。 |
longHeadlines[] |
顯示在行動號召橫幅上的獨立廣告標題清單。 |
descriptions[] |
行動號召橫幅中顯示的說明清單。 |
displayUrlBreadcrumb1 |
顯示網址中網域後方的第一個片段。 |
displayUrlBreadcrumb2 |
顯示網址中網域後方的第二個片段。 |
domain |
顯示網址的網域。 |
videos[] |
此廣告使用的 YouTube 影片素材資源清單。 |
customParameters |
將自訂值傳送至追蹤網址範本的自訂參數。 這個物件中包含 |
companionBanners[] |
此廣告使用的隨播橫幅廣告清單。 |
AdUrl
廣告相關額外網址 (包括信標)。
JSON 表示法 |
---|
{
"type": enum ( |
欄位 | |
---|---|
type |
廣告網址的類型。 |
url |
網址字串值。 |
AdUrlType
可能的廣告網址類型。
列舉 | |
---|---|
AD_URL_TYPE_UNSPECIFIED |
不明或未指定。 |
AD_URL_TYPE_BEACON_IMPRESSION |
廣告素材放送時,用來連線偵測 (ping) 的 1x1 追蹤像素。 |
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION |
DCM 可展開式曝光信標。服務提供時,會擴展為數個信標。 |
AD_URL_TYPE_BEACON_CLICK |
點擊事件觸發時連線偵測的追蹤網址。 |
AD_URL_TYPE_BEACON_SKIP |
略過事件觸發時連線偵測的追蹤網址。 |
方法 |
|
---|---|
|
取得 YouTube 廣告群組廣告。 |
|
列出 YouTube 廣告群組廣告。 |