AdsApp.​InFeedAdBuilder

Builder for an in-feed video ad under construction.

Methods:

MemberTypeDescription
build AdsApp.VideoAdOperation Creates an in-feed video ad.
withAdName AdsApp.InFeedAdBuilder Sets the video ad name.
withDescription1 AdsApp.InFeedAdBuilder Sets the first line of the new ad's description to the specified value.
withDescription2 AdsApp.InFeedAdBuilder Sets the second line of the new ad's description to the specified value.
withDestinationPage AdsApp.InFeedAdBuilder Sets the destination page.
withHeadline AdsApp.InFeedAdBuilder Sets the headline of the new ad to the specified value.
withThumbnail AdsApp.InFeedAdBuilder Sets the thumbnail that you want to appear with the ad.
withVideo AdsApp.InFeedAdBuilder Sets the YouTube video that this ad will be built on.

build()

Creates an in-feed video ad. Returns a VideoAdOperation that can be used to get the new ad (or access any associated errors if creation failed).

Return values:

TypeDescription
AdsApp.VideoAdOperation The associated ad operation.

withAdName(adName)

Sets the video ad name. This field is required.

Arguments:

NameTypeDescription
adName String The video ad name.

Return values:

TypeDescription
AdsApp.InFeedAdBuilder Ad builder with the specified video ad name.

withDescription1(description1)

Sets the first line of the new ad's description to the specified value. This field is required.

Arguments:

NameTypeDescription
description1 String The first line of the ad description.

Return values:

TypeDescription
AdsApp.InFeedAdBuilder Ad builder with the specified first description line.

withDescription2(description2)

Sets the second line of the new ad's description to the specified value. This field is required.

Arguments:

NameTypeDescription
description2 String The second line of the ad description.

Return values:

TypeDescription
AdsApp.InFeedAdBuilder Ad builder with the specified second description line.

withDestinationPage(destinationPage)

Sets the destination page. Setting the value as "WATCH" takes users to a standard YouTube video watch page and "CHANNEL" takes users to your YouTube channel page to view the selected video.

Arguments:

NameTypeDescription
destinationPage String The destination page. It can be either "WATCH" or "CHANNEL".

Return values:

TypeDescription
AdsApp.InFeedAdBuilder Ad builder with the specified destination page.

withHeadline(headline)

Sets the headline of the new ad to the specified value. This field is required.

Arguments:

NameTypeDescription
headline String The headline for the ad.

Return values:

TypeDescription
AdsApp.InFeedAdBuilder Ad builder with the specified headline.

withThumbnail(thumbnail)

Sets the thumbnail that you want to appear with the ad. Acceptable values: "DEFAULT", "THUMBNAIL1", "THUMBNAIL2", "THUMBNAIL3".

Arguments:

NameTypeDescription
thumbnail String Selection of thumbnail that appears on the ad. It can be "DEFAULT", "THUMBNAIL1", "THUMBNAIL2" or "THUMBNAIL3".

Return values:

TypeDescription
AdsApp.InFeedAdBuilder Ad builder with the specified thumbnail selection.

withVideo(video)

Sets the YouTube video that this ad will be built on.

Arguments:

NameTypeDescription
video AdsApp.Asset The YouTube video that this ad will be built on. Use Asset.getYouTubeVideoId() to check if a video is YouTube video.

Return values:

TypeDescription
AdsApp.InFeedAdBuilder Ad builder with the specified video.