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

تعرض معظم كيانات "إعلانات 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.

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