廣告媒體

有些廣告類型 (例如 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();
}

製作含有媒體的廣告

請參閱廣告文章，瞭解如何使用附加媒體建立支援的廣告。