Конструкторы — это стандартный способ создания сущностей в скриптах Google Рекламы. Конструкторы позволяют создавать сущности Google Рекламы как синхронно, так и асинхронно. Вы также можете проверить, была ли операция успешной, и предпринять соответствующие действия в зависимости от её результата. В следующем фрагменте кода показано, как создать ключевое слово с помощью конструктора.
// Retrieve your ad group.
let adGroup = AdsApp.adGroups().get().next();
// Create a keyword operation.
let keywordOperation = adGroup.newKeywordBuilder()
.withCpc(1.2)
.withText("shoes")
.withFinalUrl("http://www.example.com/shoes")
.build();
// Optional: examine the outcome. The call to isSuccessful()
// will block until the operation completes.
if (keywordOperation.isSuccessful()) {
// Get the result.
let keyword = keywordOperation.getResult();
} else {
// Handle the errors.
let errors = keywordOperation.getErrors();
}
Любая сущность, которая может быть создана с использованием скриптов Google Ads, создается с использованием этого шаблона конструктора.
Соображения производительности
По умолчанию скрипты Google Ads выполняют свои операции асинхронно. Это позволяет скриптам группировать операции в пакеты и достигать высокой производительности. Однако вызов методов Operation , таких как isSuccessful()
и getResult()
заставляет скрипты Google Ads очищать список ожидающих операций, что может привести к снижению производительности. Вместо этого создайте массив для хранения операций, а затем пройдитесь по нему для получения результатов.
Плохая производительность | Хорошая производительность |
---|---|
for (let i = 0; i < keywords.length; i++) let keywordOperation = adGroup .newKeywordBuilder() .withText(keywords[i]) .build(); // Bad: retrieving the result in the same // loop that creates the operation // leads to poor performance. let newKeyword = keywordOperation.getResult(); newKeyword.applyLabel("New keywords”); } | // Create an array to hold the operations let operations = []; for (let i = 0; i < keywords.length; i++) { let keywordOperation = adGroup .newKeywordBuilder() .withText(keywords[i]) .build(); operations.push(keywordOperation); } // Process the operations separately. Allows // Google Ads scripts to group operations into // batches. for (let i = 0; i < operations.length; i++) { let newKeyword = operations[i].getResult(); newKeyword.applyLabel("New keywords”); } |