共用方式為


在預覽模式中執行腳本

預覽模式可讓您測試腳本,而不需要實際變更資料。 相反地,您會看到結果,就像腳本已執行一樣。 這可以減少設定測試案例所花費的時間。 當您滿意腳本的輸出時,可以執行腳本,或排程稍後執行。

若要以程式設計方式判斷腳本是否正在預覽模式中執行,請參閱 isPreviewExecutionInfo的 方法。

因為未在預覽模式中建立、刪除或修改物件,所以並非所有程式碼都會執行與即時執行相同的程式碼。 下列程式碼顯示當程式碼在預覽模式與即時模式中的行為不同時的簡單範例。

/function main() {

    // Get an ad group that does not have keywords.
    var adGroup = AdsApp.adGroups()
        .withIds(["123456789"])
        .get()
        .next();

    // Add a keyword to the ad group
    var operation = adGroup.newKeywordBuilder()
        .withText('mykeyword')
        .build();

    // In preview mode, the keyword is not created, so getId() returns -1.
    if (operation.isSuccessful()) {
        var keyword = operation.getResult();
        Logger.log(`added keyword, ${keyword.getText()} (${keyword.getId()})`);
    }
    else {
        for (var error in operation.getErrors()) {
            Logger.log(`Error adding keyword, ${error}.`);
        }
    }

    // Get the ad group's keywords. In preview mode, the
    // keyword is not created, so no keywords are logged.
    var keywords = AdsApp.keywords()
        .withCondition(`AdGroupName CONTAINS '${adGroup.getName()}'`)
        .get();

    while (keywords.hasNext()) {
        var keyword = keywords.next();
        Logger.log(`added keyword, ${keyword.getText()} (${keyword.getId()})`);
    }
}

後續步驟