البدء

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

حسابات "إعلانات Google"

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

5. انسخ الرمز التالي والصقه في مساحة المحرّر، مع استبدال الدالة الرئيسية:

   function main() {
     // Get the campaign names from all the campaigns
     const rows = AdsApp.search('SELECT campaign.name FROM campaign');
   
     console.log('My campaigns:');
     // Iterate through the campaigns and print the campaign names
     for (const row of rows) {
       console.log(row.campaign.name);
     }
   }
   

6. عندما يُطلب منك ذلك، انقر على منح الإذن ليتمكّن النص البرمجي من الوصول إلى الحساب نيابةً عنك. يجب إجراء ذلك مرة واحدة لكل نص برمجي.

7. انقر على معاينة لتشغيل النص البرمجي في وضع المعاينة. ستظهر النتائج في لوحة التغييرات / السجلات. في هذا المثال، من المفترض أن تظهر أسماء حملاتك في السجلات.

8. عندما تكون راضيًا عن نتائج المعاينة، انقر على تنفيذ لتنفيذ النص البرمجي وفتح صفحة سجلّ النصوص البرمجية. تعرض هذه الصفحة النصوص البرمجية التي تم تنفيذها مؤخرًا، مع معلومات عن حالتها ونتائجها.

9. للحصول على عرض تفصيلي للتغييرات والسجلات، انقر على الرابط في عمود التغييرات الذي يتوافق مع النص البرمجي الذي نفّذته للتو. من المفترض أن تظهر لك نتيجة السجلّ نفسها التي تمت معاينتها من قبل.

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

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

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

5. انسخ الرمز التالي والصقه في مساحة المحرّر، مع استبدال الدالة الرئيسية:

   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()}`);
     }
   }
   

6. عندما يُطلب منك ذلك، انقر على منح الإذن ليتمكّن النص البرمجي من الوصول إلى الحساب نيابةً عنك. يجب إجراء ذلك مرة واحدة لكل نص برمجي.

7. انقر على معاينة لتشغيل النص البرمجي في وضع المعاينة. ستظهر النتائج في لوحة التغييرات / السجلات. في هذا المثال، من المفترض أن تظهر لك حسابات الأطفال ومقاييسهم في السجلات.

8. عندما تكون راضيًا عن نتائج المعاينة، انقر على تنفيذ لتنفيذ النص البرمجي وفتح صفحة سجلّ النصوص البرمجية. تعرض هذه الصفحة النصوص البرمجية التي تم تنفيذها مؤخرًا، مع معلومات عن حالتها ونتائجها.

9. للحصول على عرض تفصيلي للتغييرات والسجلات، انقر على الرابط في عمود التغييرات الذي يتوافق مع النص البرمجي الذي نفّذته للتو. من المفترض أن تظهر لك نتيجة السجلّ نفسها التي تمت معاينتها من قبل.

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