ImageAd 和 ResponsiveDisplayAd 等广告类型包含图片和其他媒体元素。本指南介绍如何使用 Google Ads 脚本上传和查询媒体。
上传映像
您可以使用接受名称和图片数据的 ImageBuilder
类上传图片。这些数据以 Blob
数据交换对象的形式提供,可以通过云端硬盘或网址提取等服务创建。
下面的代码段显示了如何从外部网址上传图片:
let imageUrl = "http://www.example.com/example.png";
let imageBlob = UrlFetchApp.fetch(imageUrl).getBlob();
let mediaOperation = AdsApp.adMedia().newImageBuilder()
.withName("IMAGE_NAME")
.withData(imageBlob)
.build();
还可以从 Google 云端硬盘加载图片 Blob:
let imageFileId = "IMAGE_FILE_ID";
let imageBlob = DriveApp.getFileById(imageFileId).getBlob();
let mediaOperation = AdsApp.adMedia().newImageBuilder()
.withName("IMAGE_NAME")
.withData(imageBlob)
.build();
上传媒体捆绑包
媒体包是包含 HTML5 素材资源的 ZIP 压缩文件,可用于制作 HTML5 广告。使用接受名称和文件数据的 MediaBundleBuilder
类上传媒体包。与图片一样,数据是作为 Blob
数据交换对象提供的。
下面的代码段显示了如何从外部网址上传媒体捆绑包:
let mediaBundleUrl = "http://www.example.com/example.zip";
let mediaBundleBlob = UrlFetchApp.fetch(mediaBundleUrl).getBlob();
let mediaOperation = AdsApp.adMedia().newMediaBundleBuilder()
.withName("bundle name")
.withData(mediaBundleBlob)
.build();
查询媒体
可以使用 MediaSelector
在 Google Ads 脚本中查询每种类型的媒体。使用 withCondition()
谓词按名称、类型或其他字段过滤媒体。例如,以下代码段可查找帐号中的所有图片:
let mediaIterator = AdsApp.adMedia().media()
.withCondition("Type = IMAGE")
.get();
while (mediaIterator.hasNext()) {
let image = mediaIterator.next();
}
使用媒体制作广告
请参阅我们的广告文章,查看有关如何制作带有附加媒体的支持广告的一些代码示例。