廣告媒體

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

查詢媒體

在 Google Ads 指令碼中，您可以使用 MediaSelector 查詢每種類型的媒體。您可以使用 withCondition() 述詞，按照名稱、類型或其他欄位篩選媒體。舉例來說，以下程式碼片段會尋找帳戶中所有的圖片：

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

使用媒體建立廣告

如要瞭解如何在附加媒體中建立受支援的廣告，請參閱廣告文章。