ผู้สร้าง

Builder เป็นวิธีมาตรฐานในการสร้างเอนทิตีในสคริปต์ Google Ads เครื่องมือสร้างช่วยให้คุณสร้างเอนทิตี Google Ads ได้ทั้งแบบซิงโครนัสและแบบอะซิงโครนัส นอกจากนี้ คุณยังตรวจสอบได้ว่าการดำเนินการสำเร็จหรือไม่ และดำเนินการที่เหมาะสมตามผลลัพธ์ของการดำเนินการ ข้อมูลโค้ดต่อไปนี้ แสดงวิธีสร้างคีย์เวิร์ดโดยใช้เครื่องมือสร้าง

// 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");
}