AdsApp.​InFeedAdBuilder

AI-generated Key Takeaways

• The InFeedAdBuilder facilitates the creation of in-feed video ads within Google Ads campaigns.

• Required fields for ad creation include ad name, headline, and first and second description lines.

• Advertisers can select a custom thumbnail or the default option for display.

• Destination page settings allow directing users to either the video's watch page or the channel page.

• This builder leverages YouTube videos as the foundation for the in-feed video ads.

Builder for an in-feed video ad under construction.

Methods:

Member	Type	Description
build()	AdsApp.VideoAdOperation	Creates an in-feed video ad.
withAdName(adName)	AdsApp.InFeedAdBuilder	Sets the video ad name.
withDescription1(description1)	AdsApp.InFeedAdBuilder	Sets the first line of the new ad's description to the specified value.
withDescription2(description2)	AdsApp.InFeedAdBuilder	Sets the second line of the new ad's description to the specified value.
withDestinationPage(destinationPage)	AdsApp.InFeedAdBuilder	Sets the destination page.
withHeadline(headline)	AdsApp.InFeedAdBuilder	Sets the headline of the new ad to the specified value.
withThumbnail(thumbnail)	AdsApp.InFeedAdBuilder	Sets the thumbnail that you want to appear with the ad.
withVideo(video)	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:

Type	Description
AdsApp.VideoAdOperation	The associated ad operation.

withAdName(adName)

Sets the video ad name. This field is required.

Arguments:

Name	Type	Description
adName	String	The video ad name.

Return values:

Type	Description
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:

Name	Type	Description
description1	String	The first line of the ad description.

Return values:

Type	Description
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:

Name	Type	Description
description2	String	The second line of the ad description.

Return values:

Type	Description
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:

Name	Type	Description
destinationPage	String	The destination page. It can be either "WATCH" or "CHANNEL".

Return values:

Type	Description
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:

Name	Type	Description
headline	String	The headline for the ad.

Return values:

Type	Description
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:

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

Return values:

Type	Description
AdsApp.InFeedAdBuilder	Ad builder with the specified thumbnail selection.

withVideo(video)

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

Arguments:

Name	Type	Description
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:

Type	Description
AdsApp.InFeedAdBuilder	Ad builder with the specified video.