الجهات المنشئة

إنّ "الأدوات الإبداعية" هي الطريقة العادية لإنشاء كيانات في نصوص "إعلانات 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" البرمجية يتمّ إنشاؤه باستخدام نمط الإنشاء هذا.

اعتبارات الأداء

تنفِّذ نصوص "إعلانات Google" البرمجية عملياتها بشكل غير متزامن تلقائيًا. يتيح ذلك للنصوص البرمجية تجميع عملياتك في مجموعات، وتحقيق أداءٍ عالٍ. ومع ذلك، فإنّ استدعاء طرق العملية مثل isSuccessful() و getResult() يفرض على نصوص "إعلانات Google" البرمجية إزالة قائمة العمليات المعلّقة، ما قد يؤدي بالتالي إلى أداء ضعيف. بدلاً من ذلك، يمكنك إنشاء صفيف لتخزين العمليات، ثم تكرار المرور عبر هذا الصفيف لاسترداد النتائج.

أداء ضعيف أداء جيد 
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”);
}