大量上傳

您可以藉助 Google Ads 指令碼，上傳 CSV 格式的資料，對帳戶進行大量變更。您可以從 Google 雲端硬碟、Google 試算表、Microsoft Excel 試算表上傳 CSV 檔案中的資料，或在執行階段的指令碼中建構大量上傳要求。本指南說明如何在指令碼中使用這項功能。

用量

透過大量上傳，您可以進行某些變更，這些變更通常無法直接透過 Google Ads 指令碼支援，例如管理廣告活動或上傳離線轉換。

從 Google 雲端硬碟建立大量上傳作業

如要使用大量上傳功能，最簡單的方法是在 Google 雲端硬碟中上傳 CSV 檔案，然後使用 Google Ads 指令碼將該檔案上傳至 Google Ads：

const file = DriveApp.getFilesByName("BulkCampaignUpload.csv")
    .next();
const upload = AdsApp.bulkUploads().newFileUpload(file);
upload.forCampaignManagement();
upload.preview();

這會在帳戶中建立大量上傳預覽項目，位置在「工具與設定」>「大量動作」>「上傳」。

按一下「預覽」連結即可查看變更。

如要將變更套用至帳戶，請按一下詳細資料頁面上的「套用變更」按鈕。如果上傳的檔案有錯誤，或您不想進行變更，請按一下「捨棄預覽」按鈕來捨棄變更。

確認指令碼運作正常後，即可略過預覽階段，直接從指令碼套用變更。如要執行這項操作，請呼叫大量上傳執行個體的 apply() 方法，而非 preview() 方法。

從頭建立大量上傳

您可以從頭開始建立大量上傳工作，步驟如下：

// The best way to find column names is to consult a template
// as described in the last section of this guide.
const columns = [
   "Campaign", "Budget", "Bid Strategy type", "Campaign type"
];

const upload = AdsApp.bulkUploads().newCsvUpload(columns);

// Call append once for each row you'd like to upload
upload.append({
   "Campaign": "Test Campaign 1",
   "Budget": 2.34,
   "Bid Strategy type": "cpc",
   "Campaign type": "Search Only"
});
upload.forCampaignManagement();
upload.preview();

設定貨幣單位

根據預設，大量上傳中的金額會解讀為實際貨幣金額。如要使用微歐元，請在建立上傳工作時，將 moneyInMicros 選項設為 true (例如，€2.34 應輸入為 2340000)。

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {moneyInMicros: true});

設定檔案語言代碼

根據預設，系統會以美式英文語言代碼 (en_US) 解讀 CSV 檔案內容。 您可以使用 fileLocale 選項指定其他語言代碼：

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {fileLocale: "fr_FR"});

指定語言代碼後，您可以在 en_US 語言代碼中提供欄標題，也可以在 fileLocale 屬性中指定語言代碼。

設定時區

根據預設，系統會以「America/Los_Angeles」時區解讀檔案中的時間項目。您可以使用 timeZone 選項指定其他時區。以 TZ 資料庫格式指定時區。

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {timeZone: "America/New_York"});

上傳離線轉換資料時，設定時區會很有幫助。

大量上傳的試算表範本

如要取得大量上傳的試算表範本，最簡單的方法是透過 Google Ads 使用者介面。

  • 登入 Google Ads 帳戶。
  • 依序前往「工具與設定」>「大量操作」>「上傳」。
  • 按一下「+」按鈕，開始上傳新檔案。
  • 接著會顯示各種範本供您選擇。

您也可以從說明中心下載許多不同範本。