निर्माता

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 स्क्रिप्ट अपने ऑपरेशन एसिंक्रोनस तरीके से एक्ज़ीक्यूट करती है. इससे स्क्रिप्ट, आपके ऑपरेशन को बैच के तौर पर ग्रुप कर पाती हैं और बेहतर परफ़ॉर्म कर पाती हैं. हालांकि, ऑपरेशन के तरीकों को कॉल करने पर, जैसे 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");
}