AdsApp.​ImageAssetBuilder

AI-generated Key Takeaways

• Facilitates the creation of new image assets within Google Ads, primarily for use in ad campaigns.

• Requires an image URL which is fetched and converted into a blob before being used to build the asset.

• Provides methods to set the name and data for the image asset, both of which are mandatory for successful asset creation.

• AssetOperation.getResult() is only necessary if you need the asset for further actions; otherwise, ImageAssetBuilder.build() is enough for asset creation.

Builds new image assets.

Typical usage:

var imageUrl = "http://www.example.com/example.png";
var imageBlob = UrlFetchApp.fetch(imageUrl).getBlob();
var assetOperation = AdsApp.adAssets().newImageAssetBuilder()
   .withName("name")
   .withData(imageBlob)
   .build();
var imageAsset = assetOperation.getResult();

Note that it is only necessary to call AssetOperation.getResult() if you need to access the new asset item for further processing. Otherwise calling ImageAssetBuilder.build() is sufficient to ensure that the asset is created.

Methods:

Member	Type	Description
build()	AdsApp.AssetOperation	Creates an image asset.
withData(data)	AdsApp.ImageAssetBuilder	Sets new image asset's data to the specified value.
withName(name)	AdsApp.ImageAssetBuilder	Sets new image asset's name to the specified value.

build()

Creates an image asset. Returns a AssetOperation that can be used to get the new image asset (or access any associated errors if the creation failed).

Return values:

Type	Description
AdsApp.AssetOperation	The asset operation.

withData(data)

Sets new image asset's data to the specified value. This field is required.

Arguments:

Name	Type	Description
data	Blob.Blob	The data for the asset image.

Return values:

Type	Description
AdsApp.ImageAssetBuilder	The asset image builder with the specified data.

withName(name)

Sets new image asset's name to the specified value. This field is required.

Arguments:

Name	Type	Description
name	String	The name for the asset image.

Return values:

Type	Description
AdsApp.ImageAssetBuilder	The asset image builder with the specified name.