广告媒体

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();
}

使用媒体制作广告

请参阅我们的广告文章，查看有关如何制作带有附加媒体的支持广告的一些代码示例。