أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
أسماء الموارد المستخدَمة في Search Ads 360 Reporting API هي هرمية، وتعكس
تنظيم الكيانات ضمن "إعلانات شبكة البحث 360". إنّ جميع الموارد تقريبًا هي موارد فرعية
لمورد Customer
، ما يشير إلى أنّ كل طلب بيانات تقريبًا من واجهة برمجة التطبيقات يجب أن يستهدف
حسابًا معيّنًا على "إعلانات شبكة البحث 360". على سبيل المثال، الحملات والمجموعات الإعلانية والإعلانات والكلمات الرئيسية
كلها موارد فرعية لمورد العميل الجذر.
تتم الإشارة إلى كيانات Search Ads 360 Reporting API (العملاء والحملات وما إلى ذلك) من خلال أسمائهم
الموارد في جميع أنحاء واجهة برمجة التطبيقات. ومع ذلك، من المهمّ ملاحظة أنّ أسماء موارد
قد تحتوي على معرّفات موارد رقمية فريدة تُحدِّد
كل عنصر في التدرّج الهرمي. في هذه الحالات، قد يكون من المفيد تحليل اسم
المورد لاستخراج معرّفات الموارد هذه وتجميع معرّف جديد.
على سبيل المثال، راجِع اسم المورد AdGroupAd من الجدول السابق:
ويمكن تقسيم ذلك إلى أرقام تعريف الموارد الفردية (المفصولة بعلامات
أرقام تعريف المجموعة)
على النحو التالي:
مكونات اسم المورد
معرّفات الموارد
رقم تعريف العميل:
"1234567890"
رقم تعريف المجموعة الإعلانية:
"54321098765"
رقم تعريف الإعلان للمجموعة الإعلانية:
"2109876543210"
معرّفات المجموعات
"customers"
"adGroupAds"
يتيح لك تحليل الأرقام التعريفية الفردية اشتقاق أسماء موارد جديدة للإشارة إلى العميل (customers/1234567890) أو المجموعة الإعلانية (customers/1234567890/adGroupAds/54321098765) التي يعرض لها إعلان المجموعة الإعلانية.
تاريخ التعديل الأخير: 2025-03-03 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-03-03 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Search Ads 360 Reporting API resource names are hierarchical, starting with the customer and followed by sub-resources like campaigns, ad groups, and ads."],["Resource names use relative paths and contain numerical resource IDs for each entity in the hierarchy."],["You can parse resource names to extract individual resource IDs and construct new resource names for related entities."],["In JSON request and response bodies, resource names are identified by the `resourceName` field, not the `name` field."]]],["The Search Ads 360 Reporting API uses a hierarchical structure for resource names, with most resources being sub-resources of the `Customer`. Each resource has a unique numerical ID within its resource name. Resource names are relative and can be parsed to extract these IDs. These IDs allow for the derivation of new resource names, referencing parent entities, like the customer or ad group. The `resourceName` field, not `name`, is used in JSON bodies.\n"]]
