البدء

اتّبِع الخطوات التالية لبدء النص البرمجي الأول.

  1. سجِّل الدخول إلى حسابك على "إعلانات Google".
  2. انقر على رمز الأدوات مربع رمادي مع مفتاح
مفتاح أبيض واختَر النصوص البرمجية ضمن الإجراءات المجمّعة.
  3. اضغط على الرمز + دائرة زرقاء مع علامة
جمع بيضاء لإضافة نص.
  4. انسخ الرمز التالي والصقه في منطقة المحرِّر، داخل الدالة الرئيسية:

    function main() {
       let keywords = AdsApp.keywords()
             .orderBy("metrics.impressions DESC")
             .forDateRange("YESTERDAY")
             .withLimit(10)
             .get();
    
       console.log("The 10 keywords with the most impressions yesterday:");
       for (const keyword of keywords) {
           console.log(`${keyword.getText()}: ${keyword.getStatsFor("YESTERDAY")
                                                       .getImpressions()}`);
         }
    }
    
  5. انقر على تفويض عندما يُطلب منك ذلك، حتى يتمكن النص البرمجي من الوصول إلى الحساب نيابةً عنك. يجب تنفيذ هذا الإجراء مرة واحدة لكل نص برمجي.

  6. انقر على معاينة لتشغيل النص البرمجي في وضع المعاينة. ستظهر النتائج في لوحة التغييرات / السجلّات.

الحسابات الإدارية

يجب أن يكون لديك أولاً حساب إداري على "إعلانات Google" لتشغيل النصوص البرمجية في "مدير إعلانات Google".

  1. سجّل الدخول إلى حسابك الإداري على "إعلانات Google".
  2. انقر على رمز الأدوات علبة رمادية مع مفك براغي
أبيض و اختَر النصوص البرمجية ضمن الإجراءات المجمّعة.
  3. اضغط على رمز علامة الجمع دائرة زرقاء مع علامة
جمع بيضاء لإضافة نص برمجي.
  4. انسخ الرمز التالي والصقه في منطقة المحرِّر، داخل الدالة الرئيسية:

    function main() {
      // Retrieve all children accounts.
        const accountIterator = AdsManagerApp.accounts().get();
    
      // Iterate through the account list.
      for (const account of accountIterator) {
        // Get stats for the child account.
        const stats = account.getStatsFor("THIS_MONTH");
        // And log it.
        console.log(`${account.getCustomerId()},${stats.getClicks()},` +
          `${stats.getImpressions()},${stats.getCost()}`);
      }
    }
    
  5. انقر على تفويض عندما يُطلب منك ذلك، حتى يتمكن النص البرمجي من الوصول إلى الحساب نيابةً عنك. يجب تنفيذ هذا الإجراء مرة واحدة لكل نص برمجي.

  6. انقر على معاينة لتشغيل النص البرمجي في وضع المعاينة. ستظهر النتائج في لوحة التغييرات / السجلّات.

لمزيد من نماذج مقتطفات النصوص البرمجية، يمكنك الاطّلاع على صفحة الأمثلة.