أرقام التعريف

تعرض معظم عناصر "إعلانات Google" الطريقة getId() التي تعرض المعرّف الخاص بها. على الرغم من أنّ أرقام التعريف ليست ضرورية في معظم الحالات، إلا أنّها قد تكون مفيدة عندما

التعامل مع التقارير

توفّر المعرّفات طريقة جيدة لربط صف تقرير بعنصر "إعلانات Google" الفعلي.

الحفاظ على عملية ربط مع مخزن بيانات خارجي

قد تكون لديك معلومات مستندة إلى أرقام التعريف مخزَّنة في قاعدة البيانات الخاصة بك.

هل تبحث عن تحسين الأداء قليلاً؟

يكون استرجاع البيانات باستخدام المعرّفات أسرع غالبًا من البدائل الأخرى. أصبح رمز جلب عنصر واحد أسهل أيضًا:

let campaigns = AdsApp.campaigns()
   .withIds([678678])
   .get();
// versus
let campaigns = AdsApp.campaigns()
   .withCondition("Name='My Campaign'")
   .get();

التفرّد

تكون أرقام تعريف الحملات وأرقام تعريف المجموعات الإعلانية فريدة، أي أنّه لن تتشارك أي حملتَين أو مجموعتَين إعلانيتَين رقم التعريف نفسه. في المقابل، تحتوي الإعلانات والكلمات الرئيسية على معرّفات مركّبة: المعرّف الفريد للكلمة الرئيسية هو مزيج من رقم تعريف المجموعة الإعلانية ورقم تعريف الكلمة الرئيسية. وبالمثل، فإنّ المعرّف الفريد للإعلان هو مزيج من رقم تعريف المجموعة الإعلانية ورقم تعريف الإعلان. ويترتب على ذلك آثار في طريقة طلب selector.withIds().

بالنسبة إلى الحملات والمجموعات الإعلانية، تتوقّع السمة selector.withIds() مصفوفة من الأرقام:

let ids = [123123, 234234, 345345];
let campaignSelector = AdsApp.campaigns().withIds(ids);

بالنسبة إلى الإعلانات والكلمات الرئيسية، يحتاج selector.withIds() إلى مصفوفة من مصفوفات ذات عنصرين، العنصر الأول هو رقم تعريف المجموعة الإعلانية. يسترد المقتطف التالي ثلاث كلمات رئيسية من مجموعة إعلانية:

let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
    [adGroupId, 234234],
    [adGroupId, 345345],
    [adGroupId, 456456]
]);

وينطبق التركيب نفسه عند استرداد الإعلانات.

معرّفات مؤقتة

عند العمل باستخدام طلب تغيير يتضمّن عمليات متعدّدة، ستحتاج أحيانًا إلى استخدام معرّفات مؤقتة لربط الموارد ببعضها، لأنّ أسماء الموارد الكاملة لن تكون متاحة إلى أن تتلقّى استجابة واجهة برمجة التطبيقات. يجب أن تكون المعرّفات المؤقتة أرقامًا سالبة تبدأ بالرقم -1، ولا يمكن تكرارها في طلب التغيير نفسه. لاستخدام المعرّفات المؤقتة بشكل فعّال، عليك كتابة بعض الرموز البرمجية لضمان عدم إنشاء معرّفات مؤقتة مكرّرة:

let nextId = -1;

function getNextTempId() {
    const ret = nextId;
    nextId -= 1;
    return ret;
}

سيؤدي كل استدعاء متتالٍ للدالة getNextTempId إلى عرض رقم أقل من الرقم السابق بمقدار واحد. بما أنّ جميع المعرّفات المؤقتة يجب أن تكون سالبة، ابدأ بالرقم -1.

لا يتم تذكُّر المعرّفات المؤقتة في الوظائف أو طلبات التعديل. للإشارة إلى مورد تم إنشاؤه في طلب تغيير سابق، استخدِم اسم المورد الفعلي.