素材資源

建立最高成效廣告活動前，請務必匯入所有打算在廣告活動中使用的素材資源。您隨時可以回來新增素材資源，但必須先有素材資源才能開始。

規劃最高成效廣告活動時，請參閱最高成效廣告活動的素材資源和素材資源規定。

由於文字素材資源和圖片素材資源是主要的必要素材資源類型，因此本指南將說明如何上傳這兩種素材資源。這些原則也適用於其他素材資源類型。無論您要製作哪種類型的素材資源，請使用 AssetOperation 建立素材資源。

您可以使用 AdsApp 建立資產，而無須使用 mutate，但為了保持一致性，本指南會以與其他所有作業相同的方式進行。請注意，如果您已擁有一些素材資源，可以且應重複使用現有素材資源。因此，雖然您必須具備素材資源才能建立最高成效廣告活動，但不一定需要在廣告活動建立程序中建立素材資源。

文字素材資源

文字資產的運作方式與其他操作相同。如果您在廣告活動建立程序中上傳素材資源，請使用臨時 ID。否則，請記下所傳回的資源名稱，以便日後需要參照素材資源並將其新增至素材資源群組時使用。

const textAsset = {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "textAsset": {
        "text": "Travel the World"
      }
    }
  }
}
operations.push(textAsset);

圖片素材資源

圖片素材資源會以 base-64 編碼格式上傳。由於您無法直接將圖片上傳至 Google Ads 指令碼，因此可以選擇兩種方法來取得圖片資料，並對其進行編碼以便上傳。

如要從 Google 雲端硬碟擷取圖片，您必須先取得圖片的ID，這是唯一可識別圖片的最佳方法。取得 ID 的方法之一，是從 Google 雲端硬碟 UI 複製可分享的連結，然後擷取 ID。您也可以透過程式設計擷取一系列檔案，然後選取要上傳的檔案。以下程式碼示範如何上傳已知 ID 的單一圖片：

const file = DriveApp.getFileById(fileId);
const imageAsset =  {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "name": "Marketing Logo",
      "type": "IMAGE",
      "imageAsset": {
        "data": Utilities.base64Encode(file.getBlob().getBytes())
      }
    }
  }
}

或者，您也可以使用 UrlFetchApp 擷取網路伺服器上代管的圖片：

const file = UrlFetchApp.fetch(imageUrl);

接著，您可以對這個檔案呼叫 getBlob，就像使用雲端硬碟檔案一樣，因此作業建構作業與 Google 雲端硬碟檔案的步驟相同。