廣告媒體

部分廣告類型 (例如 ImageAd 和 ResponsiveDisplayAd) 包含圖片和其他媒體元素。本指南說明如何使用 Google Ads 腳本上傳及查詢媒體。

上傳映像檔

您可以使用 ImageBuilder 類別上傳圖片，這個類別會採用名稱和圖片資料。資料會以 Blob 資料交換物件的形式提供，可由 Google 雲端硬碟或 網址擷取等服務建立。

以下程式碼片段說明如何從外部網址上傳圖片：

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(condition) 述詞，依名稱、類型或其他欄位篩選媒體。舉例來說，以下程式碼片段會找出帳戶中的所有圖片：

let mediaIterator = AdsApp.adMedia().media()
    .withCondition("Type = IMAGE")
    .get();
while (mediaIterator.hasNext()) {
  let image = mediaIterator.next();
}

製作含媒體的廣告

如需建立支援的廣告並附加媒體的程式碼範例，請參閱廣告文章。