أرقام التعريف
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض معظم عناصر "إعلانات Google" الطريقة getId() التي تعرض المعرّف الخاص بها. على الرغم من أنّ أرقام التعريف ليست ضرورية في معظم الحالات، إلا أنّها قد تكون مفيدة
عندما
- التعامل مع التقارير
- توفّر المعرّفات طريقة جيدة لربط صف تقرير بعنصر "إعلانات Google" الفعلي.
- الحفاظ على عملية ربط مع مستودع بيانات خارجي
- قد تكون لديك معلومات مستندة إلى أرقام التعريف مخزَّنة في قاعدة البيانات الخاصة بك.
- هل تبحث عن تحسين الأداء قليلاً؟
يكون استرجاع البيانات باستخدام المعرّفات أسرع غالبًا من البدائل الأخرى. أصبح رمز جلب عنصر واحد أسهل أيضًا:
let campaigns = AdsApp.campaigns()
.withIds([678678])
.get();
// vs.
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]
]);
وينطبق البناء نفسه عند جلب الإعلانات.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-13 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-13 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Most Google Ads entities have a `getId()` method, which returns a unique identifier that can be useful for linking data, improving performance, and referencing external databases."],["When working with reports, IDs can connect report rows to specific Google Ads entities."],["Fetching entities by ID is often faster than using other methods like filtering by name."],["Campaign and ad group IDs are unique, while ad and keyword IDs are composite, requiring both the ad group ID and their individual ID for unique identification."],["The `selector.withIds()` method is used to fetch entities by ID, taking an array of numbers for campaigns and ad groups and an array of two-element arrays (ad group ID and entity ID) for ads and keywords."]]],[]]
