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