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

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

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