广告媒体

ImageAdResponsiveDisplayAd 等广告类型包含图片和其他媒体元素。本指南介绍如何使用 AdWords 脚本上传和查询媒体。

上传图片

可以使用提取名称和图片数据的 ImageBuilder 类上传图片。数据是作为 Blob 数据交换对象提供的,可以由云端硬盘服务网址提取服务创建。

下面的代码段显示了如何从外部网址上传图片:

var imageUrl = "http://www.example.com/example.png";
var imageBlob = UrlFetchApp.fetch(imageUrl).getBlob();
var mediaOperation = AdWordsApp.adMedia().newImageBuilder()
    .withName("IMAGE_NAME")
    .withData(imageBlob)
    .build();

还可以从 Google 云端硬盘加载图片 Blob:

var imageFileId = "IMAGE_FILE_ID";
var imageBlob = DriveApp.getFileById(imageFileId).getBlob();
var mediaOperation = AdWordsApp.adMedia().newImageBuilder()
    .withName("IMAGE_NAME")
    .withData(imageBlob)
    .build();

上传媒体捆绑包

媒体捆绑包是包含可用来制作 HTML5 广告的 HTML5 素材资源的 ZIP 压缩文件。有关文件结构的详细信息,请参阅格式文档。使用提取名称和文件数据的 MediaBundleBuilder 类上传媒体捆绑包。与图片一样,数据是作为 Blob 数据交换对象提供的。

下面的代码段显示了如何从外部网址上传媒体捆绑包:

var mediaBundleUrl = "http://www.example.com/example.zip";
var mediaBundleBlob = UrlFetchApp.fetch(mediaBundleUrl).getBlob();
var mediaOperation = AdWordsApp.adMedia().newMediaBundleBuilder()
    .withName("bundle name")
    .withData(mediaBundleBlob)
    .build();

查询媒体

可以使用 MediaSelector 在 AdWords 脚本中对每一种类型的媒体进行查询。请使用 withCondition() 谓词按名称、类型和其他字段过滤媒体。例如,下面的代码段可查找帐户中的所有图片:

var mediaIterator = AdWordsApp.adMedia().Media()
    .withCondition("Type = IMAGE")
    .get();
while (mediaIterator.hasNext()) {
  var image = adIterator.next();
}

使用媒体制作广告

有关使用随附媒体制作支持的广告的完整示例,请参阅代码示例页。

发送以下问题的反馈:

此网页
AdWords Scripts
AdWords Scripts
需要帮助?请访问我们的支持页面