البدء

حسابات "إعلانات 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" لتشغيل نصوص "إدارة الإعلانات" البرمجية.

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. للحصول على عرض تفصيلي للتغييرات والسجلات، انقر على الرابط في عمود التغييرات الذي يتوافق مع النص البرمجي الذي نفّذته للتو. من المفترض أن ترى نفس مخرجات السجل التي تمت معاينتها من قبل.